Enum CoordBufferBuilder

pub enum CoordBufferBuilder {
    Interleaved(InterleavedCoordBufferBuilder),
    Separated(SeparatedCoordBufferBuilder),
}

The GeoArrow equivalent to Vec<Coord>: a mutable collection of coordinates.

Converting an CoordBufferBuilder into a CoordBuffer is O(1).

Variants

Interleaved(InterleavedCoordBufferBuilder)

Interleaved coordinates

Separated(SeparatedCoordBufferBuilder)

Separated coordinates

Implementations

impl CoordBufferBuilder

pub fn initialize( len: usize, coord_type: CoordType, dim: Dimension, value: f64, ) -> Self

Initialize a buffer of a given length with all coordinates set to the given value.

pub fn with_capacity(len: usize, coord_type: CoordType, dim: Dimension) -> Self

Create a new builder with the given capacity and dimension

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

Reserves capacity for at least additional more coordinates to be inserted in the given Vec<T>. The collection may reserve more space to speculatively avoid frequent reallocations. After calling reserve, capacity will be greater than or equal to self.len() + additional. Does nothing if capacity is already sufficient.

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

Reserves the minimum capacity for at least additional more coordinates.

Unlike reserve, this will not deliberately over-allocate to speculatively avoid frequent allocations. After calling reserve_exact, capacity will be greater than or equal to self.len() + additional. Does nothing if the capacity is already sufficient.

Note that the allocator may give the collection more space than it requests. Therefore, capacity can not be relied upon to be precisely minimal. Prefer reserve if future insertions are expected.

pub fn capacity(&self) -> usize

Returns the total number of coordinates the vector can hold without reallocating.

pub fn len(&self) -> usize

The number of coordinates

pub fn is_empty(&self) -> bool

Whether the buffer is empty

pub fn coord_type(&self) -> CoordType

The underlying coordinate type

pub fn push_coord(&mut self, coord: &impl CoordTrait<T = f64>)

Push a new coord onto the end of this coordinate buffer

Panics

• If the added coordinate does not have the same dimension as the coordinate buffer.

pub fn try_push_coord( &mut self, coord: &impl CoordTrait<T = f64>, ) -> GeoArrowResult<()>

Push a new coord onto the end of this coordinate buffer

Errors

• If the added coordinate does not have the same dimension as the coordinate buffer.

pub fn push_point(&mut self, point: &impl PointTrait<T = f64>)

Push a new point onto the end of this coordinate buffer

Panics

• If the added point does not have the same dimension as the coordinate buffer.

pub fn try_push_point( &mut self, point: &impl PointTrait<T = f64>, ) -> GeoArrowResult<()>

Push a new point onto the end of this coordinate buffer

Errors

• If the added point does not have the same dimension as the coordinate buffer.

pub fn finish(self) -> CoordBuffer

Consume the builder and convert to an immutable CoordBuffer

Trait Implementations

impl Clone for CoordBufferBuilder

fn clone(&self) -> CoordBufferBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CoordBufferBuilder

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

Formats the value using the given formatter.