Struct geo_types::line_string::LineString

pub struct LineString<T>(pub Vec<Coordinate<T>>)
where
    T: CoordinateType;

An ordered collection of two or more Coordinates, representing a path between locations.

Examples

Create a LineString by calling it directly:

use geo_types::{LineString, Coordinate};

let line_string = LineString(vec![
    Coordinate { x: 0., y: 0. },
    Coordinate { x: 10., y: 0. },
]);

Converting a Vec of Coordinate-like things:

use geo_types::LineString;

let line_string: LineString<f32> = vec![
    (0., 0.),
    (10., 0.),
].into();

use geo_types::LineString;

let line_string: LineString<f64> = vec![
    [0., 0.],
    [10., 0.],
].into();

Or collecting from a Coordinate iterator

use geo_types::{LineString, Coordinate};

let mut coords_iter = vec![
    Coordinate { x: 0., y: 0. },
    Coordinate { x: 10., y: 0. }
].into_iter();

let line_string: LineString<f32> = coords_iter.collect();

You can iterate over the coordinates in the LineString:

use geo_types::{LineString, Coordinate};

let line_string = LineString(vec![
    Coordinate { x: 0., y: 0. },
    Coordinate { x: 10., y: 0. },
]);

for coord in line_string {
    println!("Coordinate x = {}, y = {}", coord.x, coord.y);
}

Tuple Fields

0: Vec<Coordinate<T>>

Implementations

impl<T: CoordinateType> LineString<T>

pub fn points_iter(&self) -> PointsIter<'_, T>

pub fn into_points(self) -> Vec<Point<T>>

pub fn lines<'a>(
    &'a self
) -> impl ExactSizeIterator + Iterator<Item = Line<T>> + 'a

Return an Line iterator that yields one Line for each line segment in the LineString.

Examples

use geo_types::{Line, LineString, Coordinate};

let mut coords = vec![(0., 0.), (5., 0.), (7., 9.)];
let line_string: LineString<f32> = coords.into_iter().collect();

let mut lines = line_string.lines();
assert_eq!(
    Some(Line::new(Coordinate { x: 0., y: 0. }, Coordinate { x: 5., y: 0. })),
    lines.next()
);
assert_eq!(
    Some(Line::new(Coordinate { x: 5., y: 0. }, Coordinate { x: 7., y: 9. })),
    lines.next()
);
assert!(lines.next().is_none());

pub fn triangles<'a>(
    &'a self
) -> impl ExactSizeIterator + Iterator<Item = Triangle<T>> + 'a

Trait Implementations

impl<T: Clone> Clone for LineString<T>where
    T: CoordinateType,

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for LineString<T>where
    T: CoordinateType,

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

Formats the value using the given formatter.

impl<T: CoordinateType> From<LineString<T>> for Geometry<T>

fn from(x: LineString<T>) -> Geometry<T>

Converts to this type from the input type.

impl<T: CoordinateType, IC: Into<Coordinate<T>>> From<Vec<IC, Global>> for LineString<T>

Turn a Vec of Point-ish objects into a LineString.

fn from(v: Vec<IC>) -> Self

Converts to this type from the input type.

impl<T: CoordinateType, IC: Into<Coordinate<T>>> FromIterator<IC> for LineString<T>

Turn a Point-ish iterator into a LineString.

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

Creates a value from an iterator.

impl<T: CoordinateType> IntoIterator for LineString<T>

Iterate over all the Coordinates in this LineString.

type Item = Coordinate<T>

The type of the elements being iterated over.

type IntoIter = IntoIter<Coordinate<T>, Global>

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<LineString<T>> for LineString<T>where
    T: CoordinateType,

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

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

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

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

impl<T> StructuralPartialEq for LineString<T>where
    T: CoordinateType,