GEOS 3.11.1
Public Member Functions | Protected Member Functions | Friends | List of all members
geos::geom::MultiLineString Class Reference

Models a collection of LineStrings. More...

#include <MultiLineString.h>

Inheritance diagram for geos::geom::MultiLineString:
geos::geom::GeometryCollection geos::geom::Geometry

Public Member Functions

Dimension::DimensionType getDimension () const override
 Returns line dimension (1) More...
 
bool isDimensionStrict (Dimension::DimensionType d) const override
 Checks whether this Geometry consists only of components having dimension d. More...
 
int getBoundaryDimension () const override
 Returns Dimension::False if all LineStrings in the collection are closed, 0 otherwise. More...
 
std::unique_ptr< GeometrygetBoundary () const override
 Returns a (possibly empty) MultiPoint. More...
 
const LineStringgetGeometryN (std::size_t n) const override
 Returns a pointer to the nth Geometry in this collection. More...
 
std::string getGeometryType () const override
 Return a string representation of this Geometry type. More...
 
GeometryTypeId getGeometryTypeId () const override
 Return an integer representation of this Geometry type. More...
 
bool isClosed () const
 
std::unique_ptr< MultiLineStringclone () const
 
std::unique_ptr< MultiLineStringreverse () const
 
- Public Member Functions inherited from geos::geom::GeometryCollection
const_iterator begin () const
 
const_iterator end () const
 
std::unique_ptr< GeometryCollectionclone () const
 
void setSRID (int) override
 Sets the ID of the Spatial Reference System used by the Geometry. More...
 
std::unique_ptr< CoordinateSequencegetCoordinates () const override
 Collects all coordinates of all subgeometries into a CoordinateSequence. More...
 
bool isEmpty () const override
 Returns whether or not the set of points in this Geometry is empty. More...
 
Dimension::DimensionType getDimension () const override
 Returns the maximum dimension of geometries in this collection (0=point, 1=line, 2=surface) More...
 
bool isDimensionStrict (Dimension::DimensionType d) const override
 Checks whether this Geometry consists only of components having dimension d. More...
 
uint8_t getCoordinateDimension () const override
 Returns coordinate dimension. More...
 
std::unique_ptr< GeometrygetBoundary () const override
 Returns the boundary, or an empty geometry of appropriate dimension if this Geometry is empty. More...
 
int getBoundaryDimension () const override
 Returns the maximum boundary dimension of geometries in this collection. More...
 
std::size_t getNumPoints () const override
 Returns the count of this Geometrys vertices. More...
 
std::string getGeometryType () const override
 Return a string representation of this Geometry type. More...
 
GeometryTypeId getGeometryTypeId () const override
 Return an integer representation of this Geometry type. More...
 
bool equalsExact (const Geometry *other, double tolerance=0) const override
 Returns true iff the two Geometrys are of the same type and their vertices corresponding by index are equal up to a specified tolerance. More...
 
void apply_ro (CoordinateFilter *filter) const override
 
void apply_rw (const CoordinateFilter *filter) override
 
void apply_ro (GeometryFilter *filter) const override
 
void apply_rw (GeometryFilter *filter) override
 
void apply_ro (GeometryComponentFilter *filter) const override
 
void apply_rw (GeometryComponentFilter *filter) override
 
void apply_rw (CoordinateSequenceFilter &filter) override
 
void apply_ro (CoordinateSequenceFilter &filter) const override
 
void normalize () override
 
const CoordinategetCoordinate () const override
 Returns a vertex of this Geometry, or NULL if this is the empty geometry. More...
 
double getArea () const override
 Returns the total area of this collection. More...
 
double getLength () const override
 Returns the total length of this collection. More...
 
std::size_t getNumGeometries () const override
 Returns the number of geometries in this collection. More...
 
const GeometrygetGeometryN (std::size_t n) const override
 Returns a pointer to the nth Geometry in this collection. More...
 
std::vector< std::unique_ptr< Geometry > > releaseGeometries ()
 Take ownership of the sub-geometries managed by this GeometryCollection. After releasing the sub-geometries, the collection should be considered in a moved-from state and should not be accessed. More...
 
std::unique_ptr< GeometryCollectionreverse () const
 
- Public Member Functions inherited from geos::geom::Geometry
std::unique_ptr< Geometryclone () const
 Make a deep-copy of this Geometry.
 
virtual ~Geometry ()
 Destroy Geometry and all components.
 
const GeometryFactorygetFactory () const
 Gets the factory which contains the context in which this geometry was created. More...
 
void setUserData (void *newUserData)
 A simple scheme for applications to add their own custom data to a Geometry. An example use might be to add an object representing a Coordinate Reference System. More...
 
void * getUserData () const
 Gets the user data object for this geometry, if any. More...
 
virtual int getSRID () const
 Returns the ID of the Spatial Reference System used by the Geometry. More...
 
virtual void setSRID (int newSRID)
 Sets the ID of the Spatial Reference System used by the Geometry. More...
 
const PrecisionModelgetPrecisionModel () const
 Get the PrecisionModel used to create this Geometry.
 
virtual const CoordinategetCoordinate () const =0
 Returns a vertex of this Geometry, or NULL if this is the empty geometry. More...
 
virtual std::unique_ptr< CoordinateSequencegetCoordinates () const =0
 Returns this Geometry vertices. Caller takes ownership of the returned object. More...
 
virtual std::size_t getNumPoints () const =0
 Returns the count of this Geometrys vertices. More...
 
virtual bool isSimple () const
 Returns false if the Geometry not simple. More...
 
virtual std::string getGeometryType () const =0
 Return a string representation of this Geometry type. More...
 
virtual GeometryTypeId getGeometryTypeId () const =0
 Return an integer representation of this Geometry type. More...
 
virtual std::size_t getNumGeometries () const
 
virtual const GeometrygetGeometryN (std::size_t) const
 Returns a pointer to the nth Geometry in this collection (or self if this is not a collection) More...
 
virtual bool isValid () const
 Tests the validity of this Geometry. More...
 
virtual bool isEmpty () const =0
 Returns whether or not the set of points in this Geometry is empty. More...
 
virtual bool isRectangle () const
 Polygon overrides to check for actual rectangle. More...
 
virtual Dimension::DimensionType getDimension () const =0
 Returns the dimension of this Geometry (0=point, 1=line, 2=surface) More...
 
virtual bool isDimensionStrict (Dimension::DimensionType d) const
 Checks whether this Geometry consists only of components having dimension d. More...
 
bool isPuntal () const
 
bool isLineal () const
 
bool isPolygonal () const
 
bool isCollection () const
 
virtual uint8_t getCoordinateDimension () const =0
 Returns the coordinate dimension of this Geometry (2=XY, 3=XYZ, 4=XYZM in future). More...
 
virtual std::unique_ptr< GeometrygetBoundary () const =0
 Returns the boundary, or an empty geometry of appropriate dimension if this Geometry is empty. More...
 
virtual int getBoundaryDimension () const =0
 Returns the dimension of this Geometrys inherent boundary. More...
 
virtual std::unique_ptr< GeometrygetEnvelope () const
 Returns this Geometrys bounding box.
 
virtual const EnvelopegetEnvelopeInternal () const
 Returns the minimum and maximum x and y values in this Geometry, or a null Envelope if this Geometry is empty.
 
virtual bool disjoint (const Geometry *other) const
 
virtual bool touches (const Geometry *other) const
 Returns true if the DE-9IM intersection matrix for the two Geometrys is FT*******, F**T***** or F***T****.
 
virtual bool intersects (const Geometry *g) const
 Returns true if disjoint returns false.
 
virtual bool crosses (const Geometry *g) const
 
virtual bool within (const Geometry *g) const
 Returns true if the DE-9IM intersection matrix for the two Geometrys is T*F**F***.
 
virtual bool contains (const Geometry *g) const
 Returns true if other.within(this) returns true.
 
virtual bool overlaps (const Geometry *g) const
 Returns true if the DE-9IM intersection matrix for the two Geometrys is T*T***T** (for two points or two surfaces) 1*T***T** (for two curves).
 
bool relate (const Geometry *g, const std::string &intersectionPattern) const
 Returns true if the elements in the DE-9IM intersection matrix for the two Geometrys match the elements in intersectionPattern. More...
 
bool relate (const Geometry &g, const std::string &intersectionPattern) const
 
std::unique_ptr< IntersectionMatrixrelate (const Geometry *g) const
 Returns the DE-9IM intersection matrix for the two Geometrys.
 
std::unique_ptr< IntersectionMatrixrelate (const Geometry &g) const
 
virtual bool equals (const Geometry *g) const
 Returns true if the DE-9IM intersection matrix for the two Geometrys is T*F**FFF*.
 
bool covers (const Geometry *g) const
 Returns true if this geometry covers the specified geometry. More...
 
bool coveredBy (const Geometry *g) const
 Tests whether this geometry is covered by the specified geometry. More...
 
virtual std::string toString () const
 Returns the Well-known Text representation of this Geometry.
 
virtual std::string toText () const
 
std::unique_ptr< Geometrybuffer (double distance) const
 
std::unique_ptr< Geometrybuffer (double distance, int quadrantSegments) const
 Returns a buffer region around this Geometry having the given width and with a specified number of segments used to approximate curves. More...
 
std::unique_ptr< Geometrybuffer (double distance, int quadrantSegments, int endCapStyle) const
 Computes a buffer area around this geometry having the given width and with a specified accuracy of approximation for circular arcs, and using a specified end cap style. More...
 
virtual std::unique_ptr< GeometryconvexHull () const
 Returns the smallest convex Polygon that contains all the points in the Geometry. More...
 
std::unique_ptr< Geometryreverse () const
 Computes a new geometry which has all component coordinate sequences in reverse order (opposite orientation) to this one. More...
 
std::unique_ptr< Geometryintersection (const Geometry *other) const
 Returns a Geometry representing the points shared by this Geometry and other. More...
 
std::unique_ptr< GeometryUnion (const Geometry *other) const
 Returns a Geometry representing all the points in this Geometry and other. More...
 
Ptr Union () const
 Computes the union of all the elements of this geometry. Heterogeneous GeometryCollections are fully supported. More...
 
std::unique_ptr< Geometrydifference (const Geometry *other) const
 Returns a Geometry representing the points making up this Geometry that do not make up other. More...
 
std::unique_ptr< GeometrysymDifference (const Geometry *other) const
 Returns a set combining the points in this Geometry not in other, and the points in other not in this Geometry. More...
 
virtual bool equalsExact (const Geometry *other, double tolerance=0) const =0
 Returns true iff the two Geometrys are of the same type and their vertices corresponding by index are equal up to a specified tolerance. More...
 
virtual void apply_rw (const CoordinateFilter *filter)=0
 
virtual void apply_ro (CoordinateFilter *filter) const =0
 
virtual void apply_rw (GeometryFilter *filter)
 
virtual void apply_ro (GeometryFilter *filter) const
 
virtual void apply_rw (GeometryComponentFilter *filter)
 
virtual void apply_ro (GeometryComponentFilter *filter) const
 
virtual void apply_rw (CoordinateSequenceFilter &filter)=0
 
virtual void apply_ro (CoordinateSequenceFilter &filter) const =0
 
template<class T >
void applyComponentFilter (T &f) const
 Apply a filter to each component of this geometry. The filter is expected to provide a .filter(const Geometry*) method. More...
 
virtual void normalize ()=0
 
virtual int compareTo (const Geometry *geom) const
 Comparator for sorting geometry.
 
virtual double distance (const Geometry *g) const
 Returns the minimum distance between this Geometry and the Geometry g.
 
virtual double getArea () const
 Returns the area of this Geometry. More...
 
virtual double getLength () const
 Returns the length of this Geometry. More...
 
virtual bool isWithinDistance (const Geometry *geom, double cDistance) const
 Tests whether the distance from this Geometry to another is less than or equal to a specified value. More...
 
virtual std::unique_ptr< PointgetCentroid () const
 Computes the centroid of this Geometry. More...
 
virtual bool getCentroid (Coordinate &ret) const
 Computes the centroid of this Geometry as a Coordinate. More...
 
std::unique_ptr< PointgetInteriorPoint () const
 Computes an interior point of this Geometry. More...
 
virtual void geometryChanged ()
 Notifies this Geometry that its Coordinates have been changed by an external party (using a CoordinateFilter, for example).
 
void geometryChangedAction ()
 Notifies this Geometry that its Coordinates have been changed by an external party.
 

Protected Member Functions

 MultiLineString (std::vector< Geometry * > *newLines, const GeometryFactory *newFactory)
 Constructs a MultiLineString. More...
 
 MultiLineString (std::vector< std::unique_ptr< LineString > > &&newLines, const GeometryFactory &newFactory)
 
 MultiLineString (std::vector< std::unique_ptr< Geometry > > &&newLines, const GeometryFactory &newFactory)
 
 MultiLineString (const MultiLineString &mp)
 
MultiLineStringcloneImpl () const override
 Make a deep-copy of this Geometry. More...
 
MultiLineStringreverseImpl () const override
 Make a geometry with coordinates in reverse order. More...
 
int getSortIndex () const override
 
- Protected Member Functions inherited from geos::geom::GeometryCollection
 GeometryCollection (const GeometryCollection &gc)
 
 GeometryCollection (std::vector< Geometry * > *newGeoms, const GeometryFactory *newFactory)
 Construct a GeometryCollection with the given GeometryFactory. Will keep a reference to the factory, so don't delete it until al Geometry objects referring to it are deleted. Will take ownership of the Geometry vector. More...
 
 GeometryCollection (std::vector< std::unique_ptr< Geometry > > &&newGeoms, const GeometryFactory &newFactory)
 
template<typename T >
 GeometryCollection (std::vector< std::unique_ptr< T > > &&newGeoms, const GeometryFactory &newFactory)
 Convenience constructor to build a GeometryCollection from vector of Geometry subclass pointers.
 
GeometryCollectioncloneImpl () const override
 Make a deep-copy of this Geometry. More...
 
GeometryCollectionreverseImpl () const override
 Make a geometry with coordinates in reverse order. More...
 
int getSortIndex () const override
 
Envelope::Ptr computeEnvelopeInternal () const override
 
int compareToSameClass (const Geometry *gc) const override
 
- Protected Member Functions inherited from geos::geom::Geometry
virtual GeometrycloneImpl () const =0
 Make a deep-copy of this Geometry. More...
 
virtual GeometryreverseImpl () const =0
 Make a geometry with coordinates in reverse order. More...
 
virtual bool isEquivalentClass (const Geometry *other) const
 Returns whether the two Geometrys are equal, from the point of view of the equalsExact method.
 
virtual Envelope::Ptr computeEnvelopeInternal () const =0
 
virtual int compareToSameClass (const Geometry *geom) const =0
 
int compare (std::vector< Coordinate > a, std::vector< Coordinate > b) const
 
int compare (std::vector< Geometry * > a, std::vector< Geometry * > b) const
 
int compare (const std::vector< std::unique_ptr< Geometry > > &a, const std::vector< std::unique_ptr< Geometry > > &b) const
 
bool equal (const Coordinate &a, const Coordinate &b, double tolerance) const
 
 Geometry (const Geometry &geom)
 
 Geometry (const GeometryFactory *factory)
 Construct a geometry with the given GeometryFactory. More...
 
virtual int getSortIndex () const =0
 

Friends

class GeometryFactory
 

Additional Inherited Members

- Public Types inherited from geos::geom::GeometryCollection
typedef std::vector< std::unique_ptr< Geometry > >::const_iterator const_iterator
 
typedef std::vector< std::unique_ptr< Geometry > >::iterator iterator
 
- Public Types inherited from geos::geom::Geometry
using ConstVect = std::vector< const Geometry * >
 A vector of const Geometry pointers.
 
using NonConstVect = std::vector< Geometry * >
 A vector of non-const Geometry pointers.
 
using Ptr = std::unique_ptr< Geometry >
 An unique_ptr of Geometry.
 
- Static Protected Member Functions inherited from geos::geom::Geometry
template<typename T >
static bool hasNonEmptyElements (const std::vector< T > *geometries)
 Returns true if the array contains any non-empty Geometrys.
 
static bool hasNullElements (const CoordinateSequence *list)
 Returns true if the CoordinateSequence contains any null elements.
 
template<typename T >
static bool hasNullElements (const std::vector< T > *geometries)
 Returns true if the vector contains any null elements.
 
static void checkNotGeometryCollection (const Geometry *g)
 
template<typename T >
static std::vector< std::unique_ptr< Geometry > > toGeometryArray (std::vector< std::unique_ptr< T > > &&v)
 
- Protected Attributes inherited from geos::geom::GeometryCollection
std::vector< std::unique_ptr< Geometry > > geometries
 
- Protected Attributes inherited from geos::geom::Geometry
std::unique_ptr< Envelopeenvelope
 The bounding box of this Geometry.
 
int SRID
 

Detailed Description

Models a collection of LineStrings.

Constructor & Destructor Documentation

◆ MultiLineString()

geos::geom::MultiLineString::MultiLineString ( std::vector< Geometry * > *  newLines,
const GeometryFactory newFactory 
)
protected

Constructs a MultiLineString.

Parameters
newLinesThe LineStrings for this MultiLineString, or null or an empty array to create the empty geometry. Elements may be empty LineString, but not nulls.
newFactoryThe GeometryFactory used to create this geometry. Caller must keep the factory alive for the life-time of the constructed MultiLineString.
Note
Constructed object will take ownership of the vector and its elements.

Member Function Documentation

◆ cloneImpl()

MultiLineString * geos::geom::MultiLineString::cloneImpl ( ) const
inlineoverrideprotectedvirtual

Make a deep-copy of this Geometry.

Reimplemented from geos::geom::GeometryCollection.

◆ getBoundary()

std::unique_ptr< Geometry > geos::geom::MultiLineString::getBoundary ( ) const
overridevirtual

Returns a (possibly empty) MultiPoint.

Reimplemented from geos::geom::GeometryCollection.

◆ getBoundaryDimension()

int geos::geom::MultiLineString::getBoundaryDimension ( ) const
overridevirtual

Returns Dimension::False if all LineStrings in the collection are closed, 0 otherwise.

Reimplemented from geos::geom::GeometryCollection.

◆ getDimension()

Dimension::DimensionType geos::geom::MultiLineString::getDimension ( ) const
overridevirtual

Returns line dimension (1)

Reimplemented from geos::geom::GeometryCollection.

◆ getGeometryN()

const LineString * geos::geom::MultiLineString::getGeometryN ( std::size_t  n) const
overridevirtual

Returns a pointer to the nth Geometry in this collection.

Reimplemented from geos::geom::GeometryCollection.

◆ getGeometryType()

std::string geos::geom::MultiLineString::getGeometryType ( ) const
overridevirtual

Return a string representation of this Geometry type.

Reimplemented from geos::geom::GeometryCollection.

◆ getGeometryTypeId()

GeometryTypeId geos::geom::MultiLineString::getGeometryTypeId ( ) const
overridevirtual

Return an integer representation of this Geometry type.

Reimplemented from geos::geom::GeometryCollection.

◆ getSortIndex()

int geos::geom::MultiLineString::getSortIndex ( ) const
inlineoverrideprotectedvirtual

Reimplemented from geos::geom::GeometryCollection.

◆ isDimensionStrict()

bool geos::geom::MultiLineString::isDimensionStrict ( Dimension::DimensionType  d) const
inlineoverridevirtual

Checks whether this Geometry consists only of components having dimension d.

Reimplemented from geos::geom::GeometryCollection.

References geos::geom::Dimension::L.

◆ reverse()

std::unique_ptr< MultiLineString > geos::geom::MultiLineString::reverse ( ) const
inline

Creates a MultiLineString in the reverse order to this object. Both the order of the component LineStrings and the order of their coordinate sequences are reversed.

Returns
a MultiLineString in the reverse order

◆ reverseImpl()

MultiLineString * geos::geom::MultiLineString::reverseImpl ( ) const
overrideprotectedvirtual

Make a geometry with coordinates in reverse order.

Reimplemented from geos::geom::GeometryCollection.


The documentation for this class was generated from the following file: