Struct Argv 

pub struct Argv { /* private fields */ }

A parsed command’s argument vector.

Stored in two allocations — all argument bytes concatenated in buf, with ends[i] the end offset of argument i — instead of the N+1 a Vec<Vec<u8>> needs (one outer Vec plus one per argument). Parsing a SET drops from 4 allocations to 2. It is Send (two Vecs), so the thread-per-core runtime still forwards it across cores by value.

Index/get/first/iter return &[u8] argument slices. It compares equal to a Vec<Vec<u8>> of the same arguments, so call sites and tests read naturally.

Implementations

impl Argv

pub fn with_capacity(argc: usize, bytes: usize) -> Self

An empty argv, pre-sizing for argc args totalling bytes bytes.

pub fn clear(&mut self)

Drop all args while keeping the buf + ends capacity. Used by the reactor’s per-command scratch Argv: parse_command_into clears then refills, so the hot path’s malloc rate drops to ~0.

pub fn reserve_for(&mut self, argc: usize, bytes: usize)

Reserve room for argc args totalling bytes bytes on top of what is already there (no shrink).

pub fn push(&mut self, arg: &[u8])

Append one argument.

pub fn len(&self) -> usize

Number of arguments.

pub fn is_empty(&self) -> bool

Whether there are no arguments.

pub fn get(&self, i: usize) -> Option<&[u8]>

Argument i as a byte slice, or None if out of range.

pub fn first(&self) -> Option<&[u8]>

The first argument (the command name), or None if empty.

pub fn iter(&self) -> impl Iterator<Item = &[u8]>

Iterate the arguments as byte slices.

Trait Implementations

impl ArgvView for Argv

fn len(&self) -> usize

Number of arguments.

fn get(&self, i: usize) -> Option<&[u8]>

Argument i as a byte slice, or None if out of range.

fn is_empty(&self) -> bool

Whether there are no arguments.

fn first(&self) -> Option<&[u8]>

The first argument (the command name), or None if empty.

fn iter(&self) -> ArgvIter<'_, Self>

where Self: Sized,

Iterate the arguments as byte slices.

fn copy_into(&self, out: &mut Argv)

Clear out and refill it with this view’s arguments. out keeps its buffer capacity across the clear, so refilling a recycled Argv (see crate::ArgvPool) is allocation-free in steady state. Object-safe (no Self: Sized bound).

fn to_argv(&self) -> Argv

Materialise an owned Argv — copies arg bytes into a fresh buffer. Used at handoff junctures (cross-shard dispatch, MULTI queue, AOF logging) that need to outlive the original input buffer. Object-safe (no Self: Sized bound) so callers can hold &dyn ArgvView.

impl Clone for Argv

fn clone(&self) -> Argv

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Argv

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

Formats the value using the given formatter.

impl Default for Argv

fn default() -> Argv

Returns the “default value” for a type.

impl Eq for Argv

impl From<Vec<Vec<u8>>> for Argv

Build from a vec-of-vecs (test/embedding convenience; the wire path uses parse_command, which builds an Argv directly without the intermediate allocations).

fn from(v: Vec<Vec<u8>>) -> Self

Converts to this type from the input type.

impl Index<usize> for Argv

type Output = [u8]

The returned type after indexing.

fn index(&self, i: usize) -> &[u8]

Performs the indexing (container[index]) operation.

impl PartialEq for Argv

fn eq(&self, other: &Argv) -> 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 PartialEq<Vec<Vec<u8>>> for Argv

Compare to a Vec<Vec<u8>> of the same arguments (keeps call sites + tests that build the expected value as a vec-of-vecs readable).

fn eq(&self, other: &Vec<Vec<u8>>) -> 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.