Reading a Dataset
Function Syntax
Read raw data from a dataset into a buffer.
herr_t H5Dread(hid_t datasetId, hid_t datatypeId, hid_t memorySpaceId, hid_t fileSpaceId, hid_t xferPropertylistId, void * buffer )
Parameters
Parameter |
Description |
Value Range |
Input/Output |
|---|---|---|---|
datasetId |
Identifier of the dataset to read |
Integer |
Input |
datatypeId |
Identifier of the memory data type |
Integer |
Input |
memorySpaceId |
Identifier of the memory data space |
Integer |
Input |
fileSpaceId |
Identifier of the data space of the dataset in the file |
Integer |
Input |
xferPropertylistId |
Transfer property list identifier of this I/O operation |
Integer |
Input |
*buffer |
Buffer for the data to read from the file |
Non-empty |
Output |
Return Value
- Success: non-negative value
- Failure: negative value
Parent topic: Dataset APIs