Struct ContentIdPrefix 

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

The short form of a post or comment id: the first eight hex digits of its UUID, e.g. 7ad26ccd.

Long lists of ids (a scheduling thread naming every eligible proposal) read far better short, and people already write them that way. A prefix is not an id: it may match nothing, or — rarely, at 32 bits over the whole content table — more than one row. Only the server can say which, so this type claims nothing beyond its shape, and every lookup must be ready for an ambiguous answer. ContentIdPrefix::bounds gives the inclusive UUID range it covers, for an index-friendly BETWEEN.

Parsing is lenient on case and surrounding whitespace; the canonical form is lowercase. It is exactly eight digits and nothing else: a truncated or mangled full UUID is an error, never quietly read as the prefix it starts with.

Implementations

impl ContentIdPrefix

pub const LEN: usize = 8

Number of hex digits in a short id

pub fn of(id: &Uuid) -> Self

The short id of a full UUID

pub fn bounds(&self) -> (Uuid, Uuid)

The lowest and highest UUIDs with this prefix, inclusive

pub fn matches(&self, id: &Uuid) -> bool

true when id starts with this prefix

Trait Implementations

impl Clone for ContentIdPrefix

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ContentIdPrefix

impl Debug for ContentIdPrefix

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContentIdPrefix

fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for ContentIdPrefix

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

Formats the value using the given formatter.

impl Eq for ContentIdPrefix

impl From<ContentId> for ContentIdPrefix

fn from(id: ContentId) -> Self

Converts to this type from the input type.

impl From<ContentIdPrefix> for ContentRef

fn from(prefix: ContentIdPrefix) -> Self

Converts to this type from the input type.

impl FromStr for ContentIdPrefix

type Err = ContentIdPrefixError

The associated error which can be returned from parsing.

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

Parses a string s to return a value of this type.

impl Hash for ContentIdPrefix

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 Ord for ContentIdPrefix

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for ContentIdPrefix

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for ContentIdPrefix

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for ContentIdPrefix

fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ContentIdPrefix

impl TryFrom<String> for ContentIdPrefix

type Error = ContentIdPrefixError

The type returned in the event of a conversion error.

fn try_from(s: String) -> Result<Self, Self::Error>

Performs the conversion.