pub struct LineStringBuilder { /* private fields */ }
Expand description
The GeoArrow equivalent to Vec<Option<LineString>>
: a mutable collection of LineStrings.
Converting an LineStringBuilder
into a LineStringArray
is O(1)
.
Implementations§
Source§impl LineStringBuilder
impl LineStringBuilder
Sourcepub fn new(typ: LineStringType) -> Self
pub fn new(typ: LineStringType) -> Self
Creates a new empty LineStringBuilder
.
Sourcepub fn with_capacity(typ: LineStringType, capacity: LineStringCapacity) -> Self
pub fn with_capacity(typ: LineStringType, capacity: LineStringCapacity) -> Self
Creates a new LineStringBuilder
with a capacity.
Sourcepub fn reserve(&mut self, additional: LineStringCapacity)
pub fn reserve(&mut self, additional: LineStringCapacity)
Reserves capacity for at least additional
more LineStrings.
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.
Sourcepub fn reserve_exact(&mut self, additional: LineStringCapacity)
pub fn reserve_exact(&mut self, additional: LineStringCapacity)
Reserves the minimum capacity for at least additional
more LineStrings.
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.
Sourcepub fn push_empty(&mut self)
pub fn push_empty(&mut self)
Add a valid but empty LineString to the end of this array.
Sourcepub fn finish(self) -> LineStringArray
pub fn finish(self) -> LineStringArray
Consume the builder and convert to an immutable LineStringArray
Sourcepub fn from_line_strings(
geoms: &[impl LineStringTrait<T = f64>],
typ: LineStringType,
) -> Self
pub fn from_line_strings( geoms: &[impl LineStringTrait<T = f64>], typ: LineStringType, ) -> Self
Construct a new builder, pre-filling it with the provided geometries
Sourcepub fn from_nullable_line_strings(
geoms: &[Option<impl LineStringTrait<T = f64>>],
typ: LineStringType,
) -> Self
pub fn from_nullable_line_strings( geoms: &[Option<impl LineStringTrait<T = f64>>], typ: LineStringType, ) -> Self
Construct a new builder, pre-filling it with the provided geometries
Sourcepub fn push_line_string(
&mut self,
value: Option<&impl LineStringTrait<T = f64>>,
) -> GeoArrowResult<()>
pub fn push_line_string( &mut self, value: Option<&impl LineStringTrait<T = f64>>, ) -> GeoArrowResult<()>
Add a new LineString to the end of this array.
§Errors
This function errors iff the new last item is larger than what O supports.
Sourcepub fn extend_from_iter<'a>(
&mut self,
geoms: impl Iterator<Item = Option<&'a (impl LineStringTrait<T = f64> + 'a)>>,
)
pub fn extend_from_iter<'a>( &mut self, geoms: impl Iterator<Item = Option<&'a (impl LineStringTrait<T = f64> + 'a)>>, )
Extend this builder with the given geometries
Sourcepub fn extend_from_geometry_iter<'a>(
&mut self,
geoms: impl Iterator<Item = Option<&'a (impl GeometryTrait<T = f64> + 'a)>>,
) -> GeoArrowResult<()>
pub fn extend_from_geometry_iter<'a>( &mut self, geoms: impl Iterator<Item = Option<&'a (impl GeometryTrait<T = f64> + 'a)>>, ) -> GeoArrowResult<()>
Extend this builder with the given geometries
Sourcepub fn push_geometry(
&mut self,
value: Option<&impl GeometryTrait<T = f64>>,
) -> GeoArrowResult<()>
pub fn push_geometry( &mut self, value: Option<&impl GeometryTrait<T = f64>>, ) -> GeoArrowResult<()>
Add a new geometry to this builder
This will error if the geometry type is not LineString or a MultiLineString with length 1.
Sourcepub fn from_nullable_geometries(
geoms: &[Option<impl GeometryTrait<T = f64>>],
typ: LineStringType,
) -> GeoArrowResult<Self>
pub fn from_nullable_geometries( geoms: &[Option<impl GeometryTrait<T = f64>>], typ: LineStringType, ) -> GeoArrowResult<Self>
Construct a new builder, pre-filling it with the provided geometries