Enum Str 

pub enum Str<'a> {
    Int(i64),
    Bytes(&'a [u8]),
}

A stored value, read back out of a record.

The point of the two arms is that neither of them copies. An integer comes back as an integer and is written into the reply buffer as digits at the moment the reply is built, and a string comes back as a slice of the record it lives in. Y18 asks for the reply to be constructed once in wire form, and a Vec<u8> in the middle of that is the thing it is asking to remove.

Variants

Int(i64)

An int encoded value.

Bytes(&'a [u8])

Everything else, as it lies in the record.

Implementations

impl Str<'_>

pub fn len(&self) -> usize

How many bytes this value is as a string, which is what STRLEN returns.

pub fn is_empty(&self) -> bool

Whether the value is the empty string.

pub fn write_to(&self, out: &mut Vec<u8>)

Append the string form to a buffer, which for an integer is its digits.

pub fn to_vec(&self) -> Vec<u8>

The string form, copied. For the reply path prefer Str::write_to.

pub fn as_int(&self) -> Option<i64>

The integer this value is, if it is one.

A value can be an integer without being int encoded: APPEND and SETRANGE leave a raw string behind, and INCR on "10" built that way is 11 in Redis. So the bytes are parsed rather than the encoding being trusted.

pub fn digest(&self) -> u64

The XXH3 of the value’s string form, which is Redis’s DIGEST.

An int encoded value hashes its digits and not the eight bytes the record holds, because the digest a client compares against is the digest of what a client would have read.

Trait Implementations

impl<'a> Clone for Str<'a>

fn clone(&self) -> Str<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Str<'a>

impl<'a> Debug for Str<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for Str<'a>

impl<'a> PartialEq for Str<'a>

fn eq(&self, other: &Str<'a>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for Str<'a>