Struct CollectionId

pub struct CollectionId(/* private fields */);

An identifier for a collection.

Collection identifiers are a short string that uniquely identify a collection inside a storage. They are based on the href of a collection, which never changes. A CollectionId is intended as a more human-friendly substitute for collection hrefs, and an attribute which is more storage-agnostic.

The following limitations exist, given that such values would produce ambiguous results with the implementation of VdirStorage, CalDavStorage, and CardDavStorage:

• A CollectionId cannot contain a / (slash)
• A CollectionId cannot be exactly .. (double period).
• A CollectionId cannot be exactly . (a single period).

Instances of CollectionId always contain previously validated data. Instances are internally reference counted and cheap to clone.

Example

let collection_id: CollectionId = "personal".parse().unwrap();

Trait Implementations

impl AsRef<str> for CollectionId

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for CollectionId

fn clone(&self) -> CollectionId

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CollectionId

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

Formats the value using the given formatter.

impl Display for CollectionId

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

Formats the value using the given formatter.

impl FromStr for CollectionId

fn from_str(s: &str) -> Result<Self, Self::Err>

Allocates a new CollectionId with the input data.

type Err = CollectionIdError

The associated error which can be returned from parsing.

impl Hash for CollectionId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CollectionId

fn eq(&self, other: &CollectionId) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for CollectionId

impl StructuralPartialEq for CollectionId