H5Oget_info
(
hid_t object_id
,
H5O_info_t *object_info
)
H5Oget_info
specifies an object by its identifier,
object_id
, and retrieves the metadata describing that object
in object_info
, an H5O_info_t struct.
An H5O_info_t struct is defined (in H5Opublic.h
)
as follows :
typedef struct H5O_info_t { unsigned long fileno; /* File number that object is */ /* located in */ haddr_t addr; /* Object address in file */ H5O_type_t type; /* Basic object type (group, */ /* dataset, etc.) */ unsigned rc; /* Reference count of object */ time_t atime; /* Access time */ time_t mtime; /* Modification time */ time_t ctime; /* Change time */ time_t btime; /* Birth time */ hsize_t num_attrs; /* # of attributes attached to object */ struct { unsigned version; /* Version number of header format in */ /* file */ unsigned nmesgs; /* Number of object header messages */ unsigned nchunks; /* Number of object header chunks */ unsigned flags; /* Object header status flags */ struct { hsize_t total; /* Total space for storing object */ /* header in file */ hsize_t meta; /* Space within header for object */ /* header metadata information */ hsize_t mesg; /* Space within header for actual */ /* message information */ hsize_t free; /* Free space within object header */ } space; struct { uint64_t present; /* Flags to indicate presence of */ /* message type in header */ uint64_t shared; /* Flags to indicate message type is */ /* shared in header */ } mesg; } hdr; /* Extra metadata storage for obj & attributes */ struct { H5_ih_info_t obj; /* v1/v2 B-tree & local/fractal heap */ /* for groups, B-tree for chunked */ /* datasets */ H5_ih_info_t attr; /* v2 B-tree & heap for attributes */ } meta_size; } H5O_info_t;
hid_t object_id |
IN: Identifier for target object |
H5O_info_t *object_info |
OUT: Buffer in which to return object information |
Release | C |
1.8.0 | Function introduced in this release. |