Struct foundationdb::Subspace

pub struct Subspace { /* private fields */ }

Represents a well-defined region of keyspace in a FoundationDB database

It provides a convenient way to use FoundationDB tuples to define namespaces for different categories of data. The namespace is specified by a prefix tuple which is prepended to all tuples packed by the subspace. When unpacking a key with the subspace, the prefix tuple will be removed from the result.

As a best practice, API clients should use at least one subspace for application data. For general guidance on subspace usage, see the Subspaces section of the Developer Guide.

Implementations

impl Subspace

pub fn all() -> Subspace

all returns the Subspace corresponding to all keys in a FoundationDB database.

pub fn from_bytes(bytes: &[u8]) -> Self

from_bytes returns a new Subspace from the provided bytes.

pub fn subspace<T: Encode>(&self, t: T) -> Self

Returns a new Subspace whose prefix extends this Subspace with a given tuple encodable.

pub fn bytes(&self) -> &[u8]

bytes returns the literal bytes of the prefix of this Subspace.

pub fn pack<T: Encode>(&self, t: T) -> Vec<u8>

Returns the key encoding the specified Tuple with the prefix of this Subspace prepended.

pub fn unpack<T: Decode>(&self, key: &[u8]) -> Result<T>

unpack returns the Tuple encoded by the given key with the prefix of this Subspace removed. unpack will return an error if the key is not in this Subspace or does not encode a well-formed Tuple.

pub fn is_start_of(&self, key: &[u8]) -> bool

is_start_of returns true if the provided key starts with the prefix of this Subspace, indicating that the Subspace logically contains the key.

pub fn range(&self) -> (Vec<u8>, Vec<u8>)

range returns first and last key of given Subspace

Trait Implementations

impl Clone for Subspace

fn clone(&self) -> Subspace

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Subspace

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

Formats the value using the given formatter.

impl<E: Encode> From<E> for Subspace

fn from(e: E) -> Self

Converts to this type from the input type.