Struct arrow::array::StructArray

pub struct StructArray { /* fields omitted */ }

A nested array type where each child (called field) is represented by a separate array.

Implementations

impl StructArray

pub fn column(&self, pos: usize) -> &ArrayRef

Returns the field at pos.

pub fn num_columns(&self) -> usize

Return the number of fields in this struct array

pub fn columns(&self) -> Vec<&ArrayRef>

Returns the fields of the struct array

pub fn columns_ref(&self) -> Vec<ArrayRef>

Returns child array refs of the struct array

pub fn column_names(&self) -> Vec<&str>

Return field names in this struct array

pub fn column_by_name(&self, column_name: &str) -> Option<&ArrayRef>

Return child array whose field name equals to column_name

Trait Implementations

impl Array for StructArray

fn as_any(&self) -> &dyn Any

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

fn data(&self) -> ArrayDataRef

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

fn data_ref(&self) -> &ArrayDataRef

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

fn len(&self) -> usize

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

fn get_buffer_memory_size(&self) -> usize

Returns the total number of bytes of memory occupied by the buffers owned by this StructArray.

fn get_array_memory_size(&self) -> usize

Returns the total number of bytes of memory occupied physically by this StructArray.

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 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.

impl ArrayEqual for StructArray

fn equals(&self, other: &dyn Array) -> bool

Returns true if this array is equal to the other array

fn range_equals(
    &self,
    other: &dyn Array,
    start_idx: usize,
    end_idx: usize,
    other_start_idx: usize
) -> bool

Returns true if the range [start_idx, end_idx) is equal to [other_start_idx, other_start_idx + end_idx - start_idx) in the other array

impl Debug for StructArray

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

Formats the value using the given formatter.

impl<'_> From<&'_ StructArray> for RecordBatch

fn from(struct_array: &StructArray) -> Self

Create a record batch from struct array.

This currently does not flatten and nested struct types

impl From<(Vec<(Field, Arc<dyn Array + 'static>)>, Buffer, usize)> for StructArray

fn from(triple: (Vec<(Field, ArrayRef)>, Buffer, usize)) -> Self

Performs the conversion.

impl From<Arc<ArrayData>> for StructArray

fn from(data: ArrayDataRef) -> Self

Performs the conversion.

impl From<Vec<(Field, Arc<dyn Array + 'static>)>> for StructArray

fn from(v: Vec<(Field, ArrayRef)>) -> Self

Performs the conversion.

impl Into<StructArray> for RecordBatch

fn into(self) -> StructArray

Performs the conversion.

impl JsonEqual for StructArray

fn equals_json(&self, json: &[&Value]) -> bool

Checks whether arrow array equals to json array.

fn equals_json_values(&self, json: &[Value]) -> bool

Checks whether arrow array equals to json array.

impl PartialEq<StructArray> for Value

fn eq(&self, arrow: &StructArray) -> bool

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<Value> for StructArray

fn eq(&self, json: &Value) -> bool

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> TryFrom<Vec<(&'_ str, Arc<dyn Array + 'static>)>> for StructArray

type Error = ArrowError

The type returned in the event of a conversion error.

fn try_from(values: Vec<(&str, ArrayRef)>) -> Result<Self>

builds a StructArray from a vector of names and arrays. This errors if the values have a different length. An entry is set to Null when all values are null.