... | ... | @@ -6,17 +6,44 @@ link:../home[Back to home page] |
|
|
|
|
|
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_int64_t flags, ///< [in] file access mode
|
|
|
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.
|
|
|
|
|
|
=== Property lists
|
|
|
|
|
|
|
|
|
More to be written ...
|
|
|
|
|
|
== Compiling and Linking
|
... | ... | |