Previous topic

Module H5D

Next topic

Module H5F

This Page

Module H5E

Implements HDF5 error support and Python exception translation.

class h5py.h5e.H5Error
Base class for internal HDF5 library exceptions.
h5py.h5e.verbose(BOOL verbose)
If FALSE (default), exception messages are a single line. If TRUE, an HDF5 stack trace is attached.
h5py.h5e.register_thread() → HDF5ErrorHandler

Register the current thread for native HDF5 exception support.

Code which uses the low-level HDF5 API (h5py.h5*) is required to call this function before using HDF5. The main thread is automatically registered when h5py is imported. The high-level interface (h5py.*) is unaffected.

Returns an opaque object which represents the previously-installed error handler. Passing this object to unregister_thread will restore the previous behavior.

h5py.h5e.unregister_thread(HDF5ErrorHandler handler=None)

Unregister the current thread, turning off HDF5 exception support.

This will disable h5py in the current thread, making third-party libraries free to interact with the HDF5 error subsystem as they wish. Call register_thread() again to re-enable exception support.

If a “native” error handler has been retrieved with register_thread(), it can be reinstalled by passing it to this function. If not, it installs the default HDF5 handler H5Eprint.

Does not affect any other thread. Safe to call more than once.