Struct RangeHeader 

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

A validated Range value.

Examples

use parse_net::{range, Limits};

let h = range::parse(b"bytes=0-99, 200-299", &Limits::DEFAULT)?;
assert!(h.is_bytes());
assert_eq!(h.specs().count(), 2);

Implementations

impl<'a> RangeHeader<'a>

pub fn is_bytes(&self) -> bool

Whether the unit is bytes (case-insensitive).

Examples

use parse_net::{range, Limits};

assert!(range::parse(b"BYTES=0-1", &Limits::DEFAULT)?.is_bytes());
assert!(!range::parse(b"items=0-1", &Limits::DEFAULT)?.is_bytes());

pub const fn unit(&self) -> &'a [u8]

The range unit, as sent.

Examples

use parse_net::{range, Limits};

assert_eq!(range::parse(b"items=0-5", &Limits::DEFAULT)?.unit(), b"items");

pub fn specs(&self) -> impl Iterator<Item = RangeSpec> + use<'a>

The range specs, in request order; empty unless the unit is bytes.

Examples

use parse_net::{range, Limits, RangeSpec};

assert_eq!(range::parse(b"bytes=-1", &Limits::DEFAULT)?.specs().next(), Some(RangeSpec::Suffix(1)));
assert_eq!(range::parse(b"items=0-5", &Limits::DEFAULT)?.specs().count(), 0);

pub const fn len(&self) -> usize

The number of members in the range set, whatever the unit (so it can be nonzero when specs is empty).

Examples

use parse_net::{range, Limits};

let h = range::parse(b"items=0-5, 9-10", &Limits::DEFAULT)?;
assert_eq!((h.len(), h.specs().count()), (2, 0));

pub const fn is_empty(&self) -> bool

Whether the set is empty (never true for a parsed value).

Examples

use parse_net::{range, Limits};

assert!(!range::parse(b"bytes=0-0", &Limits::DEFAULT)?.is_empty());

Trait Implementations

impl<'a> Clone for RangeHeader<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for RangeHeader<'a>

impl<'a> Debug for RangeHeader<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for RangeHeader<'a>

impl<'a> Hash for RangeHeader<'a>

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<'a> PartialEq for RangeHeader<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for RangeHeader<'a>