Several changes has been made to the H5hut C and Fortran API:
* Versions newer than 0.99.13 provide an improved API to handle H5hut files. Existing code must be adapted accordingly.
* Versions newer than 0.99.13 provide an improved API to open H5hut files. Existing code must be adapted accordingly.
* A more complete set of functions to query datasets and attributes has been implemented.
* Starting with version 0.99.11 the C-API is implemented with inline functions. This does *not* require changes in the source code but for linking - the library `libh5hutC` has been removed.
* The compiler wrapper `h5hutcc` is obsolete and not available any more.
* The Fortran API has been reviewed and partially rewritten.
* More and better examples has been added some old examples removed.
== Handle H5hut file
== Changes in API
The API function to open a H5hut file are more general and more flexible making it simpler to add new features. Like in HDF5 you can define properties of a file and pass this properties to the open call. Adapting old code is easy and straight forward.
=== Open H5hut file
==== Old implementation
----
h5_file_t*
H5OpenFile (
const char* filename, /*!< file name */
h5_int32_t flags, /*!< file open flags */
MPI_Comm comm /*!< MPI communicator */
);
----
The return type was a pointer to a structure. With the argument `flags` the access mode of the file and the virtual file driver was selected. In the parallel version `comm` was used to pass the MPI communicator. In the serial version this argument was ignored.
==== New implementation
----
h5_file_t
H5OpenFile (
const char* const filename, ///< [in] name of file
const h5_prop_t props ///< [in] identifier for file property list
)
----
With the argument `flags` the file access mode is defined. The virtual file driver must be selected via a property list, if another than the default should be used.
