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. |