[−][src]Enum hyperx::header::ByteRangeSpec
Each Range::Bytes
header can contain one or more ByteRangeSpecs
.
Each ByteRangeSpec
defines a range of bytes to fetch
Variants
Get all bytes between x and y ("x-y")
AllFrom(u64)
Get all bytes starting from x ("x-")
Last(u64)
Get last x bytes ("-x")
Implementations
impl ByteRangeSpec
[src]
pub fn to_satisfiable_range(&self, full_length: u64) -> Option<(u64, u64)>
[src]
Given the full length of the entity, attempt to normalize the byte range into an satisfiable end-inclusive (from, to) range.
The resulting range is guaranteed to be a satisfiable range within the bounds
of 0 <= from <= to < full_length
.
If the byte range is deemed unsatisfiable, None
is returned.
An unsatisfiable range is generally cause for a server to either reject
the client request with a 416 Range Not Satisfiable
status code, or to
simply ignore the range header and serve the full entity using a 200 OK
status code.
This function closely follows RFC 7233 section 2.1. As such, it considers ranges to be satisfiable if they meet the following conditions:
If a valid byte-range-set includes at least one byte-range-spec with a first-byte-pos that is less than the current length of the representation, or at least one suffix-byte-range-spec with a non-zero suffix-length, then the byte-range-set is satisfiable. Otherwise, the byte-range-set is unsatisfiable.
The function also computes remainder ranges based on the RFC:
If the last-byte-pos value is absent, or if the value is greater than or equal to the current length of the representation data, the byte range is interpreted as the remainder of the representation (i.e., the server replaces the value of last-byte-pos with a value that is one less than the current length of the selected representation).
Trait Implementations
impl Clone for ByteRangeSpec
[src]
pub fn clone(&self) -> ByteRangeSpec
[src]
pub fn clone_from(&mut self, source: &Self)
1.0.0[src]
impl Debug for ByteRangeSpec
[src]
impl Display for ByteRangeSpec
[src]
impl FromStr for ByteRangeSpec
[src]
type Err = Error
The associated error which can be returned from parsing.
pub fn from_str(s: &str) -> Result<ByteRangeSpec>
[src]
impl PartialEq<ByteRangeSpec> for ByteRangeSpec
[src]
pub fn eq(&self, other: &ByteRangeSpec) -> bool
[src]
pub fn ne(&self, other: &ByteRangeSpec) -> bool
[src]
impl StructuralPartialEq for ByteRangeSpec
[src]
Auto Trait Implementations
impl RefUnwindSafe for ByteRangeSpec
[src]
impl Send for ByteRangeSpec
[src]
impl Sync for ByteRangeSpec
[src]
impl Unpin for ByteRangeSpec
[src]
impl UnwindSafe for ByteRangeSpec
[src]
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T> ToString for T where
T: Display + ?Sized,
[src]
T: Display + ?Sized,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,