ST_MultiLineString

The ST_MultiLineString function has two variations.

In the first variation, ST_MultiLineString constructs a multilinestring from a well-known text representation, a well-known binary representation, an ESRI shape representation, or a Geography Markup Language (GML) representation. An optional spatial reference system identifier can be specified to identify the spatial reference system that the resulting multilinestring is in.

In the second variation, ST_MultiLineString takes ST_Geometry as an input parameter and casts the output type to ST_MultiLineString. If the given geometry is null, then null is returned.

Syntax for variation 1

Variation 1

Parameters for variation 1

wkt: A value of type CLOB(8M) that contains the well-known text representation of the resulting multilinestring. If the well-known text representation is null, then null is returned.
wkb: A value of type BLOB(4M) that contains the well-known binary representation of the resulting multilinestring. If the well-known binary representation is null, then null is returned.
shape: A value of type BLOB(4M) that contains the shape representation of the resulting multilinestring. If the shape representation is null, then null is returned.
gml: A value of type CLOB(8M) that contains the GML representation of the geometry. If the GML representation is null, then null is returned.
srs_id: A value of type INTEGER that identifies the spatial reference system for the resulting multilinestring.
If srs_id does not identify a spatial reference system listed in the catalog view DB2GSE.ST_SPATIAL_REFERENCE_SYSTEMS, an error is returned (SQLSTATE 38SU1).

Return type for variation 1

db2gse.ST_MultiLineString

Syntax for variation 2

Variation 2

Parameter for variation 2

geometry: A value of type ST_Geometry.

Return type for variation 2

ST_MultiLineString

Examples

In the following example, the lines of results have been reformatted for readability.

This example illustrates how ST_MultiLineString can be used to create and insert a multilinestring from its well-known text representation. The record that is inserted has ID = 1110, and the geometry is a multilinestring in spatial reference system 1. The multilinestring is in the well-known text representation of a multilinestring. The X and Y coordinates for this geometry are:

Line 1: (33, 2) (34, 3) (35, 6)
Line 2: (28, 4) (29, 5) (31, 8) (43, 12)
Line 3: (39, 3) (37, 4) (36, 7)


SET CURRENT PATH = CURRENT PATH, db2gse;
CREATE TABLE sample_mlines (id INTEGER, 
                            geometry ST_MultiLineString);

INSERT INTO sample_mlines
  VALUES (1110,
          ST_MultiLineString ('multilinestring ( (33 2, 34 3, 35 6),
                                       (28 4, 29 5, 31 8, 43 12),
                                       (39 3, 37 4, 36 7) )', 1) );

The following SELECT statement returns the multilinestring that was recorded in the table:


SELECT id,
       CAST( ST_AsText( geometry ) AS VARCHAR(280) )
  MULTI_LINE_STRING
  FROM sample_mlines
  WHERE id = 1110;

Results:


ID         MULTI_LINE_STRING
------- --------------------------------------------------------------------
   1110 MULTILINESTRING (( 33.000000 2.000000, 34.000000 3.000000,
              35.000000 6.000000),
                         ( 28.000000 4.000000, 29.000000 5.000000,
              31.000000 8.000000, 43.000000 12.000000),
                         ( 39.000000 3.000000, 37.000000 4.000000,
              36.000000 7.000000 ))