12.16.3 从 WKT 值创建几何值的函数
这些函数将熟知文本(WKT)table 示形式以及可选的空间参考系统标识符(SRID)作为参数。它们返回相应的几何。
ST_GeomFromText()接受任何几何类型的 WKT 值作为其第一个参数。其他功能提供了特定于类型的构造功能,用于构造每种几何类型的几何值。
有关 WKT 格式的说明,请参见众所周知的文本(WKT)格式。
GeomCollFromText(wkt[, srid]), GeometryCollectionFromText(wkt[, srid])
ST_GeomCollFromText(),ST_GeometryCollectionFromText(),ST_GeomCollFromTxt(),GeomCollFromText()和GeometryCollectionFromText()是同义词。有关更多信息,请参见ST_GeomCollFromText()的描述。
GeomCollFromText()和GeometryCollectionFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_GeomCollFromText()和ST_GeometryCollectionFromText()。
GeomFromText(wkt[, srid]), GeometryFromText(wkt[, srid])
ST_GeomFromText(),ST_GeometryFromText(),GeomFromText()和GeometryFromText()是同义词。有关更多信息,请参见ST_GeomFromText()的描述。
GeomFromText()和GeometryFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_GeomFromText()和ST_GeometryFromText()。
LineFromText(wkt[, srid]), LineStringFromText(wkt[, srid])
ST_LineFromText(),ST_LineStringFromText(),LineFromText()和LineStringFromText()是同义词。有关更多信息,请参见ST_LineFromText()的描述。
LineFromText()和LineStringFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_LineFromText()和ST_LineStringFromText()。
MLineFromText(wkt[, srid]), MultiLineStringFromText(wkt[, srid])
ST_MLineFromText(),ST_MultiLineStringFromText(),MLineFromText()和MultiLineStringFromText()是同义词。有关更多信息,请参见ST_MLineFromText()的描述。
MLineFromText()和MultiLineStringFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_MLineFromText()和ST_MultiLineStringFromText()。
MPointFromText(wkt[, srid]), MultiPointFromText(wkt[, srid])
ST_MPointFromText(),ST_MultiPointFromText(),MPointFromText()和MultiPointFromText()是同义词。有关更多信息,请参见ST_MPointFromText()的描述。
MPointFromText()和MultiPointFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_MPointFromText()和ST_MultiPointFromText()。
MPolyFromText(wkt[, srid]), MultiPolygonFromText(wkt[, srid])
ST_MPolyFromText(),ST_MultiPolygonFromText(),MPolyFromText()和MultiPolygonFromText()是同义词。有关更多信息,请参见ST_MPolyFromText()的描述。
MPolyFromText()和MultiPolygonFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_MPolyFromText()和ST_MultiPolygonFromText()。
ST_PointFromText()和PointFromText()是同义词。有关更多信息,请参见ST_PointFromText()的描述。
PointFromText()已过时,将在以后的 MySQL 版本中删除。请改用ST_PointFromText()。
PolyFromText(wkt[, srid]), PolygonFromText(wkt[, srid])
ST_PolyFromText(),ST_PolygonFromText(),PolyFromText()和PolygonFromText()是同义词。有关更多信息,请参见ST_PolyFromText()的描述。
PolyFromText()和PolygonFromText()已被弃用,并将在将来的 MySQL 版本中删除。请改用ST_PolyFromText()和ST_PolygonFromText()。
ST_GeomCollFromText(wkt[, srid]), ST_GeometryCollectionFromText(wkt[, srid]), ST_GeomCollFromTxt(wkt[, srid])
使用其 WKTtable 示形式和 SRID 构造一个GeometryCollection
值。
如果 geometry 参数为NULL
或语法上格式不正确的几何,或者 SRID 参数为NULL
,则返回值为NULL
。
mysql> SET @g = "MULTILINESTRING((10 10, 11 11), (9 9, 10 10))";
mysql> SELECT ST_AsText(ST_GeomCollFromText(@g));
+--------------------------------------------+
| ST_AsText(ST_GeomCollFromText(@g)) |
+--------------------------------------------+
| MULTILINESTRING((10 10,11 11),(9 9,10 10)) |
+--------------------------------------------+
ST_GeomCollFromText(),ST_GeometryCollectionFromText(),ST_GeomCollFromTxt(),GeomCollFromText()和GeometryCollectionFromText()是同义词。
ST_GeomFromText(wkt[, srid]), ST_GeometryFromText(wkt[, srid])
使用其 WKTtable 示形式和 SRID 构造任何类型的几何值。
如果 geometry 参数为NULL
或语法上格式不正确的几何,或者 SRID 参数为NULL
,则返回值为NULL
。
ST_GeomFromText(),ST_GeometryFromText(),GeomFromText()和GeometryFromText()是同义词。
ST_LineFromText(wkt[, srid]), ST_LineStringFromText(wkt[, srid])
使用其 WKTtable 示形式和 SRID 构造一个LineString
值。
如果 geometry 参数为NULL
或语法上格式不正确的几何,或者 SRID 参数为NULL
,则返回值为NULL
。
ST_LineFromText(),ST_LineStringFromText(),LineFromText()和LineStringFromText()是同义词。
ST_MLineFromText(wkt[, srid]), ST_MultiLineStringFromText(wkt[, srid])
使用其 WKTtable 示形式和 SRID 构造一个MultiLineString
值。
如果 geometry 参数为NULL
或语法上格式不正确的几何,或者 SRID 参数为NULL
,则返回值为NULL
。
ST_MLineFromText(),ST_MultiLineStringFromText(),MLineFromText()和MultiLineStringFromText()是同义词。
ST_MPointFromText(wkt[, srid]), ST_MultiPointFromText(wkt[, srid])
使用其 WKTtable 示形式和 SRID 构造一个MultiPoint
值。
如果 geometry 参数为NULL
或语法上格式不正确的几何,或者 SRID 参数为NULL
,则返回值为NULL
。
接受MultiPoint
值的 WKT 格式 table 示的ST_MPointFromText()和ST_GeomFromText()之类的函数允许用括号将值内的各个点括起来。例如,以下两个函数调用均有效:
ST_MPointFromText('MULTIPOINT (1 1, 2 2, 3 3)')
ST_MPointFromText('MULTIPOINT ((1 1), (2 2), (3 3))')
ST_MPointFromText(),ST_MultiPointFromText(),MPointFromText()和MultiPointFromText()是同义词。
ST_MPolyFromText(wkt[, srid]), ST_MultiPolygonFromText(wkt[, srid])
使用其 WKTtable 示形式和 SRID 构造一个MultiPolygon
值。
如果 geometry 参数为NULL
或语法上格式不正确的几何,或者 SRID 参数为NULL
,则返回值为NULL
。
ST_MPolyFromText(),ST_MultiPolygonFromText(),MPolyFromText()和MultiPolygonFromText()是同义词。
使用其 WKTtable 示形式和 SRID 构造一个Point
值。
如果 geometry 参数为NULL
或语法上格式不正确的几何,或者 SRID 参数为NULL
,则返回值为NULL
。
ST_PointFromText()和PointFromText()是同义词。
ST_PolyFromText(wkt[, srid]), ST_PolygonFromText(wkt[, srid])
使用其 WKTtable 示形式和 SRID 构造一个Polygon
值。
如果 geometry 参数为NULL
或语法上格式不正确的几何,或者 SRID 参数为NULL
,则返回值为NULL
。
ST_PolyFromText(),ST_PolygonFromText(),PolyFromText()和PolygonFromText()是同义词。