Struct arrow_array::array::GenericBinaryArray

pub struct GenericBinaryArray<OffsetSize: OffsetSizeTrait> { /* private fields */ }

See BinaryArray and LargeBinaryArray for storing binary data.

Implementations

impl<OffsetSize: OffsetSizeTrait> GenericBinaryArray<OffsetSize>

pub const DATA_TYPE: DataType = _

Data type of the array.

pub const fn get_data_type() -> DataType

👎Deprecated: please use Self::DATA_TYPE instead

Get the data type of the array.

pub fn value_length(&self, i: usize) -> OffsetSize

Returns the length for value at index i.

pub fn value_data(&self) -> Buffer

Returns a clone of the value data buffer

pub fn value_offsets(&self) -> &[OffsetSize]

Returns the offset values in the offsets buffer

pub unsafe fn value_unchecked(&self, i: usize) -> &[u8]

Returns the element at index i as bytes slice

Safety

Caller is responsible for ensuring that the index is within the bounds of the array

pub fn value(&self, i: usize) -> &[u8]

Returns the element at index i as bytes slice

Panics

Panics if index i is out of bounds.

pub fn from_vec(v: Vec<&[u8]>) -> Self

Creates a GenericBinaryArray from a vector of byte slices

See also Self::from_iter_values

pub fn from_opt_vec(v: Vec<Option<&[u8]>>) -> Self

Creates a GenericBinaryArray from a vector of Optional (null) byte slices

pub fn from_iter_values<Ptr, I>(iter: I) -> Selfwhere
    Ptr: AsRef<[u8]>,
    I: IntoIterator<Item = Ptr>,

Creates a GenericBinaryArray based on an iterator of values without nulls

pub fn take_iter<'a>(
    &'a self,
    indexes: impl Iterator<Item = Option<usize>> + 'a
) -> impl Iterator<Item = Option<&'_ [u8]>> + 'a

Returns an iterator that returns the values of array.value(i) for an iterator with each element i

pub unsafe fn take_iter_unchecked<'a>(
    &'a self,
    indexes: impl Iterator<Item = Option<usize>> + 'a
) -> impl Iterator<Item = Option<&'_ [u8]>> + 'a

Returns an iterator that returns the values of array.value(i) for an iterator with each element i

Safety

caller must ensure that the indexes in the iterator are less than the array.len()

pub fn iter(&self) -> GenericBinaryIter<'_, OffsetSize>

constructs a new iterator

Trait Implementations

impl<OffsetSize: OffsetSizeTrait> Array for GenericBinaryArray<OffsetSize>

fn as_any(&self) -> &dyn Any

Returns the array as Any so that it can be downcasted to a specific implementation.

fn data(&self) -> &ArrayData

Returns a reference to the underlying data of this array.

fn into_data(self) -> ArrayData

Returns the underlying data of this array.

fn data_ref(&self) -> &ArrayData

Returns a reference-counted pointer to the underlying data of this array.

fn data_type(&self) -> &DataType

Returns a reference to the DataType of this array.

fn slice(&self, offset: usize, length: usize) -> ArrayRef

Returns a zero-copy slice of this array with the indicated offset and length.

fn len(&self) -> usize

Returns the length (i.e., number of elements) of this array.

fn is_empty(&self) -> bool

Returns whether this array is empty.

fn offset(&self) -> usize

Returns the offset into the underlying data used by this array(-slice). Note that the underlying data can be shared by many arrays. This defaults to 0.

fn is_null(&self, index: usize) -> bool

Returns whether the element at index is null. When using this function on a slice, the index is relative to the slice.

fn is_valid(&self, index: usize) -> bool

Returns whether the element at index is not null. When using this function on a slice, the index is relative to the slice.

fn null_count(&self) -> usize

Returns the total number of null values in this array.

fn get_buffer_memory_size(&self) -> usize

Returns the total number of bytes of memory pointed to by this array. The buffers store bytes in the Arrow memory format, and include the data as well as the validity map.

fn get_array_memory_size(&self) -> usize

Returns the total number of bytes of memory occupied physically by this array. This value will always be greater than returned by get_buffer_memory_size() and includes the overhead of the data structures that contain the pointers to the various buffers.

impl<'a, OffsetSize: OffsetSizeTrait> ArrayAccessor for &'a GenericBinaryArray<OffsetSize>

type Item = &'a [u8]

fn value(&self, index: usize) -> Self::Item

Returns the element at index i

unsafe fn value_unchecked(&self, index: usize) -> Self::Item

Returns the element at index i

impl<OffsetSize: OffsetSizeTrait> Debug for GenericBinaryArray<OffsetSize>

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

Formats the value using the given formatter.

impl<OffsetSize: OffsetSizeTrait> From<ArrayData> for GenericBinaryArray<OffsetSize>

fn from(data: ArrayData) -> Self

Converts to this type from the input type.

impl<OffsetSize: OffsetSizeTrait> From<GenericBinaryArray<OffsetSize>> for ArrayData

fn from(array: GenericBinaryArray<OffsetSize>) -> Self

Converts to this type from the input type.

impl<OffsetSize: OffsetSizeTrait> From<GenericBinaryArray<OffsetSize>> for GenericStringArray<OffsetSize>

fn from(v: GenericBinaryArray<OffsetSize>) -> Self

Converts to this type from the input type.

impl<T: OffsetSizeTrait> From<GenericListArray<T>> for GenericBinaryArray<T>

fn from(v: GenericListArray<T>) -> Self

Converts to this type from the input type.

impl<OffsetSize: OffsetSizeTrait> From<Vec<&[u8], Global>> for GenericBinaryArray<OffsetSize>

fn from(v: Vec<&[u8]>) -> Self

Converts to this type from the input type.

impl<OffsetSize: OffsetSizeTrait> From<Vec<Option<&[u8]>, Global>> for GenericBinaryArray<OffsetSize>

fn from(v: Vec<Option<&[u8]>>) -> Self

Converts to this type from the input type.

impl<Ptr, OffsetSize: OffsetSizeTrait> FromIterator<Option<Ptr>> for GenericBinaryArray<OffsetSize>where
    Ptr: AsRef<[u8]>,

fn from_iter<I: IntoIterator<Item = Option<Ptr>>>(iter: I) -> Self

Creates a value from an iterator.

impl<'a, T: OffsetSizeTrait> IntoIterator for &'a GenericBinaryArray<T>

type Item = Option<&'a [u8]>

The type of the elements being iterated over.

type IntoIter = ArrayIter<&'a GenericBinaryArray<T>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<OffsetSize: OffsetSizeTrait> PartialEq<GenericBinaryArray<OffsetSize>> for GenericBinaryArray<OffsetSize>

fn eq(&self, other: &Self) -> 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.