Creates a packet table to store fixed-length or variable-length packets.
Procedure:
H5PT_CREATE(loc_id, ptable_name, dtype_id, chunk_size, plist_id)
Signature:
hid_t H5PTcreate(hid_t loc_id, const char * ptable_name, hid_t dtype_id, hsize_t chunk_size, hid_t plist_id)
Parameters:
hid_t loc_id
IN: Identifier of the file or group to create the table within.
const char * ptable_name
IN: The name of the packet table to create.
hid_t dtype_id
IN: The datatype of the packet.
hsize_t chunk_size
IN: Chunk size, in number of table entries per chunk. Packet table datasets use HDF5 chunked storage to allow them to grow. This value allows the user to set the size of a chunk. The chunk size affects performance.
hid_t plist_id
IN: Identifier of the property list. Can be used to specify the compression of the packet table.
Description:
H5PTcreate creates and opens a packet table named ptable_name attached to the object specified by the identifier loc_id. The created packet table should be closed with H5PTclose, eventually. The datatype, dtype_id, may specify any datatype, including variable-length data. If dtype_id specifies a compound datatype, one or more fields in that compound type may be variable-length.
Returns:
Returns an identifier for the new packet table or H5I_INVALID_HID on error.
Example:
History:
| Release | Change |
| 1.10.0 and 1.8.17 | Function introduced. |
--- Last Modified: December 04, 2017 | 07:23 AM
