Error Handling

C Functions	Modes
const char* error_message = cg_get_error ();	r w m
void cg_error_exit ();	r w m
void cg_error_print ();	r w m

Fortran interfaces	Modes
call cg_get_error_f (error_message)	r w m
call cg_error_exit_f ()	r w m
call cg_error_print_f ()	r w m

If an error occurs during the execution of a CGNS library function, signified by a non-zero value of the error status variable ier, an error message may be retrieved using the function cg_get_error. The function cg_error_exit may then be used to print the error message and stop the execution of the program. Alternatively, cg_error_print may be used to print the error message and continue execution of the program.

In C, you may define a function to be called automatically in the case of a warning or error using the cg_configure routine. The function is of the form void err_func(int is_error, char *errmsg), and will be called whenever an error or warning occurs. The first argument, is_error, will be 0 for warning messages, 1 for error messages, and −1 if the program is going to terminate (i.e., a call to cg_error_exit). The second argument is the error or warning message.