Page tree

The license could not be verified: License Certificate has expired!

This page is under construction and is subject to change.

For a description of the major new features that were introduced, please see New Features in HDF5 Release 1.12.

This page provides information on the changes that a maintenance developer needs to be aware of between successive releases of HDF5, such as:

  • New or changed features or tools
  • Syntax and behavioral changes in the existing application programming interface (the API)
  • Certain types of changes in configuration or build processes

Note that bug fixes and performance enhancements in the C library are automatically picked up by the C++, Fortran, and Java libraries.

The following information is included below.

The release notes also list changes made to the library, but these notes tend to be more at a more detail-oriented level. The release notes may include new features, bugs fixed, supported configuration features, platforms on which the library has been tested, and known problems. The release note files are listed below and can be found at the top level of the HDF5 source code tree in the release_docs directory.

Release Notes

Technical notes regarding the current release of the HDF5 library (RELEASE.txt in the source code)

HISTORY-1_10.txt

Release information for all HDF5-1.10 releases

HISTORY-1_8_0-1_10_0.txt

Development history between the HDF5-1.8.0 and HDF5-1.10.0 releases

HISTORY-1_10.txt

Release information for HDF5-1.10.0 through 1.10.5.

HISTORY-1_0-1_8_0_rc3.txt
                         

Technical notes starting with HDF5-1.0.0 and ending with HDF5-1.8.0-rc3 (the state of the code prior to the HDF5-1.8.0 release)

Release 1.12.0 versus Release 1.10.5

This section lists interface-level changes and other user-visible changes in behavior in the transition from HDF5 Release 1.10.5 to Release 1.12.0.

New Features

For a description of the major new features that were introduced, please see New Features in HDF5 Release 1.12.

New and Changed Functions, Classes, Subroutines, Wrappers, and Macros

In the C/Fortran Interface (main library)

Folllowing are the new or changed APIs introduced in HDF5-1.12.0. Those introduced with a new feature list the specific new feature that they were added for.

Procedure / FunctionNew FeatureFortranDescription or Change
H5F_DELETE  Deletes an HDF5 file
H5F_GET_FILENO YRetrieves a file's file number that uniquely identifies the open file
H5F_IS_ACCESSIBLE YDetermines if a file can be opened with a given fapl
H5O_GET_INFO, H5O_GET_INFO1     The function H5O_GET_INFO was replaced by the macro H5O_GET_INFO, and the function H5O_GET_INFO1 was deprecated.
H5O_GET_INFO_BY_IDX, H5O_GET_INFO_BY_IDX1     The function H5O_GET_INFO_BY_IDX was replaced by the macro H5O_GET_INFO_BY_IDX, and the function H5O_GET_INFO_BY_IDX1 was deprecated.
H5O_GET_INFO_BY_NAME, H5O_GET_INFO_BY_NAME1     The function H5O_GET_INFO_BY_NAME was replaced by the macro H5O_GET_INFO_BY_NAME, and the function H5O_GET_INFO_BY_NAME1 was deprecated.
H5O_VISIT, H5O_VISIT1     The function H5O_VISIT was replaced by the macro H5O_VISIT, and the function H5O_VISIT1 was deprecated.
H5O_VISIT_BY_NAME, H5O_VISIT_BY_NAME1     The function H5O_VISIT_BY_NAME was replaced by the macro H5O_VISIT_BY_NAME, and the function H5O_VISIT_BY_NAME1 was deprecated.

H5P_ENCODE2, H5P_ENCODE1, H5P_ENCODE

  

Encodes properties on a property list into a buffer

The previous function was renamed to H5P_ENCODE1 and deprecated, and the macro H5P_ENCODE was introduced.

H5P_GET_VOL_IDVOL/VFDYReturns the identifier of the current VOL connector
H5P_GET_VOL_INFOVOL/VFDNReturns a copy of the VOL information for a connector
H5P_SET_VOLVOL/VFDYSet the file VOL connector for a file access property list
H5P_SET_FAPL_HDFSVOL/VFD Sets up Read-Only HDFS virtual file driver
H5P_SET_FAPL_ROS3VOL/VFD Sets up Read-Only S3 virtual file driver
H5R_COPYReference Copies an existing reference
H5R_CREATE_ATTRReference Creates an attribute reference
H5R_CREATE_OBJECTReference Creates an object reference
H5R_CREATE_REGIONReference Creates a region reference
H5R_DECODEReference Decodes a reference from a buffer
H5R_DESTROYReference Closes a reference
H5R_ENCODEReference Encodes a reference into a buffer
H5R_EQUALReference Determines whether two references are equal
H5R_GET_ATTR_NAMEReference Retrieves the attribute name for a referenced object
H5R_GET_FILE_NAMEReference Retrieves the file name for a referenced object
H5R_GET_OBJ_NAMEReference Retrieves the object name for a referenced object
H5R_GET_OBJ_TYPE3Reference Retrieves the type of object that an object reference points to
H5R_GET_TYPEReference Retrieves the type of reference
H5R_OPEN_ATTRReference Opens the referenced HDF5 attribute
H5R_OPEN_OBJECTReference Opens the referenced HDF5 object
H5R_OPEN_REGIONReference Sets up a dataspace and selection as specified by a region reference
H5S_COMBINE_HYPERSLABSelections Performs an operation on a hyperslab and an existing selection and returns the resulting selection
H5S_COMBINE_SELECTSelections 

Combines two hyperslab selections with an operation, returning a dataspace with the resulting selection

H5S_ENCODE2. H5S_ENCODE1, H5S_ENCODE

  

Encodes a dataspace object description into a binary buffer

The function H5S_ENCODE was renamed to H5S_ENCODE1 and deprecated in this release. The macro H5S_ENCODE and the function H5S_ENCODE2 were introduced in this release.

H5S_HYPER_ADJUST_SSelections Adjusts a hyperslab selection by subtracting an offset
H5S_MODIFY_SELECTSelections 

Refines a hyperslab selection with an operation using a second hyperslab to modify it

H5S_SEL_ITER_CLOSESelections 

Closes a dataspace selection iterator

H5S_SEL_ITER_CREATESelections Creates a dataspace selection iterator for a dataspace's selection
H5S_SEL_ITER_GET_SEQ_LISTSelections  
H5S_SELECT_ADJUST_USelections  
H5S_SELECT_COPYSelections  
H5S_SELECT_INTERSECT_BLOCKSelections  
H5S_SELECT_SHAPE_SAMESelections  
H5VL_CLOSEVOLYCloses a VOL connector identifier
H5VL_GET_CONNECTOR_IDVOLYRetrieves the identifier for a registered VOL connector
H5VL_GET_CONNECTOR_NAME

VOL

YRetrieves the connector name for the VOL associated with the object or file identifier
H5VL_IS_CONNECTOR_REGISTEREDVOL
YTests whether a VOL class has been registered or not
H5VL_REGISTER_CONNECTORVOL
NRegisters a new VOL connector
H5VL_REGISTER_CONNECTOR_BY_NAMEVOLYRegisters a new VOL connector by name
H5VL_REGISTER_CONNECTOR_BY_VALUEVOL
YRegisters a new VOL connector by connector value
H5VL_UNREGISTER_CONNECTORVOLYRemoves a VOL connector identifier from the library

 

In the C++ Wrapper

Function 
H5File::getFileNum ( )  
H5File::isAccessible 
 LinkCreatPropList::getCreateIntermediateGroup 
LinkCreatPropList::setCreateIntermediateGroup 
  
  

 

In the Fortran Wrapper


In the Java wrapper



New and Changed Elements of the Packet Table (H5PT) High-level API

In the C Interface

 

In the C++ Interface

 

In the Fortran Interface


In the Java Interface

Functions with Changed Behavior

 

API Compatibility

See API Compatibility Macros in HDF5 for details on the following.

New API Compatibility Flag

Compatibility Report and Comments

Compatibility report for Release 1.12.0 versus Release 1.10.5

   See API Compatibility Reports for information regarding compatibility with previous releases.

 

--- Last Modified: September 20, 2019 | 02:59 PM