Struct BytesRange 

pub struct BytesRange(/* private fields */);

BytesRange(offset, size) carries a range of content.

BytesRange implements ToString which can be used as Range HTTP header directly.

<unit> should always be bytes.

Range: bytes=<range-start>-
Range: bytes=<range-start>-<range-end>

Notes

We don’t support tailing read like Range: bytes=-<range-end>

Implementations

impl BytesRange

pub fn new(offset: u64, size: Option<u64>) -> Self

Create a new BytesRange

It better to use BytesRange::from(1024..2048) to construct.

Note

The behavior for None and Some of size is different.

• size=None => bytes=<offset>-, read from <offset> until the end
• size=Some(1024) => bytes=<offset>-<offset + 1024>, read 1024 bytes starting from the <offset>

pub fn offset(&self) -> u64

Get offset of BytesRange.

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

Get size of BytesRange.

pub fn advance(&mut self, n: u64)

Advance the range by n bytes.

Panics

Panic if input n is larger than the size of the range.

pub fn is_full(&self) -> bool

Check if this range is full of this content.

If this range is full, we don’t need to specify it in http request.

pub fn to_header(&self) -> String

Convert bytes range into Range header.

pub fn to_range(&self) -> impl RangeBounds<u64>

Convert bytes range into rust range.

Trait Implementations

impl Clone for BytesRange

fn clone(&self) -> BytesRange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BytesRange

impl Debug for BytesRange

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

Formats the value using the given formatter.

impl Default for BytesRange

fn default() -> BytesRange

Returns the “default value” for a type.

impl Display for BytesRange

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

Formats the value using the given formatter.

impl Eq for BytesRange

impl<T> From<T> for BytesRange

where T: RangeBounds<u64>,

fn from(range: T) -> Self

Converts to this type from the input type.

impl FromStr for BytesRange

type Err = Error

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Self>

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

impl PartialEq for BytesRange

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for BytesRange