Functions | Modes |
---|---|
error_message = const char *cg_get_error();
|
r w m
|
void cg_error_exit();
|
r w m
|
void cg_error_print();
|
r w m
|
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.