H5Tconvert
(
hid_t src_type_id
,
hid_t dest_type_id
,
size_t nelmts
,
void *buf
,
void *background
,
hid_t plist_id
)
H5Tconvert
converts nelmts
elements
from a source datatype. specified by src_type_id
,
to a destination datatype, dest_type_id
.
The source elements are packed in buf
and on return
the destination elements will be packed in buf
.
That is, the conversion is performed in place.
The optional background buffer is for use with compound datatypes.
It is an array of nelmts
values for the
destination datatype which can then be merged with the converted
values to recreate the compound datatype.
For instance, background
might be an array of structs with the a
and
b
fields already initialized and the conversion
of buf
supplies the c
and d
field values.
The parameter plist_id
contains the dataset transfer
property list identifier which is passed to the conversion functions.
As of Release 1.2, this parameter is only used to pass along the
variable-length datatype custom allocation information.
hid_t src_type_id |
IN: Identifier for the source datatype. |
hid_t dest_type_id |
IN: Identifier for the destination datatype. |
size_t nelmts |
IN: Size of array buf . |
void *buf |
IN/OUT: Array containing pre- and post-conversion
values.
H5Tconvert will not resize this buffer; it must be
large enough to hold the larger of the input and output data.
|
void *background |
IN: Optional background buffer. |
hid_t plist_id |
IN: Dataset transfer property list identifier. |
Release | Change |
1.8.8 | Fortran subroutine added. |
1.6.3 |
In C function, nelmts parameter type changed to
size_t. |
1.4.0 |
In C function, nelmts parameter type changed to
hsize_t. |