Pushes new error record onto error stack

This function is deprecated in favor of the function H5E_PUSH2 or the macro H5E_PUSH.

 

Procedure:

H5E_PUSH1(file, func, line, maj_num min_num, str)

Signature:

<pre><code class="language-c">herr_t H5Epush1( const char *file, const char *func, unsigned line, H5E_major_t maj_num, H5E_minor_t min_num, const char *str )</code></pre>

Parameters:
const char *fileIN: Name of the file in which the error was detected
const char *funcIN: Name of the function in which the error was detected
unsigned lineIN: Line within the file at which the error was detected
H5E_major_t maj_num    IN: Major error number
H5E_minor_t min_numIN: Minor error number
const char *strIN: Error description string

Description:

H5E_PUSH1 pushes a new error record onto the error stack for the current thread.

The error has major and minor numbers maj_num and min_num, the function func where the error was detected, the name of the file file where the error was detected, the line line within that file, and an error description string str.

The function name, filename, and error description strings must be statically allocated.

Returns:

Returns a non-negative value if successful; otherwise returns a negative value.

Example:

Coming Soon!

History:
Release    C
1.4.0Function introduced in this release.
1.8.0Function H5Epush renamed to H5Epush1 and deprecated in this release.