Struct MultiLineStringArray

pub struct MultiLineStringArray { /* private fields */ }

An immutable array of MultiLineString geometries.

This is semantically equivalent to Vec<Option<MultiLineString>> due to the internal validity bitmap.

Implementations

impl MultiLineStringArray

pub fn new( coords: CoordBuffer, geom_offsets: OffsetBuffer<i32>, ring_offsets: OffsetBuffer<i32>, nulls: Option<NullBuffer>, metadata: Arc<Metadata>, ) -> Self

Create a new MultiLineStringArray from parts

Implementation

This function is O(1).

Panics

• if the nulls is not None and its length is different from the number of geometries
• if the largest ring offset does not match the number of coordinates
• if the largest geometry offset does not match the size of ring offsets

pub fn try_new( coords: CoordBuffer, geom_offsets: OffsetBuffer<i32>, ring_offsets: OffsetBuffer<i32>, nulls: Option<NullBuffer>, metadata: Arc<Metadata>, ) -> GeoArrowResult<Self>

Create a new MultiLineStringArray from parts

Implementation

This function is O(1).

Errors

• if the nulls is not None and its length is different from the number of geometries
• if the largest ring offset does not match the number of coordinates
• if the largest geometry offset does not match the size of ring offsets

pub fn coords(&self) -> &CoordBuffer

Access the underlying coordinate buffer

pub fn geom_offsets(&self) -> &OffsetBuffer<i32>

Access the underlying geometry offsets buffer

pub fn ring_offsets(&self) -> &OffsetBuffer<i32>

Access the underlying ring offsets buffer

pub fn buffer_lengths(&self) -> MultiLineStringCapacity

The lengths of each buffer contained in this array.

pub fn num_bytes(&self) -> usize

The number of bytes occupied by this array.

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

Slice this MultiLineStringArray.

Panic

This function panics iff offset + length > self.len().

pub fn into_coord_type(self, coord_type: CoordType) -> Self

Change the CoordType of this array.

pub fn with_metadata(self, metadata: Arc<Metadata>) -> Self

Change the Metadata of this array.

Trait Implementations

impl Clone for MultiLineStringArray

fn clone(&self) -> MultiLineStringArray

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MultiLineStringArray

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

Formats the value using the given formatter.

impl From<LineStringArray> for MultiLineStringArray

fn from(value: LineStringArray) -> Self

Converts to this type from the input type.

impl From<MultiLineStringArray> for GeometryArray

fn from(value: MultiLineStringArray) -> Self

Converts to this type from the input type.

impl GeoArrowArray for MultiLineStringArray

fn as_any(&self) -> &dyn Any

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

fn into_array_ref(self) -> ArrayRef

Converts this array into an Arced arrow array, consuming the original array.

fn to_array_ref(&self) -> ArrayRef

Converts this array into an Arced arrow array.

fn len(&self) -> usize

The number of geometries contained in this array.

fn logical_nulls(&self) -> Option<NullBuffer>

Returns a potentially computed `NullBuffer`` that represents the logical null values of this array, if any.

fn logical_null_count(&self) -> usize

Returns the number of null slots in this array.

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

Returns whether slot i is null.

fn data_type(&self) -> GeoArrowType

Returns the GeoArrowType of this array.

fn slice(&self, offset: usize, length: usize) -> Arc<dyn GeoArrowArray>

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

fn with_metadata(self, metadata: Arc<Metadata>) -> Arc<dyn GeoArrowArray>

Change the Metadata of this array.

fn is_empty(&self) -> bool

Returns true if the array is empty.

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

Returns whether slot i is valid.

impl<'a> GeoArrowArrayAccessor<'a> for MultiLineStringArray

type Item = MultiLineString<'a>

The geoarrow scalar object for this geometry array type.

unsafe fn value_unchecked(&'a self, index: usize) -> GeoArrowResult<Self::Item>

Returns the element at index i, not considering validity.

fn value(&'a self, index: usize) -> GeoArrowResult<Self::Item>

Returns the element at index i, not considering validity.

fn get(&'a self, index: usize) -> GeoArrowResult<Option<Self::Item>>

Returns the value at slot i as an Arrow scalar, considering validity.

unsafe fn get_unchecked( &'a self, index: usize, ) -> Option<GeoArrowResult<Self::Item>>

Returns the value at slot i as an Arrow scalar, considering validity.

fn iter( &'a self, ) -> impl ExactSizeIterator<Item = Option<GeoArrowResult<Self::Item>>> + 'a

Iterates over this array’s geoarrow scalar values, considering validity.

fn iter_values( &'a self, ) -> impl ExactSizeIterator<Item = GeoArrowResult<Self::Item>> + 'a

Iterator over geoarrow scalar values, not considering validity.

impl IntoArrow for MultiLineStringArray

type ArrowArray = GenericListArray<i32>

The type of arrow array that this geoarrow array can be converted into.

type ExtensionType = MultiLineStringType

The extension type representing this array. It will always be a type defined by geoarrow_schema.

fn into_arrow(self) -> Self::ArrowArray

Converts this geoarrow array into an arrow array.

fn extension_type(&self) -> &Self::ExtensionType

Return the Arrow extension type representing this array.

impl PartialEq for MultiLineStringArray

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl TryFrom<(&GenericListArray<i32>, MultiLineStringType)> for MultiLineStringArray

type Error = GeoArrowError

The type returned in the event of a conversion error.

fn try_from( (geom_array, typ): (&GenericListArray<i32>, MultiLineStringType), ) -> GeoArrowResult<Self>

Performs the conversion.

impl TryFrom<(&GenericListArray<i64>, MultiLineStringType)> for MultiLineStringArray

type Error = GeoArrowError

The type returned in the event of a conversion error.

fn try_from( (geom_array, typ): (&GenericListArray<i64>, MultiLineStringType), ) -> GeoArrowResult<Self>

Performs the conversion.

impl TryFrom<(&dyn Array, &Field)> for MultiLineStringArray

type Error = GeoArrowError

The type returned in the event of a conversion error.

fn try_from((arr, field): (&dyn Array, &Field)) -> GeoArrowResult<Self>

Performs the conversion.

impl TryFrom<(&dyn Array, MultiLineStringType)> for MultiLineStringArray

type Error = GeoArrowError

The type returned in the event of a conversion error.

fn try_from( (value, typ): (&dyn Array, MultiLineStringType), ) -> GeoArrowResult<Self>

Performs the conversion.

impl<O: OffsetSizeTrait> TryFrom<(GenericWkbArray<O>, MultiLineStringType)> for MultiLineStringArray

type Error = GeoArrowError

The type returned in the event of a conversion error.

fn try_from( value: (GenericWkbArray<O>, MultiLineStringType), ) -> GeoArrowResult<Self>

Performs the conversion.