Returns the current settings for the automatic error stack traversal function and its data
Procedure:
H5E_GET_AUTO1(func, client_data)
Signature:
herr_t H5Eget_auto1( H5E_auto1_t * func, void **client_data )
Parameters:
H5E_auto1_t * func | OUT: Current setting for the function to be called upon an error condition |
void **client_data | OUT: Current setting for the data passed to the error function |
Description:
H5E_GET_AUTO1 returns the current settings for the automatic error stack traversal function, func, and its data, client_data. Either or both arguments may be null, in which case the value is not returned.
The library initializes its default error stack traversal functions to H5E_PRINT1 and H5E_PRINT2. A call to H5E_GET_AUTO2 returns H5E_PRINT2 or the user-defined function passed in through H5E_SET_AUTO2. A call to H5E_GET_AUTO1 returns H5E_PRINT1 or the user-defined function passed in through H5E_SET_AUTO1. However, if the application passes in a user-defined function through H5E_SET_AUTO1, it should call H5E_GET_AUTO1 to query the traversal function. If the application passes in a user-defined function through H5E_SET_AUTO2, it should call H5E_GET_AUTO2 to query the traversal function.
Mixing the new style and the old style functions will cause a failure. For example, if the application sets a user-defined old-style traversal function through H5E_SET_AUTO1, a call to H5E_GET_AUTO2 will fail and will indicate that the application has mixed H5E_SET_AUTO1 and H5E_GET_AUTO2. On the other hand, mixing H5E_SET_AUTO2 and H5E_GET_AUTO1 will also cause a failure. But if the traversal functions are the library’s default H5E_PRINT1 or H5E_PRINT2, mixing H5E_SET_AUTO1 and H5E_GET_AUTO2 or mixing H5E_SET_AUTO2 and H5E_GET_AUTO1 does not fail.
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Example:
History:
| Release | Change |
|---|
| 1.8.0 | Function H5Eget_auto renamed to H5Eget_auto1 and deprecated in this release. |
--- Last Modified: January 08, 2020 | 02:14 PM
