Creating a Dataset
Function Syntax
Create a dataset at the specified location.
hid_t H5Dcreate2( hid_t parentId, const char *name, hid_t datatypeId, hid_t spaceId, hid_t linkCreatePlistId, hid_t createPlistId, hid_t accessPlistId )
Parameters
Parameter |
Description |
Value Range |
Input/Output |
|---|---|---|---|
parentId |
Location identifier, which may be that of a file, group, dataset, named data type, or attribute |
Integer |
Input |
*name |
Dataset name |
Non-empty string of less than 256 bytes |
Input |
datatypeId |
Data type identifier |
Integer |
Input |
spaceId |
Data space identifier |
Integer |
Input |
linkCreatePlistId |
Link creation property list identifier |
Integer. The lcpl_id parameter is currently not used. Specify H5P_DEFAULT. |
Input |
createPlistId |
Dataset creation property list identifier |
Integer. The dcpl_id parameter is currently not used. Specify H5P_DEFAULT. |
Input |
accessPlistId |
Dataset access property list identifier |
Integer. The dapl_id parameter is currently not used. Specify H5P_DEFAULT. |
Input |
Return Value
- Success: dataset identifier
- Failure: negative value