view_engine.c File Reference

The working part of View. More...

#include <common.h>
#include <errno.h>
#include <fcntl.h>
#include <iso646.h>
#include <regex.h>
#include <stdbool.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/mman.h>
#include <sys/param.h>
#include <sys/stat.h>
#include <termios.h>
#include <time.h>
#include <unistd.h>

Include dependency graph for view_engine.c:

Go to the source code of this file.

Macros
#define	_Refresh(view)
#define	_ui_perror(msg)
#define	confirm()
#define	get_next_char()
	read the next characater from the virtual file
#define	get_prev_char()
	read the previous characater from the virtual fileThere is no need to track line numbers when moving backwards as they are stored in the line table and accessed as needed. When reading in reverse, the Beginning of Data (BOD) flag is set when the file position is zero, and cleared when the position or reading direction changes. Carriage-returns are ignored as they should be.

Functions
int	a_toi (char *, bool *)
	a safer alternative to atoi() for converting ASCII strings to integers.
void	build_prompt (View *view)
	Build Prompt String.
void	cat_file (View *view)
	Concatenate File to Standard Output.
void	destroy_line_table (View *view)
	Destroy Line Table.
void	display_line (View *view)
	Display Line on Padparam View *view data structure.
void	display_line_eod (View *view)
	Display End of Data.
int	display_prompt (View *view, char *s)
	Display Command Line Prompt.
void	display_split_line (View *view)
	Display Split Line on Pad.
bool	enter_file_spec (Init *init, char *file_spec)
	use form to enter a file specification
int	fmt_line (View *view)
	Format Line for Display.
int	get_cmd_arg (View *view, char *prompt)
	Get Command Argument from User Input.
int	get_cmd_char (View *view, off_t *n)
	Get Command Character from User Input.
void	get_line (View *, off_t)
void	go_to_eof (View *view)
	Go to End of File.
int	go_to_line (View *view, off_t line_idx)
	Go to Specific Line.
void	go_to_mark (View *view, uint c)
	Go to Mark.
void	go_to_percent (View *view, uint percent)
	Go to Percent of File.
void	go_to_position (View *view, off_t pos)
	Go to Specific File Position.
void	increment_ln (View *view)
	Increment Line Index and Update Line Table.
void	initialize_line_table (View *view)
	Initialize Line Table.
off_t	line_number (View *view, off_t position)
	Get Line Number for a Given File Position.
void	log_cc_buf (View *view)
	Log Complex Character Buffer.
void	log_split_lines (View *view)
	Log Split Lines.
void	log_stripped_line_out (View *view)
	Log Stripped Line Output.
void	log_strnz (char *str, uint len)
	Log String with Specified Length.
void	lp (View *view, char *PrintFile)
	Send File to Print Queue.
int	pad_refresh (View *view)
	Refresh Pad and Line Number Window.
void	page_next (View *view)
	Advance to Next Page.
void	page_prev (View *view)
	display previous page
void	parse_ansi_str (char *ansi_str, attr_t *attrs, ushort *cpx)
	Parse ANSI SGR Escape Sequence.
void	scroll_next (View *view, uint n)
	Scroll Down by n Lines.
void	scroll_prev (View *view, uint n)
	Move the view scope n lines toward the beginning of the file.
bool	search (View *view, int search_cmd, char *regex_pattern)
	Search for Regular Expression Pattern.
void	sync_ln (View *view, off_t ln_no)
	Synchronize Line Table with Current File Position.
void	sync_pos (View *, off_t pos)
int	view_cmd_processor (Init *init)
	Main Command Processing Loop for View.
void	view_display_help (Init *init)
	Display View Help File.
void	view_display_page (View *view)
	Display Current Page.
int	view_file (Init *init)
	Start view.
int	write_view_buffer (Init *init, bool f_strip_ansi)
	Write buffer contents to files.

Variables
FILE *	dbgfp
char	err_msg [MAXLEN]
char	prev_regex_pattern [MAXLEN]

Detailed Description

The working part of View.

Author

Bill Waller Copyright (c) 2025 MIT License billx.nosp@m.wall.nosp@m.er@gm.nosp@m.ail..nosp@m.com

Date

2026-02-09

Definition in file view_engine.c.

Macro Definition Documentation

_Refresh

#define _Refresh

(

view

)

Value:

{                      \
    pad_refresh(view); \
}

Definition at line 103 of file view_engine.c.

#define _Refresh(view)     \
    {                      \
        pad_refresh(view); \
    }

_ui_perror

#define _ui_perror

(

msg

)

Value:

{                                                                          \
    ssnprintf(em0, MAXLEN - 1, _("%s, line: %d"), __FILE__, __LINE__ - 2); \
    strnz__cpy(em1, msg, MAXLEN - 1);                                      \
    ui_display_error(em0, em1, nullptr, nullptr);                          \
}

Definition at line 96 of file view_engine.c.

#define _ui_perror(msg)                                                        \
    {                                                                          \
        ssnprintf(em0, MAXLEN - 1, _("%s, line: %d"), __FILE__, __LINE__ - 2); \
        strnz__cpy(em1, msg, MAXLEN - 1);                                      \
        ui_display_error(em0, em1, nullptr, nullptr);                          \
    }

confirm

#define confirm

(

)

Value:

{                                                            \
    if ((c = get_cmd_char(view, &n_cmd)) == 'y' || c == 'Y') \
        ans = true;                                          \
    else if (c == 'n' || c == 'N')                           \
        ans = false;                                         \
}

Definition at line 88 of file view_engine.c.

#define confirm()                                                \
    {                                                            \
        if ((c = get_cmd_char(view, &n_cmd)) == 'y' || c == 'Y') \
            ans = true;                                          \
        else if (c == 'n' || c == 'N')                           \
            ans = false;                                         \
    }

Function Documentation

get_line()

void get_line	(	View *	view,
		off_t	line )

__get_line

Definition at line 1801 of file view_engine.c.

                                      {
    char c;
    char *line_in_p;
 
    view->ln_no = line;
    view->file_pos = view->ln_tbl[view->ln_no];
    view->f_eod = false;
    get_next_char();
    if (view->f_eod) {
        view->ln_no = line;
        view->ln_no_max = view->ln_no;
        return;
    }
    line_in_p = view->line_in_s;
    view->line_in_beg_p = view->line_in_s;
    view->line_in_end_p = view->line_in_s + PAD_COLS;
    while (1) {
        if (c == '\n' || c == '\0')
            break;
        if (line_in_p >= view->line_in_end_p)
            break;
        *line_in_p++ = c;
        get_next_char();
        if (view->f_eod) {
            view->ln_no = line;
            view->ln_no_max = view->ln_no;
            return;
        }
    }
    *line_in_p = '\0';
    if (view->f_squeeze) {
        while (1) {
            get_next_char();
            if (c != '\n' && c != '\0')
                break;
            if (view->f_eod) {
                view->ln_no = line;
                view->ln_no_max = view->ln_no;
                break;
            }
        }
        if (!view->f_eod) {
            get_prev_char();
            return;
        }
    }
 
    view->ln_no = line;
    return;
}

References View::f_eod, View::f_squeeze, View::file_pos, View::line_in_beg_p, View::line_in_end_p, View::line_in_s, View::ln_no, View::ln_no_max, and View::ln_tbl.

Referenced by page_prev(), scroll_next(), scroll_prev(), search(), view_display_page(), and write_view_buffer().

Here is the caller graph for this function:

sync_pos()

void sync_pos	(	View *	view,
		off_t	pos )

Definition at line 2038 of file view_engine.c.

                                     {
    int c = 0;
    // Advance view->ln_tbl[view->ln_no] to view->file_pos if necessary
    while (view->ln_tbl[view->ln_no] < pos) {
        if (view->ln_no >= view->ln_no_max) {
            get_next_char();
            if (view->f_eod)
                break;
        } else
            view->ln_no++;
    }
    while (view->ln_tbl[view->ln_no] > pos) {
        if (view->ln_no == 0)
            break;
        view->ln_no--;
    }
    view->file_pos = view->ln_tbl[view->ln_no];
}

References View::f_eod, View::file_pos, View::ln_no, View::ln_no_max, and View::ln_tbl.

Referenced by go_to_eof(), and go_to_position().

Here is the caller graph for this function:

Variable Documentation

dbgfp

FILE * dbgfp

Definition at line 109 of file view_engine.c.

err_msg

char err_msg[MAXLEN]

Definition at line 150 of file view_engine.c.

prev_regex_pattern

char prev_regex_pattern

Definition at line 108 of file view_engine.c.

Referenced by view_cmd_processor().