H5Ewalk2(
hid_t estack_id,
H5E_direction_t direction,
H5E_walk2_t func,
void * client_data
)
H5Ewalk2 walks the error stack specified by
estack_id for the current thread and calls the function
specified in func for each error along the way.
If the value of estack_id is H5E_DEFAULT,
then H5Ewalk2 walks the current error stack.
direction specifies whether the stack is walked
from the inside out or the outside in.
A value of H5E_WALK_UPWARD means to begin with the
most specific error and end at the API;
a value of H5E_WALK_DOWNWARD means to start at the
API and end at the innermost function where the error was first
detected.
func, a function compliant with the
H5E_walk2_t prototype, will be called for each error
in the error stack.
Its arguments will include an index number n
(beginning at zero regardless of stack traversal direction),
an error stack entry err_desc,
and the client_data pointer passed to
H5E_print.
The H5E_walk2_t prototype is as follows:
typedef herr_t (*H5E_walk2_t)(unsigned n,
const H5E_error2_t *err_desc,
void *client_data)
where the parameters have the following meanings:
n
err_desc
hdf5/src/H5Epublic.h.
That file also contains the definitive list of major
and minor error codes; that information will
eventually be presented as an appendix to this
HDF5 Reference Manual.)
client_data
hid_t estack_id |
IN: Error stack identifier. |
H5E_direction_t direction |
IN: Direction in which the error stack is to be walked. |
H5E_walk2_t func |
IN: Function to be called for each error encountered. |
void * client_data |
IN: Data to be passed with func.
|
| Release | C |
| 1.8.0 | Function introduced in this release. |