Name: H5Eget_auto1
 
Signature:
herr_t H5Eget_auto1( H5E_auto1_t * func, void **client_data )
 
Purpose:
Returns the current settings for the automatic error stack traversal function and its data.
 
Notice:
This function is deprecated in favor of the function H5Eget_auto2 or the macro H5Eget_auto.
 
Description:
H5Eget_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 H5Eprint1 and H5Eprint2. A call to H5Eget_auto2 returns H5Eprint2 or the user-defined function passed in through H5Eset_auto2. A call to H5Eget_auto1 returns H5Eprint1 or the user-defined function passed in through H5Eset_auto1. However, if the application passes in a user-defined function through H5Eset_auto1, it should call H5Eget_auto1 to query the traversal function. If the application passes in a user-defined function through H5Eset_auto2, it should call H5Eget_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 H5Eset_auto1, a call to H5Eget_auto2 will fail and will indicate that the application has mixed H5Eset_auto1 and H5Eget_auto2. On the other hand, mixing H5Eset_auto2 and H5Eget_auto1 will also cause a failure. But if the traversal functions are the library’s default H5Eprint1 or H5Eprint2, mixing H5Eset_auto1 and H5Eget_auto2 or mixing H5Eset_auto2 and H5Eget_auto1 does not fail.
 
Parameters:
 
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
 
Fortran90 Interface:
None.
 
History:
Release     C
1.8.0 Function H5Eget_auto renamed to H5Eget_auto1 and deprecated in this release.