Struct Table 

pub struct Table<T> { /* private fields */ }

The sessions this instance is holding.

Implementations

impl<T> Table<T>

pub fn new() -> Self

An empty table.

pub fn len(&self) -> usize

How many sessions are open.

pub fn is_empty(&self) -> bool

Whether this instance is holding nothing, which is half of concept 8’s exit rule.

pub fn iter(&self) -> impl Iterator<Item = &T>

Everything held, in the order it was opened.

pub fn iter_mut(&mut self) -> impl Iterator<Item = &mut T>

Everything held, mutably.

pub fn insert(&mut self, container: &Path, held: T) -> Result<()>

Take a session in, keyed on what container is now.

Errors

Where the container’s identity cannot be established.

pub fn find_mut(&mut self, container: &Path) -> Option<&mut T>

The session already open on this container, if there is one.

A container that is not there matches nothing rather than failing: an invocation naming a path that does not exist has a different problem, and it is not this function’s to report.

pub fn refresh(&mut self, container: &Path)

Re-read the identity of a session’s container.

Called after a write-back, which renamed a new file over the container and so gave it a new inode. Without this the entry keeps matching by path and stops matching by identity, which quietly loses the hard-link half of the guarantee for the rest of the session.

A container that has gone keeps the identity it had. There is nothing better to record, and the path arm still finds the session so that the person can be told.

pub fn remove(&mut self, container: &Path) -> Option<T>

Drop a session and hand it back.

pub fn drain(&mut self) -> impl Iterator<Item = T> + '_

Take everything, for the shutdown that closes each in turn.

Trait Implementations

impl<T: Debug> Debug for Table<T>

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

Formats the value using the given formatter.

impl<T> Default for Table<T>

fn default() -> Self

Returns the “default value” for a type.