Error Handling

Display Error messages. More...

Functions
int	answer_yn (char *em0, char *em1, char *em2, char *em3)
	Accept a single letter answer.
int	display_error (char *em0, char *em1, char *em2, char *em3)
	Display an error message window or print to stderr.
int	Perror (char *emsg_str)
	Display a simple error message window or print to stderr.
Chyron *	wait_mk_chyron ()
	Create a Chyron struct for the waiting message.
WINDOW *	wait_mk_win (Chyron *chyron, char *title)
	Display a popup waiting message.
bool	wait_destroy (Chyron *chyron)
	Destroy the waiting message window and chyron.
int	wait_continue (WINDOW *wait_win, Chyron *chyron, int remaining)
	Update the waiting message with remaining time and check for user input.
int	nf_error (int ec, char *s)
	Display error message and wait for key press.
void	abend (int ec, char *s)
	Abnormal program termination.

Detailed Description

Display Error messages.

Function Documentation

abend()

void abend	(	int	ec,
		char *	s )

Abnormal program termination.

Parameters

ec	Exit code
s	Error message

Definition at line 1331 of file dwin.c.

                            {
    destroy_curses();
    restore_shell_tioctl();
    sig_dfl_mode();
    fprintf(stderr, "\n\nABEND: %s (code: %d)\n", s, ec);
    exit(EXIT_FAILURE);
}

References destroy_curses(), restore_shell_tioctl(), and sig_dfl_mode().

Referenced by answer_yn(), display_error(), form_parse_desc(), init_menu_files(), init_pick(), init_view_full_screen(), mapp_initialization(), menu_cmd_processor(), new_chyron(), new_form(), new_init(), new_menu(), new_pick(), new_view(), open_curses(), parse_menu_description(), Perror(), sig_prog_mode(), signal_handler(), view_init_input(), and wait_mk_win().

Here is the call graph for this function:

Here is the caller graph for this function:

answer_yn()

int answer_yn	(	char *	em0,
		char *	em1,
		char *	em2,
		char *	em3 )

Accept a single letter answer.

Parameters

em0	First error message line
em1	Second error message line
em2	Third error message line
em3	Fourth error message line

Returns

Key code of user command

Definition at line 994 of file dwin.c.

                                                          {
    char title[MAXLEN];
    int line, pos, em_l, em0_l, em1_l, em2_l, em3_l;
    WINDOW *error_win;
 
    if (!f_curses_open) {
        fprintf(stderr, "\n\n%s\n%s\n%s\n%s\n\n", em0, em1, em2, em3);
        return (1);
    }
 
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 1, "F1 Help", KEY_F(1));
    set_chyron_key(chyron, 2, "N - No", 'n');
    set_chyron_key(chyron, 3, "Y - Yes", 'y');
    compile_chyron(chyron);
 
    em0_l = strnz(em0, COLS - 4);
    em1_l = strnz(em1, COLS - 4);
    em2_l = strnz(em2, COLS - 4);
    em3_l = strnz(em1, COLS - 4);
    em_l = max(em0_l, em1_l);
    em_l = max(em_l, em2_l);
    em_l = max(em_l, em3_l);
    em_l = max(em_l, chyron->l);
    em_l = min(em_l, COLS - 4);
 
    pos = ((COLS - em_l) - 4) / 2;
    line = (LINES - 6) / 2;
    strnz__cpy(title, "Notification", MAXLEN - 1);
    if (win_new(5, em_l + 2, line, pos, title, 0)) {
        ssnprintf(title, MAXLEN - 1, "win_new(%d, %d, %d, %d, %s, %b) failed",
                  5, em_l + 2, line, pos, title, 0);
        destroy_chyron(chyron);
        abend(-1, title);
    }
    error_win = win_win[win_ptr];
    mvwaddstr(error_win, 0, 1, em0);
    mvwaddstr(error_win, 1, 1, em1);
    mvwaddstr(error_win, 2, 1, em2);
    mvwaddstr(error_win, 3, 1, em3);
    display_chyron(error_win, chyron, 4, chyron->l + 1);
    do {
        curs_set(1);
        cmd_key = xwgetch(error_win, chyron, -1);
        curs_set(0);
        if (cmd_key == KEY_F(1) || cmd_key == 'N' || cmd_key == 'n' ||
            cmd_key == 'Y' || cmd_key == 'y')
            break;
    } while (1);
    win_del();
    destroy_chyron(chyron);
    return (cmd_key);
}

References abend(), cmd_key, compile_chyron(), destroy_chyron(), display_chyron(), f_curses_open, Chyron::l, new_chyron(), set_chyron_key(), ssnprintf(), strnz(), strnz__cpy(), win_del(), win_new(), win_ptr, win_win, and xwgetch().

Referenced by write_view_buffer().

Here is the call graph for this function:

Here is the caller graph for this function:

display_error()

int display_error	(	char *	em0,
		char *	em1,
		char *	em2,
		char *	em3 )

Display an error message window or print to stderr.

Parameters

em0	First error message line
em1	Second error message line
em2	Third error message line
em3	Fourth error message line

Returns

Key code of user command

Definition at line 1054 of file dwin.c.

                                                              {
    char title[MAXLEN];
    int line, pos, em_l, em0_l, em1_l, em2_l, em3_l;
    WINDOW *error_win;
 
    if (!f_curses_open) {
        fprintf(stderr, "\n\n%s\n%s\n%s\n%s\n\n", em0, em1, em2, em3);
        return (1);
    }
 
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 1, "F1 Help", KEY_F(1));
    set_chyron_key(chyron, 9, "F9 Cancel", KEY_F(9));
    set_chyron_key(chyron, 10, "F10 Continue", KEY_F(10));
    compile_chyron(chyron);
 
    em0_l = strnz(em0, COLS - 4);
    em1_l = strnz(em1, COLS - 4);
    em2_l = strnz(em2, COLS - 4);
    em3_l = strnz(em1, COLS - 4);
    em_l = max(em0_l, em1_l);
    em_l = max(em_l, em2_l);
    em_l = max(em_l, em3_l);
    em_l = max(em_l, chyron->l);
    em_l = min(em_l, COLS - 4);
 
    pos = ((COLS - em_l) - 4) / 2;
    line = (LINES - 6) / 2;
    strnz__cpy(title, "Notification", MAXLEN - 1);
    if (win_new(5, em_l + 2, line, pos, title, 0)) {
        ssnprintf(title, MAXLEN - 1, "win_new(%d, %d, %d, %d, %s, %b) failed",
                  5, em_l + 2, line, pos, title, 0);
        destroy_chyron(chyron);
        abend(-1, title);
    }
    error_win = win_win[win_ptr];
    mvwaddstr(error_win, 0, 1, em0);
    mvwaddstr(error_win, 1, 1, em1);
    mvwaddstr(error_win, 2, 1, em2);
    mvwaddstr(error_win, 3, 1, em3);
    display_chyron(error_win, chyron, 4, chyron->l + 1);
    do {
        cmd_key = xwgetch(error_win, chyron, -1);
        if (cmd_key == KEY_F(9) || cmd_key == KEY_F(10) || cmd_key == 'q' ||
            cmd_key == 'Q')
            break;
    } while (1);
    win_del();
    destroy_chyron(chyron);
    return (cmd_key);
}

References abend(), cmd_key, compile_chyron(), destroy_chyron(), display_chyron(), f_curses_open, Chyron::l, new_chyron(), set_chyron_key(), ssnprintf(), strnz(), strnz__cpy(), win_del(), win_new(), win_ptr, win_win, and xwgetch().

Referenced by enter_file_spec(), form_desc_error(), form_parse_desc(), form_process(), form_read_data(), form_write(), get_clr_pair(), init_view_boxwin(), init_view_full_screen(), lf_find(), mk_dir(), new_init(), new_pick(), new_view(), parse_menu_description(), popup_ckeys(), verify_dir(), verify_file(), view_cmd_processor(), view_init_input(), write_view_buffer(), and xwgetch().

Here is the call graph for this function:

Here is the caller graph for this function:

nf_error()

int nf_error	(	int	ec,
		char *	s )

Display error message and wait for key press.

Parameters

ec	Error code
s	Error message

Definition at line 1320 of file dwin.c.

                              {
    fprintf(stderr, "ERROR: %s code: %d\n", s, ec);
    fprintf(stderr, "Press a key to continue");
    di_getch();
    fprintf(stderr, "\n");
    return ec;
}

References di_getch().

Here is the call graph for this function:

Perror()

int Perror

(

char *

emsg_str

)

Display a simple error message window or print to stderr.

Parameters

emsg_str

Error message string

Returns

Key code of user command

Definition at line 1110 of file dwin.c.

                           {
    char emsg[80];
    int emsg_max_len = 80;
    unsigned cmd_key;
    WINDOW *error_win;
    int len, line, pos;
    char title[MAXLEN];
    bool f_xwgetch = true;
    if (emsg_str[0] == '␛' && emsg_str[1] == 'w') {
        emsg_str += 2;
        f_xwgetch = false;
    }
    strnz__cpy(emsg, emsg_str, emsg_max_len - 1);
    if (!f_curses_open) {
        fprintf(stderr, "\n%s\n", emsg);
        return (1);
    }
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 1, "F1 Help", KEY_F(1));
    set_chyron_key(chyron, 9, "F9 Cancel", KEY_F(9));
    set_chyron_key(chyron, 10, "F10 Continue", KEY_F(10));
    compile_chyron(chyron);
    len = max(strlen(title), strlen(emsg));
    len = max(len, chyron->l);
    len = max(len, 40);
    pos = (COLS - len - 4) / 2;
    line = (LINES - 4) / 2;
    strnz__cpy(title, "Notification", MAXLEN - 1);
    if (win_new(2, len + 2, line, pos, title, 0)) {
        ssnprintf(title, MAXLEN - 1, "win_new(%d, %d, %d, %d, %s, %b) failed",
                  4, line, line, pos, title, 0);
        destroy_chyron(chyron);
        abend(-1, title);
    }
    error_win = win_win[win_ptr];
    mvwaddstr(error_win, 0, 1, emsg);
    display_chyron(error_win, chyron, 1, chyron->l + 1);
    if (f_xwgetch) {
        curs_set(1);
        cmd_key = xwgetch(error_win, chyron, -1);
        curs_set(0);
        win_del();
    } else {
        cmd_key = KEY_F(10);
    }
    destroy_chyron(chyron);
    return (cmd_key);
}

References abend(), compile_chyron(), destroy_chyron(), display_chyron(), f_curses_open, Chyron::l, new_chyron(), set_chyron_key(), ssnprintf(), strnz__cpy(), win_del(), win_new(), win_ptr, win_win, and xwgetch().

Referenced by action_disposition(), exec_objects(), field_editor(), fork_exec(), form_display_screen(), form_engine(), form_fmt_field(), form_process(), form_validate_field(), go_to_mark(), go_to_percent(), increment_ln(), init_form(), init_pick(), initialize_line_table(), lf_process(), menu_engine(), new_init(), new_pick(), open_pick_win(), pad_refresh(), parse_menu_description(), popup_ckeys(), search(), view_cmd_processor(), view_init_input(), waitpid_with_timeout(), and write_config().

Here is the call graph for this function:

Here is the caller graph for this function:

wait_continue()

int wait_continue	(	WINDOW *	wait_win,
		Chyron *	chyron,
		int	remaining )

Update the waiting message with remaining time and check for user input.

Parameters

chyron	Pointer to Chyron struct for displaying key options
wait_win	Pointer to the waiting message window
remaining	Time remaining for the wait in seconds

Returns

true if the wait should continue, false if it should be cancelled

Definition at line 1215 of file dwin.c.

                                                                   {
    char time_str[10];
    ssnprintf(time_str, 9, "%-4d", remaining);
    mvwaddstr(wait_win, 0, 21, time_str);
    display_chyron(wait_win, chyron, 1, 0);
    wmove(wait_win, 1, chyron->l);
    cmd_key = xwgetch(wait_win, chyron, 1);
    return cmd_key;
}

References cmd_key, display_chyron(), Chyron::l, ssnprintf(), and xwgetch().

Referenced by init_pick(), view_init_input(), and waitpid_with_timeout().

Here is the call graph for this function:

Here is the caller graph for this function:

wait_destroy()

bool wait_destroy

(

Chyron *

chyron

)

Destroy the waiting message window and chyron.

Parameters

chyron

Pointer to Chyron struct for displaying key options

Returns

true if successful

Definition at line 1203 of file dwin.c.

                                  {
    win_del();
    destroy_chyron(chyron);
    return true;
}

References destroy_chyron(), and win_del().

Referenced by init_pick(), view_init_input(), and waitpid_with_timeout().

Here is the call graph for this function:

Here is the caller graph for this function:

wait_mk_chyron()

Chyron * wait_mk_chyron

(

)

Create a Chyron struct for the waiting message.

Returns

Pointer to the chyron struct

Definition at line 1161 of file dwin.c.

                         {
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 9, "F9 Cancel", KEY_F(9));
    compile_chyron(chyron);
    return chyron;
}

References compile_chyron(), new_chyron(), and set_chyron_key().

Referenced by init_pick(), view_init_input(), and waitpid_with_timeout().

Here is the call graph for this function:

Here is the caller graph for this function:

wait_mk_win()

WINDOW * wait_mk_win	(	Chyron *	chyron,
		char *	title )

Display a popup waiting message.

Parameters

chyron	Pointer to Chyron struct for displaying key options
title	window title

Returns

WINDOW * struct

Definition at line 1172 of file dwin.c.

                                                 {
    char wm1[] = "Seconds remaining:";
    int len;
    int line, col;
    WINDOW *wait_win;
 
    if (!f_curses_open) {
        fprintf(stderr, "\n%s\n", title);
        fprintf(stderr, "%s\n", wm1);
        return NULL;
    }
    len = max(strlen(title), strlen(wm1));
    len = max(len, chyron->l);
    len = max(len, 40);
    col = (COLS - len - 4) / 2;
    line = (LINES - 4) / 2;
    if (win_new(2, len + 2, line, col, title, 0)) {
        ssnprintf(title, MAXLEN - 1, "win_new(%d, %d, %d, %d, %s, %b) failed",
                  4, line, line, col, title, 0);
        abend(-1, title);
    }
    wait_win = win_win[win_ptr];
    mvwaddstr(wait_win, 0, 1, wm1);
    display_chyron(wait_win, chyron, 1, 0);
    wmove(wait_win, 1, chyron->l);
    return wait_win;
}

References abend(), display_chyron(), f_curses_open, Chyron::l, ssnprintf(), win_new(), win_ptr, and win_win.

Referenced by init_pick(), view_init_input(), and waitpid_with_timeout().

Here is the call graph for this function:

Here is the caller graph for this function: