Struct Catalog 

pub struct Catalog { /* private fields */ }

Every table a native file holds, without the directory of any of them.

This is what opening a database reads. It is the small level of the directory, so the cost is proportional to how many tables there are rather than to how much data they hold, and a session that touches two tables of eight decodes two table directories.

The file handle is shared with every reader this hands out. Eight tables in one file is one open file descriptor, not eight, which is the other thing one file buys over a file per table.

Implementations

impl Catalog

pub fn open(path: impl AsRef<Path>) -> Result<Self>

Reads the highest valid catalog slot and nothing under it.

Errors

If the file has no valid committed catalog or a catalog pointer is out of bounds.

pub fn names(&self) -> impl ExactSizeIterator<Item = &str>

The tables in the file, in the order they were written.

pub fn len(&self) -> usize

How many tables the file holds.

pub fn is_empty(&self) -> bool

Whether the file holds no table at all, which is what Writer::empty writes and what a database somebody dropped the last table out of comes back as.

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

Opens one table by name, decoding its directory now.

Errors

If there is no table by that name, or its directory is torn or points outside the file.

Trait Implementations

impl Clone for Catalog

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Catalog

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

Formats the value using the given formatter.