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. |