HDF5
1.14.4.3
API Reference
|
Modules | |
module | h5f |
This module contains Fortran interfaces for H5F functions. | |
Functions/Subroutines | |
subroutine | h5fcreate_f (name, access_flags, file_id, hdferr, creation_prp, access_prp) |
Creates HDF5 files. | |
subroutine | h5fcreate_async_f (name, access_flags, file_id, es_id, hdferr, creation_prp, access_prp, file, func, line) |
Asynchronously creates HDF5 files. | |
subroutine | h5fflush_f (object_id, scope, hdferr) |
Flushes all buffers associated with a file to disk. | |
subroutine | h5fdelete_f (name, hdferr, access_prp) |
Deletes an HDF5 file. | |
subroutine | h5fflush_async_f (object_id, scope, es_id, hdferr, file, func, line) |
Asynchronously flushes all buffers associated with a file to disk. | |
subroutine | h5fmount_f (loc_id, name, child_id, hdferr, access_prp) |
Mounts a file. | |
subroutine | h5funmount_f (loc_id, name, hdferr) |
Unmounts a file. | |
subroutine | h5fopen_f (name, access_flags, file_id, hdferr, access_prp) |
Opens HDF5 file. | |
subroutine | h5fopen_async_f (name, access_flags, file_id, es_id, hdferr, access_prp, file, func, line) |
Asynchronously opens HDF5 file. | |
subroutine | h5freopen_f (file_id, ret_file_id, hdferr) |
Reopens HDF5 file. | |
subroutine | h5freopen_async_f (file_id, ret_file_id, es_id, hdferr, file, func, line) |
Asynchronously reopens HDF5 file. | |
subroutine | h5fget_create_plist_f (file_id, prop_id, hdferr) |
Returns a file creation property list identifier. | |
subroutine | h5fget_access_plist_f (file_id, access_id, hdferr) |
Returns a file access property list identifier. | |
subroutine | h5fis_accessible_f (name, status, hdferr, access_prp) |
Determines whether a file can be accessed as HDF5. | |
subroutine | h5fis_hdf5_f (name, status, hdferr) |
Determines whether a file is in the HDF5 format. | |
subroutine | h5fclose_f (file_id, hdferr) |
Closes HDF5 file. | |
subroutine | h5fclose_async_f (file_id, es_id, hdferr, file, func, line) |
Asynchronously closes HDF5 file. | |
subroutine | h5fget_obj_count_f (file_id, obj_type, obj_count, hdferr) |
Gets number of the objects open within a file. | |
subroutine | h5fget_obj_ids_f (file_id, obj_type, max_objs, obj_ids, hdferr, num_objs) |
Get list of open objects identifiers within a file. | |
subroutine | h5fget_freespace_f (file_id, free_space, hdferr) |
Get amount of free space within a file. | |
subroutine | h5fget_name_f (obj_id, buf, size, hdferr) |
Gets the name of the file from the object identifier. | |
subroutine | h5fget_filesize_f (file_id, size, hdferr) |
Retrieves the file size of the HDF5 file. | |
subroutine | h5fget_fileno_f (file_id, fileno, hdferr) |
Retrieves the file number of the HDF5 file. | |
subroutine | h5fget_file_image_f (file_id, buf_ptr, buf_len, hdferr, buf_size) |
Retrieves a copy of the image of an existing, open file. | |
subroutine | h5fget_dset_no_attrs_hint_f (file_id, minimize, hdferr) |
Gets the value of the "minimize dataset headers" value which creates smaller dataset object headers when its set and no attributes are present. | |
subroutine | h5fset_dset_no_attrs_hint_f (file_id, minimize, hdferr) |
Sets the value of the "minimize dataset headers" value which creates smaller dataset object headers when its set and no attributes are present. | |
subroutine | h5fget_info_f (obj_id, file_info, hdferr) |
Retrieves global file information. | |
subroutine | h5fget_intent_f (file_id, intent, hdferr) |
Determines the read/write or read-only status of a file. | |
Variables | |
integer | h5f_acc_rdwr_f |
H5F_ACC_RDWR. | |
integer | h5f_acc_rdonly_f |
H5F_ACC_RDONLY. | |
integer | h5f_acc_trunc_f |
H5F_ACC_TRUNC. | |
integer | h5f_acc_excl_f |
H5F_ACC_EXCL. | |
integer | h5f_acc_debug_f |
H5F_ACC_DEBUG. | |
integer | h5f_scope_local_f |
H5F_SCOPE_LOCAL. | |
integer | h5f_scope_global_f |
H5F_SCOPE_GLOBAL. | |
integer | h5f_close_default_f |
H5F_CLOSE_DEFAULT. | |
integer | h5f_close_weak_f |
H5F_CLOSE_WEAK. | |
integer | h5f_close_semi_f |
H5F_CLOSE_SEMI. | |
integer | h5f_close_strong_f |
H5F_CLOSE_STRONG. | |
integer | h5f_obj_file_f |
H5F_OBJ_FILE. | |
integer | h5f_obj_dataset_f |
H5F_OBJ_DATASET. | |
integer | h5f_obj_group_f |
H5F_OBJ_GROUP. | |
integer | h5f_obj_datatype_f |
H5F_OBJ_DATATYPE. | |
integer | h5f_obj_all_f |
H5F_OBJ_ALL. | |
integer | h5f_libver_earliest_f |
H5F_LIBVER_EARLIEST. | |
integer | h5f_libver_latest_f |
H5F_LIBVER_LATEST. | |
integer | h5f_unlimited_f |
H5F_UNLIMITED. | |
integer | h5f_libver_error_f |
H5F_LIBVER_ERROR. | |
integer | h5f_libver_nbounds_f |
H5F_LIBVER_NBOUNDS. | |
integer | h5f_libver_v18_f |
H5F_LIBVER_V18. | |
integer | h5f_libver_v110_f |
H5F_LIBVER_V110. | |
integer | h5f_libver_v112_f |
H5F_LIBVER_V112. | |
integer | h5f_libver_v114_f |
H5F_LIBVER_V114. | |
integer | h5f_fspace_strategy_fsm_aggr_f |
H5F_FSPACE_STRATEGY_FSM_AGGR. | |
integer | h5f_fspace_strategy_page_f |
H5F_FSPACE_STRATEGY_PAGE. | |
integer | h5f_fspace_strategy_aggr_f |
H5F_FSPACE_STRATEGY_AGGR. | |
integer | h5f_fspace_strategy_none_f |
H5F_FSPACE_STRATEGY_NONE. | |
integer | h5f_fspace_strategy_ntypes_f |
H5F_FSPACE_STRATEGY_NTYPES. | |
subroutine h5fclose_async_f | ( | integer(hid_t), intent(in) | file_id, |
integer(hid_t), intent(in) | es_id, | ||
integer, intent(out) | hdferr, | ||
type(c_ptr), intent(in), optional | file, | ||
type(c_ptr), intent(in), optional | func, | ||
integer, intent(in), optional | line | ||
) |
Asynchronously closes HDF5 file.
file_id | File identifier |
es_id | Event set identifier |
hdferr | Returns 0 if successful and -1 if it fails. |
file | Pointer to filename the async subroutine is being called from, filename must be null character terminated |
func | Pointer to function name the async subroutine is being called in, func must be null character terminated |
line | Line number the async subroutine is being called at |
See C API: H5Fclose_async()
subroutine h5fclose_f | ( | integer(hid_t), intent(in) | file_id, |
integer, intent(out) | hdferr | ||
) |
Closes HDF5 file.
file_id | File identifier. |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fclose()
subroutine h5fcreate_async_f | ( | character(len=*), intent(in) | name, |
integer, intent(in) | access_flags, | ||
integer(hid_t), intent(out) | file_id, | ||
integer(hid_t), intent(in) | es_id, | ||
integer, intent(out) | hdferr, | ||
integer(hid_t), intent(in), optional | creation_prp, | ||
integer(hid_t), intent(in), optional | access_prp, | ||
type(c_ptr), intent(in), optional | file, | ||
type(c_ptr), intent(in), optional | func, | ||
integer, intent(in), optional | line | ||
) |
Asynchronously creates HDF5 files.
name | Name of the file to create |
access_flags | File access flags. Allowable values are:
|
file_id | File identifier |
es_id | Event set identifier |
hdferr | Returns 0 if successful and -1 if it fails. |
creation_prp | File creation property list identifier |
access_prp | File access property list identifier |
file | Pointer to filename the async subroutine is being called from, filename must be null character terminated |
func | Pointer to function name the async subroutine is being called in, func must be null character terminated |
line | Line number the async subroutine is being called at |
See C API: H5Fcreate_async()
subroutine h5fcreate_f | ( | character(len=*), intent(in) | name, |
integer, intent(in) | access_flags, | ||
integer(hid_t), intent(out) | file_id, | ||
integer, intent(out) | hdferr, | ||
integer(hid_t), intent(in), optional | creation_prp, | ||
integer(hid_t), intent(in), optional | access_prp | ||
) |
Creates HDF5 files.
name | Name of the file to create. |
access_flags | File access flags. Allowable values are:
|
file_id | File identifier. |
hdferr | Returns 0 if successful and -1 if it fails. |
creation_prp | File creation property list identifier. |
access_prp | File access property list identifier. |
See C API: H5Fcreate()
subroutine h5fdelete_f | ( | character(len=*), intent(in) | name, |
integer, intent(out) | hdferr, | ||
integer(hid_t), intent(in), optional | access_prp | ||
) |
Deletes an HDF5 file.
name | Name of the file to delete |
hdferr | Returns 0 if successful and -1 if it fails. |
access_prp | File access property list identifier |
See C API: H5Fdelete()
subroutine h5fflush_async_f | ( | integer(hid_t), intent(in) | object_id, |
integer, intent(in) | scope, | ||
integer(hid_t), intent(in) | es_id, | ||
integer, intent(out) | hdferr, | ||
type(c_ptr), intent(in), optional | file, | ||
type(c_ptr), intent(in), optional | func, | ||
integer, intent(in), optional | line | ||
) |
Asynchronously flushes all buffers associated with a file to disk.
object_id | Identifier of object used to identify the file. |
scope | Specifies the scope of the flushing action. Possible values are:
|
es_id | Event set identifier |
hdferr | Returns 0 if successful and -1 if it fails. |
file | Pointer to filename the async subroutine is being called from, filename must be null character terminated |
func | Pointer to function name the async subroutine is being called in, func must be null character terminated |
line | Line number the async subroutine is being called at |
See C API: H5Fflush_async()
subroutine h5fflush_f | ( | integer(hid_t), intent(in) | object_id, |
integer, intent(in) | scope, | ||
integer, intent(out) | hdferr | ||
) |
Flushes all buffers associated with a file to disk.
object_id | Identifier of object used to identify the file. |
scope | Specifies the scope of the flushing action. Possible values are:
|
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fflush()
subroutine h5fget_access_plist_f | ( | integer(hid_t), intent(in) | file_id, |
integer(hid_t), intent(out) | access_id, | ||
integer, intent(out) | hdferr | ||
) |
Returns a file access property list identifier.
file_id | Identifier of a file to creation property list of. |
access_id | Access property list identifier. |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fget_access_plist()
subroutine h5fget_create_plist_f | ( | integer(hid_t), intent(in) | file_id, |
integer(hid_t), intent(out) | prop_id, | ||
integer, intent(out) | hdferr | ||
) |
Returns a file creation property list identifier.
file_id | Identifier of a file to creation property list of. |
prop_id | Creation property list identifier. |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fget_create_plist()
subroutine h5fget_dset_no_attrs_hint_f | ( | integer(hid_t), intent(in) | file_id, |
logical, intent(out) | minimize, | ||
integer, intent(out) | hdferr | ||
) |
Gets the value of the "minimize dataset headers" value which creates smaller dataset object headers when its set and no attributes are present.
file_id | Target file identifier |
minimize | Value of the setting |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fget_dset_no_attrs_hint()
subroutine h5fget_file_image_f | ( | integer(hid_t), intent(in) | file_id, |
type(c_ptr), intent(inout) | buf_ptr, | ||
integer(size_t), intent(in) | buf_len, | ||
integer, intent(out) | hdferr, | ||
integer(size_t), intent(out), optional | buf_size | ||
) |
Retrieves a copy of the image of an existing, open file.
file_id | Target file identifier |
buf_ptr | Pointer to the buffer into which the image of the HDF5 file is to be copied |
buf_len | Size of the supplied buffer |
hdferr | Returns 0 if successful and -1 if it fails. |
buf_size | Returns the size in bytes of the buffer required to store the file image, no data will be copied |
See C API: H5Fget_file_image()
subroutine h5fget_fileno_f | ( | integer(hid_t), intent(in) | file_id, |
integer, intent(out) | fileno, | ||
integer, intent(out) | hdferr | ||
) |
Retrieves the file number of the HDF5 file.
file_id | File identifier |
fileno | File number |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fget_fileno()
subroutine h5fget_filesize_f | ( | integer(hid_t), intent(in) | file_id, |
integer(hsize_t), intent(out) | size, | ||
integer, intent(out) | hdferr | ||
) |
Retrieves the file size of the HDF5 file.
file_id | File identifier |
size | File size |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fget_filesize()
subroutine h5fget_freespace_f | ( | integer(hid_t), intent(in) | file_id, |
integer(hssize_t), intent(out) | free_space, | ||
integer, intent(out) | hdferr | ||
) |
Get amount of free space within a file.
file_id | File identifier |
free_space | Amount of free space in file |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fget_freespace()
subroutine h5fget_info_f | ( | integer(hid_t), intent(in) | obj_id, |
type(h5f_info_t), intent(out), target | file_info, | ||
integer, intent(out) | hdferr | ||
) |
Retrieves global file information.
obj_id | Object identifier. The identifier may be that of a file, group, dataset, named datatype, or attribute. |
file_info | Buffer for global file information |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fget_info2()
subroutine h5fget_intent_f | ( | integer(hid_t), intent(in) | file_id, |
integer, intent(out) | intent, | ||
integer, intent(out) | hdferr | ||
) |
Determines the read/write or read-only status of a file.
file_id | File identifier |
intent | Access mode flag as originally passed with H5Fopen_f() |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fget_intent()
subroutine h5fget_name_f | ( | integer(hid_t), intent(in) | obj_id, |
character(len=*), intent(out) | buf, | ||
integer(size_t), intent(out) | size, | ||
integer, intent(out) | hdferr | ||
) |
Gets the name of the file from the object identifier.
obj_id | Object identifier |
buf | Buffer to store the read name |
size | Actual size of the name |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fget_name()
subroutine h5fget_obj_count_f | ( | integer(hid_t), intent(in) | file_id, |
integer, intent(in) | obj_type, | ||
integer(size_t), intent(out) | obj_count, | ||
integer, intent(out) | hdferr | ||
) |
Gets number of the objects open within a file.
file_id | File identifier |
obj_type | Type of the object; possible values are:
|
obj_count | Number of open objects |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fget_obj_count()
subroutine h5fget_obj_ids_f | ( | integer(hid_t), intent(in) | file_id, |
integer, intent(in) | obj_type, | ||
integer(size_t), intent(in) | max_objs, | ||
integer(hid_t), dimension(*), intent(inout) | obj_ids, | ||
integer, intent(out) | hdferr, | ||
integer(size_t), intent(out), optional | num_objs | ||
) |
Get list of open objects identifiers within a file.
file_id | File identifier |
obj_type | Type of the object; possible values are:
|
max_objs | Maximum # of objects to retrieve |
obj_ids | Array of open object identifiers |
hdferr | Returns 0 if successful and -1 if it fails. |
num_objs | Number of open objects |
See C API: H5Fget_obj_ids()
subroutine h5fis_accessible_f | ( | character(len=*), intent(in) | name, |
logical, intent(out) | status, | ||
integer, intent(out) | hdferr, | ||
integer(hid_t), intent(in), optional | access_prp | ||
) |
Determines whether a file can be accessed as HDF5.
name | Name of the file to check. |
status | Indicates if file is and HDF5 file. |
hdferr | Returns 0 if successful and -1 if it fails. |
access_prp | File access property list identifier. |
See C API: H5Fis_accessible()
subroutine h5fis_hdf5_f | ( | character(len=*), intent(in) | name, |
logical, intent(out) | status, | ||
integer, intent(out) | hdferr | ||
) |
Determines whether a file is in the HDF5 format.
name | Name of the file to check. |
status | Indicates if file is and HDF5 file. |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fis_hdf5()
subroutine h5fmount_f | ( | integer(hid_t), intent(in) | loc_id, |
character(len=*), intent(in) | name, | ||
integer(hid_t), intent(in) | child_id, | ||
integer, intent(out) | hdferr, | ||
integer(hid_t), intent(in), optional | access_prp | ||
) |
Mounts a file.
loc_id | The identifier for of file or group in which name is defined. |
name | The name of the group onto which the file specified by child_id is to be mounted. |
child_id | The identifier of the file to be mounted. |
hdferr | Returns 0 if successful and -1 if it fails. |
access_prp | The identifier of the property list to be used. |
See C API: H5Fmount()
subroutine h5fopen_async_f | ( | character(len=*), intent(in) | name, |
integer, intent(in) | access_flags, | ||
integer(hid_t), intent(out) | file_id, | ||
integer(hid_t), intent(in) | es_id, | ||
integer, intent(out) | hdferr, | ||
integer(hid_t), intent(in), optional | access_prp, | ||
type(c_ptr), intent(in), optional | file, | ||
type(c_ptr), intent(in), optional | func, | ||
integer, intent(in), optional | line | ||
) |
Asynchronously opens HDF5 file.
name | Name of the file to acecss. |
access_flags | File access flags. Allowable values are:
|
file_id | File identifier |
es_id | Event set identifier |
hdferr | Returns 0 if successful and -1 if it fails. |
access_prp | File access property list identifier |
file | Pointer to filename the async subroutine is being called from, filename must be null character terminated |
func | Pointer to function name the async subroutine is being called in, func must be null character terminated |
line | Line number the async subroutine is being called at |
See C API: H5Fopen_async()
subroutine h5fopen_f | ( | character(len=*), intent(in) | name, |
integer, intent(in) | access_flags, | ||
integer(hid_t), intent(out) | file_id, | ||
integer, intent(out) | hdferr, | ||
integer(hid_t), intent(in), optional | access_prp | ||
) |
Opens HDF5 file.
name | Name of the file to acecss. |
access_flags | File access flags. Allowable values are:
|
file_id | File identifier. |
hdferr | Returns 0 if successful and -1 if it fails. |
access_prp | File access property list identifier. |
See C API: H5Fopen()
subroutine h5freopen_async_f | ( | integer(hid_t), intent(in) | file_id, |
integer(hid_t), intent(out) | ret_file_id, | ||
integer(hid_t), intent(in) | es_id, | ||
integer, intent(out) | hdferr, | ||
type(c_ptr), intent(in), optional | file, | ||
type(c_ptr), intent(in), optional | func, | ||
integer, intent(in), optional | line | ||
) |
Asynchronously reopens HDF5 file.
file_id | Identifier of a file for which an additional identifier is required. |
ret_file_id | New file identifier. |
es_id | Event set identifier |
hdferr | Returns 0 if successful and -1 if it fails. |
file | Pointer to filename the async subroutine is being called from, filename must be null character terminated |
func | Pointer to function name the async subroutine is being called in, func must be null character terminated |
line | Line number the async subroutine is being called at |
See C API: H5Freopen_async()
subroutine h5freopen_f | ( | integer(hid_t), intent(in) | file_id, |
integer(hid_t), intent(out) | ret_file_id, | ||
integer, intent(out) | hdferr | ||
) |
Reopens HDF5 file.
file_id | Identifier of a file for which an additional identifier is required. |
ret_file_id | New file identifier. |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Freopen()
subroutine h5fset_dset_no_attrs_hint_f | ( | integer(hid_t), intent(in) | file_id, |
logical, intent(in) | minimize, | ||
integer, intent(out) | hdferr | ||
) |
Sets the value of the "minimize dataset headers" value which creates smaller dataset object headers when its set and no attributes are present.
file_id | Target file identifier |
minimize | Value of the setting |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Fset_dset_no_attrs_hint()
subroutine h5funmount_f | ( | integer(hid_t), intent(in) | loc_id, |
character(len=*), intent(in) | name, | ||
integer, intent(out) | hdferr | ||
) |
Unmounts a file.
loc_id | The identifier for of file or group in which name is defined. |
name | The name of the mount point. |
hdferr | Returns 0 if successful and -1 if it fails. |
See C API: H5Funmount()
integer h5f_acc_debug_f |
H5F_ACC_DEBUG.
integer h5f_acc_excl_f |
H5F_ACC_EXCL.
integer h5f_acc_rdonly_f |
H5F_ACC_RDONLY.
integer h5f_acc_rdwr_f |
H5F_ACC_RDWR.
integer h5f_acc_trunc_f |
H5F_ACC_TRUNC.
integer h5f_close_default_f |
H5F_CLOSE_DEFAULT.
integer h5f_close_semi_f |
H5F_CLOSE_SEMI.
integer h5f_close_strong_f |
H5F_CLOSE_STRONG.
integer h5f_close_weak_f |
H5F_CLOSE_WEAK.
integer h5f_fspace_strategy_aggr_f |
H5F_FSPACE_STRATEGY_AGGR.
integer h5f_fspace_strategy_fsm_aggr_f |
H5F_FSPACE_STRATEGY_FSM_AGGR.
integer h5f_fspace_strategy_none_f |
H5F_FSPACE_STRATEGY_NONE.
integer h5f_fspace_strategy_ntypes_f |
H5F_FSPACE_STRATEGY_NTYPES.
integer h5f_fspace_strategy_page_f |
H5F_FSPACE_STRATEGY_PAGE.
integer h5f_libver_earliest_f |
H5F_LIBVER_EARLIEST.
integer h5f_libver_error_f |
H5F_LIBVER_ERROR.
integer h5f_libver_latest_f |
H5F_LIBVER_LATEST.
integer h5f_libver_nbounds_f |
H5F_LIBVER_NBOUNDS.
integer h5f_libver_v110_f |
H5F_LIBVER_V110.
integer h5f_libver_v112_f |
H5F_LIBVER_V112.
integer h5f_libver_v114_f |
H5F_LIBVER_V114.
integer h5f_libver_v18_f |
H5F_LIBVER_V18.
integer h5f_obj_all_f |
H5F_OBJ_ALL.
integer h5f_obj_dataset_f |
H5F_OBJ_DATASET.
integer h5f_obj_datatype_f |
H5F_OBJ_DATATYPE.
integer h5f_obj_file_f |
H5F_OBJ_FILE.
integer h5f_obj_group_f |
H5F_OBJ_GROUP.
integer h5f_scope_global_f |
H5F_SCOPE_GLOBAL.
integer h5f_scope_local_f |
H5F_SCOPE_LOCAL.
integer h5f_unlimited_f |
H5F_UNLIMITED.