Struct StagedGroup 

pub struct StagedGroup<'a> { /* private fields */ }

A group that exists only as a staged edit, handed to Group::create_group_with’s closure so attributes can be set on a group that is not yet committed (and so has no resolvable header to hang a Group handle off).

Every method stages; nothing is written until File::commit, and a staged object is not resolvable by name until then.

The closure holding this records into a buffer rather than into the file’s writable session, so nothing is locked while it runs. The recorded operations are applied together when it returns, which is also why a staged object is not resolvable until File::commit.

Implementations

impl StagedGroup<'_>

pub fn set_attr(&mut self, name: &str, value: AttrValue) -> &mut Self

Stage an attribute on this group, applied with its creation on File::commit.

pub fn create_group(&mut self, name: &str) -> &mut Self

Stage an empty subgroup of this group.

To configure it in the same commit, use create_group_with.

pub fn create_group_with( &mut self, name: &str, build: impl FnOnce(&mut StagedGroup<'_>), ) -> &mut Self

Stage a subgroup of this group, configured through build.

pub fn create_dataset( &mut self, name: &str, build: impl FnOnce(&mut DatasetBuilder), ) -> &mut Self

Stage a dataset in this group, configured through build.