ST_GeomCollFromTxt function [Spatial]

Returns an ST_GeomCollection value, which is transformed from a LONG VARCHAR value containing the Well Known Text (WKT) representation of an ST_GeomCollection

Syntax

[DBO.]ST_GeomCollFromTxt(wkt[, srid])

Parameters

Name	Type	Description
wkt	LONG VARCHAR	The WKT representation.
srid	INT	The SRID of the result. If not specified, the default is 0.

Returns

ST_GeomCollection Returns an ST_GeomCollection value created from the input string.
The spatial reference system identifier of the result is the given by parameter srid.

Remarks

The ST_GeomCollFromTxt function is equivalent to the following:

CREATE FUNCTION DBO.ST_GeomCollFromTxt( wkt LONG VARCHAR, srid INT DEFAULT 0 )
RETURNS ST_GeomCollection
BEGIN
    DECLARE geo ST_Geometry;
    
    set geo = ST_Geometry::ST_GeomFromText( wkt, srid );
    RETURN CAST( geo AS ST_GeomCollection);
END

Note

The ST_GeomCollFromTxt function is not present by default in newly created databases. Use the sa_install_feature system procedure to install the spatial SQL compatibility functions. See sa_install_feature system procedure.

Standards and compatibility

Discuss this page in DocCommentXchange.