ST_ForceCollection
Prev | 8.5. Geometry Editors | Next

## Name

ST_ForceCollection — Convert the geometry into a GEOMETRYCOLLECTION.

## Synopsis

`geometry ST_ForceCollection(`geometry geomA`)`;

## Description

Converts the geometry into a GEOMETRYCOLLECTION. This is useful for simplifying the WKB representation.

Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.

Availability: 1.2.2, prior to 1.3.4 this function will crash with Curves. This is fixed in 1.3.4+

Changed: 2.1.0. Up to 2.0.x this was called ST_Force_Collection.

This function supports Polyhedral surfaces.

This function supports 3d and will not drop the z-index.

This method supports Circular Strings and Curves

## Examples

    SELECT  ST_AsEWKT(ST_ForceCollection('POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 1,1 3 1,1 1 1))'));

    								   st_asewkt
    ----------------------------------------------------------------------------------
     GEOMETRYCOLLECTION(POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 1,1 3 1,1 1 1)))

      SELECT ST_AsText(ST_ForceCollection('CIRCULARSTRING(220227 150406,2220227 150407,220227 150406)'));
    								   st_astext
    --------------------------------------------------------------------------------
     GEOMETRYCOLLECTION(CIRCULARSTRING(220227 150406,2220227 150407,220227 150406))
    (1 row)

    -- POLYHEDRAL example --
    SELECT ST_AsEWKT(ST_ForceCollection('POLYHEDRALSURFACE(((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0)),
     ((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0)),
     ((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0)),
     ((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0)),
     ((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0)),
     ((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1)))'))

    								   st_asewkt
    ----------------------------------------------------------------------------------
    GEOMETRYCOLLECTION(
      POLYGON((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0)),
      POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0)),
      POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0)),
      POLYGON((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0)),
      POLYGON((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0)),
      POLYGON((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1))
    )

## See Also

ST_AsEWKT, ST_Force2D, ST_Force3DM, ST_Force3D, ST_GeomFromEWKT

Prev | Up | Next
ST_ForcePolygonCCW | Home | ST_ForcePolygonCW