NAME

insert_error - Inserts a new error line before other error lines.

SYNOPSIS

#include "l/l_sys_err.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


void insert_error
(
	const char *format_str,
	...
);

DESCRIPTION

This routine is similar to add_error, except that the line is added at the begining of the error lines, not at the end. The argmuents to insert_error is a format string followed by zero or more corresponding arguments. See kjb_fprintf for some of the non-standard options useful for error messages like %S, %F, %D. (%S is particularly helpful---it accesses the error messages from the last unsuccessful system call).

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER

Kobus Barnard

SEE ALSO

push_error_action , pop_error_action , set_error_action , get_error_action , set_bug_handler , default_bug_handler , kjb_print_error , kjb_get_error , kjb_get_strlen_error , kjb_clear_error , set_error , add_error , cat_error , str_set_error , str_add_error , str_cat_error , str_insert_error , set_bug