H5E_SET_AUTO2 turns on or off automatic printing of errors for the error stack specified with estack_id . An estack_id value of H5E_DEFAULT indicates the current stack. When automatic printing is turned on, by the use of a non-null func pointer, any API function which returns an error indication will first call func , passing it client_data as an argument. func , a function compliant with the H5E_auto2_t prototype, is defined in the H5Epublic.h source code file as:
typedef herr_t (*H5E_auto2_t)(hid_t estack, void *client_data);
When the library is first initialized, the auto printing function is set to H5E_PRINT2 (cast appropriately) and client_data is the standard error stream pointer, stderr . Automatic stack traversal is always in the H5E_WALK_DOWNWARD direction. Automatic error printing is turned off with a H5E_SET_AUTO2 call with a NULL func pointer. |