h5_ls: List HDF5 Objects

In h5lite: Simplified 'HDF5' Interface

List HDF5 Objects

Description

Lists the names of objects (datasets and groups) within an HDF5 file or group.

Usage

h5_ls(file, name = "/", recursive = TRUE, full.names = FALSE, scales = FALSE)

Arguments

file	The path to the HDF5 file.
name	The group path to start listing from. Defaults to the root group (/).
recursive	If TRUE (default), lists all objects found recursively under name. If FALSE, lists only the immediate children.
full.names	If TRUE, the full paths from the file's root are returned. If FALSE (the default), names are relative to name.
scales	If TRUE, also returns datasets that are dimensions scales for other datasets.

Value

A character vector of object names. If name is / (the default), the paths are relative to the root of the file. If name is another group, the paths are relative to that group (unless full.names = TRUE).

See Also

h5_attr_names(), h5_str()

Examples

file <- tempfile(fileext = ".h5")
h5_create_group(file, "foo/bar")
h5_write(1:5, file, "foo/data")

# List everything recursively
h5_ls(file)

# List only top-level objects
h5_ls(file, recursive = FALSE)

# List relative to a sub-group
h5_ls(file, "foo")

unlink(file)

h5lite documentation built on May 19, 2026, 1:07 a.m.