Enum ContentRange

pub enum ContentRange {
    Bytes(ContentRangeBytes),
    UnboundBytes(ContentRangeUnbound),
    Unsatisfied(ContentRangeUnsatisfied),
}

HTTP Content-Range response header representation.

Variants

Bytes(ContentRangeBytes)

Regular bytes range response with status 206

UnboundBytes(ContentRangeUnbound)

Regular bytes range response with status 206

Unsatisfied(ContentRangeUnsatisfied)

Server response with status 416

Implementations

impl ContentRange

pub fn parse(header: &str) -> Option<ContentRange>

Parses Content-Range HTTP header string as per RFC 7233.

header is the HTTP Content-Range header (e.g. bytes 0-9/30).

This parser is a bit more lenient than the official RFC, it allows spaces and tabs between everything. See https://httpwg.org/specs/rfc7233.html#rfc.section.4.2

assert_eq!(ContentRange::parse("bytes 42-69/420").unwrap(),
    ContentRange::Bytes(ContentRangeBytes{first_byte: 42, last_byte: 69, complete_length: 420}));

// complete_length is unknown
assert_eq!(ContentRange::parse("bytes 42-69/*").unwrap(),
   ContentRange::UnboundBytes(ContentRangeUnbound{first_byte: 42, last_byte: 69}));

// response is unsatisfied
assert_eq!(ContentRange::parse("bytes */420").unwrap(),
  ContentRange::Unsatisfied(ContentRangeUnsatisfied{complete_length: 420}));

pub fn parse_bytes(header: &[u8]) -> Option<ContentRange>

From https://httpwg.org/specs/rfc7233.html#rfc.section.4.2 Valid bytes responses: Content-Range: bytes 42-1233/1234 Content-Range: bytes 42-1233/* Content-Range: bytes */1233

  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

Same as parse but parses directly from the byte array

Trait Implementations

impl Clone for ContentRange

fn clone(&self) -> ContentRange

Returns a copy 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

Formats the value using the given formatter.

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 Copy for ContentRange

impl Eq for ContentRange

impl StructuralPartialEq for ContentRange