Enum Command 

pub enum Command<'a> {
    Get {
        key: &'a [u8],
    },
    Gets {
        keys: Vec<&'a [u8]>,
    },
    Set {
        key: &'a [u8],
        flags: u32,
        exptime: u32,
        data: &'a [u8],
    },
    Add {
        key: &'a [u8],
        flags: u32,
        exptime: u32,
        data: &'a [u8],
    },
    Replace {
        key: &'a [u8],
        flags: u32,
        exptime: u32,
        data: &'a [u8],
    },
    Cas {
        key: &'a [u8],
        flags: u32,
        exptime: u32,
        data: &'a [u8],
        cas_unique: u64,
    },
    Delete {
        key: &'a [u8],
    },
    FlushAll,
    Version,
    Quit,
    Incr {
        key: &'a [u8],
        delta: u64,
        noreply: bool,
    },
    Decr {
        key: &'a [u8],
        delta: u64,
        noreply: bool,
    },
    Append {
        key: &'a [u8],
        data: &'a [u8],
        noreply: bool,
    },
    Prepend {
        key: &'a [u8],
        data: &'a [u8],
        noreply: bool,
    },
}

A parsed Memcache command with references to the original buffer.

Commands are parsed with zero-copy semantics where possible.

Variants

Get

GET command

Fields

key: &'a [u8]

Gets

Multi-GET command

Fields

keys: Vec<&'a [u8]>

Set

SET command

Fields

key: &'a [u8]

flags: u32

exptime: u32

data: &'a [u8]

Add

ADD command - store only if key doesn’t exist

Fields

key: &'a [u8]

flags: u32

exptime: u32

data: &'a [u8]

Replace

REPLACE command - store only if key exists

Fields

key: &'a [u8]

flags: u32

exptime: u32

data: &'a [u8]

Cas

CAS (compare-and-swap) command

Fields

key: &'a [u8]

flags: u32

exptime: u32

data: &'a [u8]

cas_unique: u64

Delete

DELETE command

Fields

key: &'a [u8]

FlushAll

FLUSH_ALL command

Version

VERSION command

Quit

QUIT command

Incr

INCR command - increment numeric value

Fields

key: &'a [u8]

delta: u64

noreply: bool

Decr

DECR command - decrement numeric value

Fields

key: &'a [u8]

delta: u64

noreply: bool

Append

APPEND command - append data to existing value

Fields

key: &'a [u8]

data: &'a [u8]

noreply: bool

Prepend

PREPEND command - prepend data to existing value

Fields

key: &'a [u8]

data: &'a [u8]

noreply: bool

Implementations

impl<'a> Command<'a>

pub fn parse(buffer: &'a [u8]) -> Result<(Self, usize), ParseError>

Parse a command from a byte buffer using default options.

Returns the parsed command and the number of bytes consumed.

Zero-copy

The returned command contains references to the input buffer for keys and data, avoiding allocation in the hot path.

pub fn parse_with_options( buffer: &'a [u8], options: &ParseOptions, ) -> Result<(Self, usize), ParseError>

Parse a command from a byte buffer with custom options.

This allows configuring DoS protection limits like maximum key size, value size, and line length.

pub fn name(&self) -> &'static str

Returns the command name as a string.

pub fn is_quit(&self) -> bool

Returns true if this command should close the connection.

Trait Implementations

impl<'a> Clone for Command<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Command<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for Command<'a>

fn eq(&self, other: &Command<'a>) -> 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<'a> Eq for Command<'a>

impl<'a> StructuralPartialEq for Command<'a>