Struct re_sdk::external::arrow2::offset::Offsets

pub struct Offsets<O>(Vec<O>)
where
    O: Offset;

A wrapper type of Vec<O> representing the invariants of Arrow’s offsets. It is guaranteed to (sound to assume that):

• every element is >= 0
• element at position i is >= than element at position i-1.

Tuple Fields

0: Vec<O>

Implementations

impl<O> Offsets<O>

where O: Offset,

pub fn new() -> Offsets<O>

Returns an empty Offsets (i.e. with a single element, the zero)

pub fn new_zeroed(length: usize) -> Offsets<O>

Returns an Offsets whose all lengths are zero.

pub fn try_from_iter<I>(iter: I) -> Result<Offsets<O>, Error>

where I: IntoIterator<Item = usize>,

Creates a new Offsets from an iterator of lengths

pub fn with_capacity(capacity: usize) -> Offsets<O>

Returns a new Offsets with a capacity, allocating at least capacity + 1 entries.

pub fn capacity(&self) -> usize

Returns the capacity of Offsets.

pub fn reserve(&mut self, additional: usize)

Reserves additional entries.

pub fn shrink_to_fit(&mut self)

Shrinks the capacity of self to fit.

pub fn try_push(&mut self, length: O) -> Result<(), Error>

Pushes a new element with a given length.

Error

This function errors iff the new last item is larger than what O supports.

Panic

This function asserts that length > 0.

pub fn try_push_usize(&mut self, length: usize) -> Result<(), Error>

Pushes a new element with a given length.

Error

This function errors iff the new last item is larger than what O supports.

Implementation

This function:

• checks that this length does not overflow

pub unsafe fn new_unchecked(offsets: Vec<O>) -> Offsets<O>

Returns Offsets assuming that offsets fulfills its invariants

Safety

This is safe iff the invariants of this struct are guaranteed in offsets.

pub fn last(&self) -> &O

Returns the last offset of this container.

pub fn start_end(&self, index: usize) -> (usize, usize)

Returns a range (start, end) corresponding to the position index

Panic

This function panics iff index >= self.len()

pub unsafe fn start_end_unchecked(&self, index: usize) -> (usize, usize)

Returns a range (start, end) corresponding to the position index

Safety

index must be < self.len()

pub fn len_proxy(&self) -> usize

Returns the length an array with these offsets would be.

pub fn len(&self) -> usize

Returns the number of offsets in this container.

pub fn as_slice(&self) -> &[O]

Returns the byte slice stored in this buffer

pub fn pop(&mut self) -> Option<O>

Pops the last element

pub fn extend_constant(&mut self, additional: usize)

Extends itself with additional elements equal to the last offset. This is useful to extend offsets with empty values, e.g. for null slots.

pub fn try_from_lengths<I>(lengths: I) -> Result<Offsets<O>, Error>

where I: Iterator<Item = usize>,

Try to create a new Offsets from a sequence of lengths

Errors

This function errors iff this operation overflows for the maximum value of O.

pub fn try_extend_from_lengths<I>(&mut self, lengths: I) -> Result<(), Error>

where I: Iterator<Item = usize>,

Try extend from an iterator of lengths

Errors

This function errors iff this operation overflows for the maximum value of O.

pub fn try_extend_from_self(&mut self, other: &Offsets<O>) -> Result<(), Error>

Extends itself from another Offsets

Errors

This function errors iff this operation overflows for the maximum value of O.

pub fn try_extend_from_slice( &mut self, other: &OffsetsBuffer<O>, start: usize, length: usize ) -> Result<(), Error>

Extends itself from another Offsets sliced by start, length

Errors

This function errors iff this operation overflows for the maximum value of O.

pub fn into_inner(self) -> Vec<O>

Returns the inner Vec.

Trait Implementations

impl<O> Clone for Offsets<O>

where O: Clone + Offset,

fn clone(&self) -> Offsets<O>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<O> Debug for Offsets<O>

where O: Debug + Offset,

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

Formats the value using the given formatter.

impl<O> Default for Offsets<O>

where O: Offset,

fn default() -> Offsets<O>

Returns the “default value” for a type.

impl<O> From<Offsets<O>> for OffsetsBuffer<O>

where O: Offset,

fn from(offsets: Offsets<O>) -> OffsetsBuffer<O>

Converts to this type from the input type.

impl From<Offsets<i32>> for Offsets<i64>

fn from(offsets: Offsets<i32>) -> Offsets<i64>

Converts to this type from the input type.

impl<O> PartialEq for Offsets<O>

where O: PartialEq + Offset,

fn eq(&self, other: &Offsets<O>) -> bool

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<Offsets<i64>> for Offsets<i32>

type Error = Error

The type returned in the event of a conversion error.

fn try_from( offsets: Offsets<i64> ) -> Result<Offsets<i32>, <Offsets<i32> as TryFrom<Offsets<i64>>>::Error>

Performs the conversion.

impl<O> TryFrom<Vec<O>> for Offsets<O>

where O: Offset,

type Error = Error

The type returned in the event of a conversion error.

fn try_from( offsets: Vec<O> ) -> Result<Offsets<O>, <Offsets<O> as TryFrom<Vec<O>>>::Error>

Performs the conversion.

impl<O> Eq for Offsets<O>

where O: Eq + Offset,

impl<O> StructuralPartialEq for Offsets<O>

where O: Offset,