Struct ArgvBorrowed 

pub struct ArgvBorrowed<'a> { /* private fields */ }

A parsed command’s argument vector that borrows its bytes from a contiguous input buffer.

Unlike Argv, which packs all argument bytes into a fresh Vec<u8>, ArgvBorrowed stores only a (start, end) table over the original buffer. get(i) returns &input[s..e], so no copy happens on the parse → dispatch path. Calls that need to outlive the buffer (cross-shard, MULTI queue, AOF) use into_owned to convert to Argv.

A5 (2026-06-20): the range table is a (u32, u32) × 4 inline + heap-spill InlineRanges. Commands with ≤4 args (PING/GET/SET/INCR/MGET ≤4 keys — the vast majority of the -c1 hot mix) pay zero malloc/free for the ranges. H1 (perf c2c) confirmed libc cfree on the per-request Vec allocation showed up in cross-thread contention; the inline tier removes that source.

Implementations

impl<'a> ArgvBorrowed<'a>

pub fn new(input: &'a [u8]) -> ArgvBorrowed<'a>

An empty argv that will read arg bytes from input.

pub fn with_capacity(input: &'a [u8], argc: usize) -> ArgvBorrowed<'a>

An empty argv, pre-sizing ranges for argc args.

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 into the original input, or None.

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 into the original input.

pub fn into_owned(self) -> Argv

Materialise an owned Argv — copies arg bytes into a fresh buffer. Used at any handoff juncture (cross-shard dispatch, MULTI queue, AOF logging) that needs to outlive the original input buffer.

Trait Implementations

impl ArgvView for ArgvBorrowed<'_>

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<'a> Clone for ArgvBorrowed<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ArgvBorrowed<'a>

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

Formats the value using the given formatter.

impl Index<usize> for ArgvBorrowed<'_>

type Output = [u8]

The returned type after indexing.

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

Performs the indexing (container[index]) operation.

impl PartialEq<Vec<Vec<u8>>> for ArgvBorrowed<'_>

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.