Error Handling

Display Error messages. More...

Functions
void	abend (int ec, char *s)
	Abnormal program termination.
bool	action_disposition (char *title, char *action_str)
	Display a simple action disposition message window or print to stderr.
int	answer_yn (char *msg0, char *msg1, char *msg2, char *msg3)
	Accept a single letter answer.
int	display_error (char *msg0, char *msg1, char *msg2, char *msg3)
	Display an error message window or print to stderr.
int	Perror (char *emsg_str)
	Display a simple error message window or print to stderr.

Detailed Description

Display Error messages.

Function Documentation

abend()

void abend	(	int	ec,
		char *	s )

Abnormal program termination.

abend

Parameters

ec	Exit code
s	Error message

Definition at line 1204 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(), mapp_initialization(), new_chyron(), new_form(), new_init(), new_menu(), new_pick(), new_view(), parse_menu_description(), Perror(), sig_prog_mode(), signal_handler(), and view_init_input().

Here is the call graph for this function:

Here is the caller graph for this function:

action_disposition()

bool action_disposition	(	char *	title,
		char *	action_str )

Display a simple action disposition message window or print to stderr.

action_disposition

Parameters

title	Window title
action_str	Action description string

Returns

true if successful

Definition at line 895 of file dwin.c.

                                                       {
    uint len;
    uint line, col;
 
    if (!f_curses_open) {
        fprintf(stderr, "\n%s\n", title);
        fprintf(stderr, "%s\n", action_str);
        return true;
    }
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 10, "F10 Continue", KEY_F10);
    compile_chyron(chyron);
    len = max(strlen(title), strlen(action_str));
    uint maxy, maxx;
    ui_get_screen_size(&maxy, &maxx);
    col = (maxx - len - 4) / 2;
    line = (maxy - 4) / 2;
    if (surface_box_win_new(2, len + 2, line, col, title)) {
        ssnprintf(em0, MAXLEN - 1, "surface_box_win_new(%d, %d, %d, %d, %s) failed", 4,
                  line, line, col, title);
        Perror(em0);
    }
    UiSurface *sfc = ui_surface[sfc_ptr];
    UiEvent event;
    ui_draw_text(sfc, WIN, 0, 1, action_str);
    display_chyron(sfc, WIN, chyron, 1, 0);
    event.y = event.x = -1;
    cmd_key = ui_get_event(sfc, WIN, &event, -1);
    cm_surface_destroy(sfc);
    destroy_chyron(chyron);
    return true;
}

References cm_surface_destroy(), cmd_key, compile_chyron(), destroy_chyron(), display_chyron(), em0, f_curses_open, new_chyron(), Perror(), set_chyron_key(), sfc_ptr, ssnprintf(), surface_box_win_new(), ui_draw_text(), ui_get_event(), ui_get_screen_size(), ui_surface, WIN, UiEvent::x, and UiEvent::y.

Here is the call graph for this function:

answer_yn()

int answer_yn	(	char *	msg0,
		char *	msg1,
		char *	msg2,
		char *	msg3 )

Accept a single letter answer.

answer_yn

Parameters

msg0	First error message line
msg1	Second error message line
msg2	Third error message line
msg3	Fourth error message line

Returns

Key code of user command

Definition at line 715 of file dwin.c.

                                                              {
    char title[MAXLEN];
    uint line, pos, msg_l, msg0_l, msg1_l, msg2_l, msg3_l;
 
    if (!f_curses_open) {
        fprintf(stderr, "\n\n%s\n%s\n%s\n%s\n\n", msg0, msg1, msg2, msg3);
        return 1;
    }
 
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 1, "F1 Help", KEY_F01);
    set_chyron_key(chyron, 2, "N - No", 'n');
    set_chyron_key(chyron, 3, "Y - Yes", 'y');
    compile_chyron(chyron);
 
    uint maxy, maxx;
    ui_get_screen_size(&maxy, &maxx);
    msg0_l = strnz(msg0, maxx - 4);
    msg1_l = strnz(msg1, maxx - 4);
    msg2_l = strnz(msg2, maxx - 4);
    msg3_l = strnz(msg1, maxx - 4);
    msg_l = max(msg0_l, msg1_l);
    msg_l = max(msg_l, msg2_l);
    msg_l = max(msg_l, msg3_l);
    msg_l = max(msg_l, chyron->l);
    msg_l = min(msg_l, maxx - 4);
 
    pos = ((maxx - msg_l) - 4) / 2;
    line = (maxy - 6) / 2;
    strnz__cpy(title, "Notification", MAXLEN - 1);
    if (surface_box_win_new(5, msg_l + 2, line, pos, title)) {
        ssnprintf(title, MAXLEN - 1, "surface_box_win_new(%d, %d, %d, %d, %s) failed", 5,
                  msg_l + 2, line, pos, title);
        destroy_chyron(chyron);
        abend(-1, title);
    }
    UiSurface *sfc = ui_surface[sfc_ptr];
    UiEvent event;
    ui_draw_text(sfc, WIN, 0, 1, msg0);
    ui_draw_text(sfc, WIN, 1, 1, msg1);
    ui_draw_text(sfc, WIN, 2, 1, msg2);
    ui_draw_text(sfc, WIN, 3, 1, msg3);
    display_chyron(sfc, WIN, chyron, 4, chyron->l + 1);
 
    do {
        ui_curs_set(1);
        event.y = event.x = -1;
        cmd_key = ui_get_event(sfc, WIN, &event, -1);
        if (cmd_key == KEY_F01 || cmd_key == 'N' || cmd_key == 'n' || cmd_key == 'Y' || cmd_key == 'y')
            break;
    } while (1);
    cm_surface_destroy(sfc);
    destroy_chyron(chyron);
    return (cmd_key);
}

References abend(), cm_surface_destroy(), cmd_key, compile_chyron(), destroy_chyron(), display_chyron(), f_curses_open, Chyron::l, new_chyron(), set_chyron_key(), sfc_ptr, ssnprintf(), strnz(), strnz__cpy(), surface_box_win_new(), ui_curs_set(), ui_draw_text(), ui_get_event(), ui_get_screen_size(), ui_surface, WIN, UiEvent::x, and UiEvent::y.

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 *	msg0,
		char *	msg1,
		char *	msg2,
		char *	msg3 )

Display an error message window or print to stderr.

display_error

Parameters

msg0	First error message line
msg1	Second error message line
msg2	Third error message line
msg3	Fourth error message line

Returns

Key code of user command

Definition at line 778 of file dwin.c.

                                                                  {
    char title[MAXLEN];
    uint line, pos, msg_l, msg0_l, msg1_l, msg2_l, msg3_l;
 
    if (!f_curses_open) {
        fprintf(stderr, "\n\n%s\n", msg0);
        fprintf(stderr, "%s\n", msg1);
        fprintf(stderr, "%s\n", msg2);
        fprintf(stderr, "%s\n\n", msg3);
        return 1;
    }
 
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 1, "F1 Help", KEY_F01);
    set_chyron_key(chyron, 9, "F9 Cancel", KEY_F09);
    set_chyron_key(chyron, 10, "F10 Continue", KEY_F10);
    compile_chyron(chyron);
 
    uint maxy, maxx;
    ui_get_screen_size(&maxy, &maxx);
    msg0_l = strnz(msg0, maxx - 4);
    msg1_l = strnz(msg1, maxx - 4);
    msg2_l = strnz(msg2, maxx - 4);
    msg3_l = strnz(msg1, maxx - 4);
    msg_l = max(msg0_l, msg1_l);
    msg_l = max(msg_l, msg2_l);
    msg_l = max(msg_l, msg3_l);
    msg_l = max(msg_l, chyron->l);
    msg_l = min(msg_l, maxx - 4);
 
    pos = ((maxx - msg_l) - 4) / 2;
    line = (maxy - 6) / 2;
    strnz__cpy(title, "Notification", MAXLEN - 1);
    if (surface_box_win_new(5, msg_l + 2, line, pos, title)) {
        ssnprintf(title, MAXLEN - 1, "box_win_new(%d, %d, %d, %d, %s) failed", 5,
                  msg_l + 2, line, pos, title);
        destroy_chyron(chyron);
        abend(-1, title);
    }
    UiSurface *sfc = ui_surface[sfc_ptr];
    UiEvent event;
    ui_draw_text(sfc, WIN, 0, 1, msg0);
    ui_draw_text(sfc, WIN, 1, 1, msg1);
    ui_draw_text(sfc, WIN, 2, 1, msg2);
    ui_draw_text(sfc, WIN, 3, 1, msg3);
 
    display_chyron(sfc, WIN, chyron, 4, chyron->l + 1);
    do {
        event.y = event.x = -1;
        cmd_key = ui_get_event(sfc, WIN, &event, -1);
        if (cmd_key == KEY_F09 || cmd_key == KEY_F10 || cmd_key == 'q' || cmd_key == 'Q')
            break;
    } while (1);
    cm_surface_destroy(sfc);
    destroy_chyron(chyron);
    return (cmd_key);
}

References abend(), cm_surface_destroy(), cmd_key, compile_chyron(), destroy_chyron(), display_chyron(), f_curses_open, Chyron::l, new_chyron(), set_chyron_key(), sfc_ptr, ssnprintf(), strnz(), strnz__cpy(), surface_box_win_new(), ui_draw_text(), ui_get_event(), ui_get_screen_size(), ui_surface, WIN, UiEvent::x, and UiEvent::y.

Referenced by enter_file_spec(), form_desc_error(), form_parse_desc(), form_process(), form_read_data(), form_write(), mk_dir(), new_init(), new_pick(), new_view(), notcurses_input(), parse_menu_description(), ui_add_pair(), verify_dir(), verify_file(), view_cmd_processor(), view_init_input(), and write_view_buffer().

Here is the call graph for this function:

Here is the caller graph for this function:

Perror()

int Perror

(

char *

emsg_str

)

Display a simple error message window or print to stderr.

Perror

Parameters

emsg_str

Error message string

Returns

Key code of user command

Definition at line 841 of file dwin.c.

                           {
    char emsg[MAXLEN];
    unsigned in_key;
    uint line, pos, cols;
    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, 79);
    if (!f_curses_open) {
        fprintf(stderr, "\n%s\n", emsg);
        return 1;
    }
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 1, "F1 Help", KEY_F01);
    set_chyron_key(chyron, 9, "F9 Cancel", KEY_F09);
    set_chyron_key(chyron, 10, "F10 Continue", KEY_F10);
    compile_chyron(chyron);
    uint maxy, maxx;
    ui_get_screen_size(&maxy, &maxx);
    cols = strnz(emsg, maxx - 4);
    cols = max(cols, chyron->l);
    ui_get_screen_size(&maxy, &maxx);
    pos = (maxx - cols - 4) / 2;
    line = (maxy - 4) / 2;
    strnz__cpy(title, "Notification", MAXLEN - 1);
    if (surface_box_win_new(2, cols + 2, line, pos, title)) {
        ssnprintf(title, MAXLEN - 1, "surface_box_win_new(%d, %d, %d, %d, %s, %b) failed",
                  4, line, line, pos, title);
        destroy_chyron(chyron);
        abend(-1, title);
    }
    UiSurface *sfc = ui_surface[sfc_ptr];
    UiEvent event;
    ui_draw_text(sfc, WIN, 0, 1, emsg_str);
    display_chyron(sfc, WIN, chyron, 1, chyron->l + 1);
    if (f_xwgetch) {
        event.y = event.x = -1;
        in_key = ui_get_event(sfc, WIN, &event, -1);
    } else {
        in_key = KEY_F10;
    }
    destroy_chyron(chyron);
    cm_surface_destroy(sfc);
    return (in_key);
}

References abend(), cm_surface_destroy(), compile_chyron(), destroy_chyron(), display_chyron(), f_curses_open, Chyron::l, new_chyron(), set_chyron_key(), sfc_ptr, ssnprintf(), strnz(), strnz__cpy(), surface_box_win_new(), ui_draw_text(), ui_get_event(), ui_get_screen_size(), ui_surface, WIN, UiEvent::x, and UiEvent::y.

Referenced by action_disposition(), display_form(), exec_objects(), field_editor(), fork_exec(), form_engine(), form_exec_receiver(), form_fmt_field(), form_process(), form_validate_field(), go_to_line(), go_to_mark(), go_to_percent(), increment_ln(), init_form(), init_pick(), init_view_full_screen(), initialize_line_table(), menu_engine(), new_init(), new_pick(), open_pick_win(), parse_menu_description(), pick_engine(), popup_ckeys(), search(), surface_box_win_new(), surface_split_box_win_new(), ui_init(), view_cmd_processor(), view_init_input(), and write_config().

Here is the call graph for this function:

Here is the caller graph for this function: