Struct ContentRange

pub struct ContentRange { /* private fields */ }

Content-Range, described in RFC7233

ABNF

Content-Range       = byte-content-range
                    / other-content-range

byte-content-range  = bytes-unit SP
                      ( byte-range-resp / unsatisfied-range )

byte-range-resp     = byte-range "/" ( complete-length / "*" )
byte-range          = first-byte-pos "-" last-byte-pos
unsatisfied-range   = "*/" complete-length

complete-length     = 1*DIGIT

other-content-range = other-range-unit SP other-range-resp
other-range-resp    = *CHAR

Example

use rama_http_headers::ContentRange;

// 100 bytes (included byte 199), with a full length of 3,400
let cr = ContentRange::bytes(100..200, 3400).unwrap();

Implementations

impl ContentRange

pub fn bytes( range: impl RangeBounds<u64>, complete_length: impl Into<Option<u64>>, ) -> Result<ContentRange, InvalidContentRange>

Construct a new Content-Range: bytes .. header.

pub fn unsatisfied_bytes(complete_length: u64) -> ContentRange

Create a new ContentRange stating the range could not be satisfied.

The passed argument is the complete length of the entity.

pub fn bytes_range(&self) -> Option<(u64, u64)>

Get the byte range if satisified.

Note that these byte ranges are inclusive on both ends.

pub fn bytes_len(&self) -> Option<u64>

Get the bytes complete length if available.

Trait Implementations

impl Clone for ContentRange

fn clone(&self) -> ContentRange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContentRange

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

Formats the value using the given formatter.

impl HeaderDecode for ContentRange

fn decode<'i, I>(values: &mut I) -> Result<ContentRange, Error>

where I: Iterator<Item = &'i HeaderValue>,

Decode this type from an iterator of HeaderValues.

impl HeaderEncode for ContentRange

fn encode<E>(&self, values: &mut E)

where E: Extend<HeaderValue>,

Encode this type to a HeaderValue, and add it to a container which has HeaderValue type as each element.

fn encode_to_value(&self) -> HeaderValue

Encode this header to HeaderValue.

impl PartialEq for ContentRange

fn eq(&self, other: &ContentRange) -> 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 TypedHeader for ContentRange

fn name() -> &'static HeaderName

The name of this header.

impl StructuralPartialEq for ContentRange