Enum hyper::header::Range [] [src]

pub enum Range {

Range header, defined in RFC7233

The "Range" header field on a GET request modifies the method semantics to request transfer of only one or more subranges of the selected representation data, rather than the entire selected representation data.


Range = byte-ranges-specifier / other-ranges-specifier
other-ranges-specifier = other-range-unit "=" other-range-set
other-range-set = 1*VCHAR

bytes-unit = "bytes"

byte-ranges-specifier = bytes-unit "=" byte-range-set
byte-range-set = 1#(byte-range-spec / suffix-byte-range-spec)
byte-range-spec = first-byte-pos "-" [last-byte-pos]
first-byte-pos = 1*DIGIT
last-byte-pos = 1*DIGIT

Example values

  • bytes=1000-
  • bytes=-2000
  • bytes=0-1,30-40
  • bytes=0-10,20-90,-100
  • custom_unit=0-123
  • custom_unit=xxx-yyy


use hyper::header::{Headers, Range, ByteRangeSpec};

let mut headers = Headers::new();
    vec![ByteRangeSpec::FromTo(1, 100), ByteRangeSpec::AllFrom(200)]

headers.set(Range::Unregistered("letters".to_owned(), "a-f".to_owned()));
use hyper::header::{Headers, Range};

let mut headers = Headers::new();
headers.set(Range::bytes(1, 100));

headers.set(Range::bytes_multi(vec![(1, 100), (200, 300)]));


Byte range

Custom range, with unit not registered at IANA (other-range-unit: String , other-range-set: String)


impl Range


Get the most common byte range header ("bytes=from-to")


Get byte range header with multiple subranges ("bytes=from1-to1,from2-to2,fromX-toX")

Trait Implementations

impl PartialEq for Range


This method tests for self and other values to be equal, and is used by ==. Read more


This method tests for !=.

impl Clone for Range


Returns a copy of the value. Read more


Performs copy-assignment from source. Read more

impl Debug for Range


Formats the value using the given formatter.

impl Display for Range


Formats the value using the given formatter. Read more

impl FromStr for Range

The associated error which can be returned from parsing.


Parses a string s to return a value of this type. Read more

impl Header for Range


Returns the name of the header field this belongs to. Read more


Parse a header from a raw stream of bytes. Read more


Format a header to outgoing stream. Read more