Struct geo_types::GeometryCollection

pub struct GeometryCollection<T>(pub Vec<Geometry<T>>)
 where
    T: CoordNum;

A collection of Geometry types.

It can be created from a Vec of Geometries, or from an Iterator which yields Geometries.

Looping over this object yields its component Geometry enum members (not the underlying geometry primitives), and it supports iteration and indexing as well as the various MapCoords functions, which are directly applied to the underlying geometry primitives.

Examples

Looping

use std::convert::TryFrom;
use geo_types::{Point, point, Geometry, GeometryCollection};
let p = point!(x: 1.0, y: 1.0);
let pe = Geometry::Point(p);
let gc = GeometryCollection(vec![pe]);
for geom in gc {
    println!("{:?}", Point::try_from(geom).unwrap().x());
}

Implements iter()

use std::convert::TryFrom;
use geo_types::{Point, point, Geometry, GeometryCollection};
let p = point!(x: 1.0, y: 1.0);
let pe = Geometry::Point(p);
let gc = GeometryCollection(vec![pe]);
gc.iter().for_each(|geom| println!("{:?}", geom));

Mutable Iteration

use std::convert::TryFrom;
use geo_types::{Point, point, Geometry, GeometryCollection};
let p = point!(x: 1.0, y: 1.0);
let pe = Geometry::Point(p);
let mut gc = GeometryCollection(vec![pe]);
gc.iter_mut().for_each(|geom| {
   if let Geometry::Point(p) = geom {
       p.set_x(0.2);
   }
});
let updated = gc[0].clone();
assert_eq!(Point::try_from(updated).unwrap().x(), 0.2);

Indexing

use std::convert::TryFrom;
use geo_types::{Point, point, Geometry, GeometryCollection};
let p = point!(x: 1.0, y: 1.0);
let pe = Geometry::Point(p);
let gc = GeometryCollection(vec![pe]);
println!("{:?}", gc[0]);

Tuple Fields

0: Vec<Geometry<T>>

Implementations

impl<T: CoordNum> GeometryCollection<T>

pub fn new() -> GeometryCollection<T>

Return an empty GeometryCollection

pub fn len(&self) -> usize

Number of geometries in this GeometryCollection

pub fn is_empty(&self) -> bool

Is this GeometryCollection empty

impl<'a, T: CoordNum> GeometryCollection<T>

pub fn iter(&'a self) -> IterHelper<'a, T>

pub fn iter_mut(&'a mut self) -> IterMutHelper<'a, T>

Trait Implementations

impl<T> AbsDiffEq<GeometryCollection<T>> for GeometryCollection<T> where
    T: AbsDiffEq<Epsilon = T> + CoordNum,
    T::Epsilon: Copy, 

fn abs_diff_eq(&self, other: &Self, epsilon: Self::Epsilon) -> bool

Equality assertion with an absolute limit.

Examples

use geo_types::{GeometryCollection, point};

let a = GeometryCollection(vec![point![x: 0.0, y: 0.0].into()]);
let b = GeometryCollection(vec![point![x: 0.0, y: 0.1].into()]);

approx::abs_diff_eq!(a, b, epsilon=0.1);
approx::abs_diff_ne!(a, b, epsilon=0.001);

type Epsilon = T

Used for specifying relative comparisons.

fn default_epsilon() -> Self::Epsilon

The default tolerance to use when testing values that are close together.

fn abs_diff_ne(&self, other: &Rhs, epsilon: Self::Epsilon) -> bool

The inverse of AbsDiffEq::abs_diff_eq.

impl<T: Clone> Clone for GeometryCollection<T> where
    T: CoordNum, 

fn clone(&self) -> GeometryCollection<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for GeometryCollection<T> where
    T: CoordNum, 

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

Formats the value using the given formatter.

impl<T: CoordNum> Default for GeometryCollection<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T: CoordNum, IG: Into<Geometry<T>>> From<IG> for GeometryCollection<T>

Convert any Geometry (or anything that can be converted to a Geometry) into a GeometryCollection

fn from(x: IG) -> Self

Performs the conversion.

impl<T: CoordNum, IG: Into<Geometry<T>>> FromIterator<IG> for GeometryCollection<T>

Collect Geometries (or what can be converted to a Geometry) into a GeometryCollection

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

Creates a value from an iterator.

impl<T: Hash> Hash for GeometryCollection<T> where
    T: CoordNum, 

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl<T: CoordNum> Index<usize> for GeometryCollection<T>

type Output = Geometry<T>

The returned type after indexing.

fn index(&self, index: usize) -> &Geometry<T>

Performs the indexing (container[index]) operation.

impl<T: CoordNum> IndexMut<usize> for GeometryCollection<T>

fn index_mut(&mut self, index: usize) -> &mut Geometry<T>

Performs the mutable indexing (container[index]) operation.

impl<T: CoordNum> IntoIterator for GeometryCollection<T>

type Item = Geometry<T>

The type of the elements being iterated over.

type IntoIter = IntoIteratorHelper<T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, T: CoordNum> IntoIterator for &'a GeometryCollection<T>

type Item = &'a Geometry<T>

The type of the elements being iterated over.

type IntoIter = IterHelper<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, T: CoordNum> IntoIterator for &'a mut GeometryCollection<T>

type Item = &'a mut Geometry<T>

The type of the elements being iterated over.

type IntoIter = IterMutHelper<'a, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<T: PartialEq> PartialEq<GeometryCollection<T>> for GeometryCollection<T> where
    T: CoordNum, 

fn eq(&self, other: &GeometryCollection<T>) -> bool

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

fn ne(&self, other: &GeometryCollection<T>) -> bool

This method tests for !=.

impl<T> RelativeEq<GeometryCollection<T>> for GeometryCollection<T> where
    T: AbsDiffEq<Epsilon = T> + CoordNum + RelativeEq, 

fn relative_eq(
    &self,
    other: &Self,
    epsilon: Self::Epsilon,
    max_relative: Self::Epsilon
) -> bool

Equality assertion within a relative limit.

Examples

use geo_types::{GeometryCollection, point};

let a = GeometryCollection(vec![point![x: 1.0, y: 2.0].into()]);
let b = GeometryCollection(vec![point![x: 1.0, y: 2.01].into()]);

approx::assert_relative_eq!(a, b, max_relative=0.1);
approx::assert_relative_ne!(a, b, max_relative=0.0001);

fn default_max_relative() -> Self::Epsilon

The default relative tolerance for testing values that are far-apart.

fn relative_ne(
    &self,
    other: &Rhs,
    epsilon: Self::Epsilon,
    max_relative: Self::Epsilon
) -> bool

The inverse of RelativeEq::relative_eq.

impl<T: Eq> Eq for GeometryCollection<T> where
    T: CoordNum, 

impl<T> StructuralEq for GeometryCollection<T> where
    T: CoordNum, 

impl<T> StructuralPartialEq for GeometryCollection<T> where
    T: CoordNum,