Struct ReadRange 

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

Define read ranges for use with ReadObject.

Example: read the first 100 bytes of an object

let response = client
    .read_object("projects/_/buckets/my-bucket", "my-object")
    .set_read_range(ReadRange::head(100))
    .send()
    .await?;
println!("response details={response:?}");

Cloud Storage supports reading a portion of an object. These portions can be specified as offsets from the beginning of the object, offsets from the end of the object, or as ranges with a starting and ending bytes. This type defines a type-safe interface to represent only valid ranges.

Implementations

impl ReadRange

pub fn all() -> Self

Returns a range representing all the bytes in the object.

Example

let response = client
    .read_object("projects/_/buckets/my-bucket", "my-object")
    .set_read_range(ReadRange::all())
    .send()
    .await?;
println!("response details={response:?}");

pub fn offset(offset: u64) -> Self

Returns a range representing the bytes starting at offset.

Example

let response = client
    .read_object("projects/_/buckets/my-bucket", "my-object")
    .set_read_range(ReadRange::offset(1_000_000))
    .send()
    .await?;
println!("response details={response:?}");

pub fn tail(count: u64) -> Self

Returns a range representing the last count bytes of the object.

Example

let response = client
    .read_object("projects/_/buckets/my-bucket", "my-object")
    .set_read_range(ReadRange::tail(100))
    .send()
    .await?;
println!("response details={response:?}");

pub fn head(count: u64) -> Self

Returns a range representing the first count bytes of the object.

Example

let response = client
    .read_object("projects/_/buckets/my-bucket", "my-object")
    .set_read_range(ReadRange::head(100))
    .send()
    .await?;
println!("response details={response:?}");

pub fn segment(offset: u64, count: u64) -> Self

Returns a range representing the count bytes starting at offset.

Example

let response = client
    .read_object("projects/_/buckets/my-bucket", "my-object")
    .set_read_range(ReadRange::segment(1_000_000, 1_000))
    .send()
    .await?;
println!("response details={response:?}");

Trait Implementations

impl Clone for ReadRange

fn clone(&self) -> ReadRange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReadRange

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

Formats the value using the given formatter.