Struct hdf5::File

#[repr(transparent)]pub struct File(_);

HDF5 file object.

Implementations

impl File

pub fn open<P: AsRef<Path>>(filename: P) -> Result<Self>

Opens a file as read-only, file must exist.

pub fn open_rw<P: AsRef<Path>>(filename: P) -> Result<Self>

Opens a file as read/write, file must exist.

pub fn create<P: AsRef<Path>>(filename: P) -> Result<Self>

Creates a file, truncates if exists.

pub fn create_excl<P: AsRef<Path>>(filename: P) -> Result<Self>

Creates a file, fails if exists.

pub fn append<P: AsRef<Path>>(filename: P) -> Result<Self>

Opens a file as read/write if exists, creates otherwise.

pub fn open_as<P: AsRef<Path>>(filename: P, mode: OpenMode) -> Result<Self>

Opens a file in a given mode.

pub fn with_options() -> FileBuilder

Opens a file with custom file-access and file-creation options.

pub fn size(&self) -> u64

Returns the file size in bytes (or 0 if the file handle is invalid).

pub fn free_space(&self) -> u64

Returns the free space in the file in bytes (or 0 if the file handle is invalid).

pub fn is_read_only(&self) -> bool

Returns true if the file was opened in a read-only mode.

pub fn userblock(&self) -> u64

Returns the userblock size in bytes (or 0 if the file handle is invalid).

pub fn flush(&self) -> Result<()>

Flushes the file to the storage medium.

pub fn close(self)

Closes the file and invalidates all open handles for contained objects.

pub fn access_plist(&self) -> Result<FileAccess>

Returns a copy of the file access property list.

pub fn fapl(&self) -> Result<FileAccess>

A short alias for access_plist().

pub fn create_plist(&self) -> Result<FileCreate>

Returns a copy of the file creation property list.

pub fn fcpl(&self) -> Result<FileCreate>

A short alias for create_plist().

Methods from Deref<Target = Group>

pub fn len(&self) -> u64

Returns the number of objects in the container (or 0 if the container is invalid).

pub fn is_empty(&self) -> bool

Returns true if the container has no linked objects (or if the container is invalid).

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

Create a new group in a file or group.

pub fn group(&self, name: &str) -> Result<Self>

Opens an existing group in a file or group.

pub fn link_soft(&self, src: &str, dst: &str) -> Result<()>

Creates a soft link. Note: src and dst are relative to the current object.

pub fn link_hard(&self, src: &str, dst: &str) -> Result<()>

Creates a hard link. Note: src and dst are relative to the current object.

pub fn relink(&self, name: &str, path: &str) -> Result<()>

Relinks an object. Note: name and path are relative to the current object.

pub fn unlink(&self, name: &str) -> Result<()>

Removes a link to an object from this file or group.

pub fn link_exists(&self, name: &str) -> bool

Check if a link with a given name exists in this file or group.

pub fn new_dataset<T: H5Type>(&self) -> DatasetBuilder<T>

Instantiates a new dataset builder.

pub fn dataset(&self, name: &str) -> Result<Dataset>

Opens an existing dataset in the file or group.

pub fn member_names(&self) -> Result<Vec<String>>

Returns names of all the members in the group, non-recursively.

Trait Implementations

impl Clone for File

fn clone(&self) -> File

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for File

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Deref for File

type Target = Group

The resulting type after dereferencing.

fn deref(&self) -> &Group

Dereferences the value.