Determines the number of bytes required to store variable-length (VL) data
Procedure:
H5D_VLEN_GET_BUF_SIZE(dataset_id, type_id, space_id, size)
Signature:
herr_t H5Dvlen_get_buf_size(hid_t dataset_id, hid_t type_id, hid_t space_id, hsize_t *size )
SUBROUTINE h5dvlen_get_max_len_f(dset_id, size, hdferr)
IMPLICIT NONE
INTEGER(HID_T), INTENT(IN) :: dset_id ! Dataset identifier
INTEGER(HID_T), INTENT(IN) :: type_id ! Datatype identifier
INTEGER(HID_T), INTENT(IN) :: space_id ! Dataspace identifier
INTEGER(SIZE_T), INTENT(OUT) :: elem_len ! Maximum length of the element
INTEGER, INTENT(OUT) :: hdferr ! Error code
! 0 on success and -1 on failure
END SUBROUTINE h5dvlen_get_max_len_f
Parameters:
hid_t dataset_id | IN: Identifier of the dataset to query |
hid_t type_id | IN: Datatype identifier |
hid_t space_id | IN: Dataspace identifier |
hsize_t *size | OUT: The size in bytes of the memory buffer required to store the VL data |
Description:
H5D_VLEN_GET_BUF_SIZE determines the number of bytes required to store the VL data from the dataset, using the space_id for the selection in the dataset on disk and the type_id for the memory representation of the VL data in memory.
*size is returned with the number of bytes required to store the VL data in memory.
Returns:
Returns non-negative value if successful; otherwise returns a negative value.
Example:
History:
| Release | Change |
|---|
| 1.4.5 | Fortran 90 function introduced in this release |
| 1.4.0 | C function introduced in this release |
--- Last Modified: December 18, 2018 | 01:37 PM
