H5Epush2
(
hid_t estack_id
,
const char *file
,
const char *func
,
unsigned line
,
hid_t class_id
,
hid_t major_id
,
hid_t minor_id
,
const char *msg
,
...)
H5Epush2
pushes a new error record onto the
error stack specified by estack_id
.
The error record contains
the error class identifier class_id
,
the major and minor message identifiers major_id
and
minor_id
,
the function name func
where the error was detected,
the filename file
and line number line
within that file where the error was detected, and
an error description msg
.
The major and minor errors must be in the same error class.
The function name, filename, and error description strings must be statically allocated.
msg
can be a format control string with
additional arguments. This design of appending additional arguments
is similar to the system and C functions printf
and
fprintf
.
hid_t estack_id |
IN: Identifier of the error stack to which
the error record is to be pushed.
If the identifier is H5E_DEFAULT , the error record
will be pushed to the current stack. |
const char *file |
IN: Name of the file in which the error was detected. |
const char *func |
IN: Name of the function in which the error was detected. |
unsigned line |
IN: Line number within the file at which the error was detected. |
hid_t class_id |
IN: Error class identifier. |
hid_t major_id |
IN: Major error identifier. |
hid_t minor_id |
IN: Minor error identifier. |
const char *msg |
IN: Error description string. |
Release | C |
1.8.0 | Function introduced in this release. |