ST_ToGeomColl method

geometry-expression.ST_ToGeomColl()

ST_GeomCollection If the geometry-expression is of type ST_GeomCollection, returns the geometry-expression. If the geometry-expression is of type ST_Point, ST_Curve, or ST_Surface, then return a geometry collection containing one element, the geometry-expression. If the geometry-expression is the empty set, returns an empty set of type ST_GeomCollection. Otherwise, raises an exception condition.
The spatial reference system identifier of the result is the same as the spatial reference system of the geometry-expression.

If geometry-expression is already known to be an ST_GeomCollection value, it is more efficient to use TREAT( geometry-expression AS ST_GeomCollection ) than the ST_ToGeomColl method.

Note

By default, ST_ToGeomColl uses the original format for a geometry, if it is available. Otherwise, the internal format is used. For more information about internal and original formats, see STORAGE FORMAT clause, CREATE SPATIAL REFERENCE SYSTEM statement.

SQL/MM (ISO/IEC 13249-3: 2006) 5.1.33

The following example returns the result GeometryCollection (Point (0 1)).

SELECT NEW ST_Point( 0, 1 ).ST_ToGeomColl()

ST_ToGeomColl method

Syntax

Returns

Remarks

Note

See also

Standards and compatibility

Example