Struct Span 

pub struct Span {
    pub start: u32,
    pub end: u32,
}

A byte range of a message head: start..end, as offsets into RawHead::bytes (or into the input of a stateless parser).

Offsets are u32 because every budget in Limits is capped at 16 MiB, so a head can never be longer. Spans stay valid when the head bytes are moved or copied, which is what makes a head cheap to copy into a passport (RequestHead::copy_into).

Examples

use http_net::Span;

let head = b"GET / HTTP/1.1\r\n";
let method = Span { start: 0, end: 3 };
assert_eq!(method.get(head), b"GET");
assert_eq!(method.len(), 3);
// Out of range: an empty slice, never a panic.
assert_eq!(Span { start: 10, end: 99 }.get(head), b"");

Fields

start: u32

The first byte.

end: u32

One past the last byte.

Implementations

impl Span

pub fn get<'b>(&self, head: &'b [u8]) -> &'b [u8]

The bytes of head the span covers; empty when the span lies outside head or is reversed.

Examples

let span = http_net::Span { start: 4, end: 5 };
assert_eq!(span.get(b"GET / HTTP/1.1"), b"/");

pub const fn len(&self) -> u32

The span’s length in bytes (0 for a reversed span).

Examples

assert_eq!(http_net::Span { start: 2, end: 7 }.len(), 5);

pub const fn is_empty(&self) -> bool

Whether the span covers no bytes.

Examples

assert!(http_net::Span::default().is_empty());

Trait Implementations

impl Clone for Span

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 Span

impl Debug for Span

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

Formats the value using the given formatter.

impl Default for Span

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Span

impl Hash for Span

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 PartialEq for Span

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Span