メインコンテンツまでスキップ
バージョン: 4.x

ST_LINEFROMTEXT

説明​

WKT（Well Known Text）文字列をLineのメモリ内表現に変換します

エイリアス​

  • ST_LINESTRINGFROMTEXT

構文​

ST_LINEFROMTEXT( <wkt>)

Parameters​

ParametersDescription
<wkt>LINESTRING型に準拠するWKT文字列。以下の形式でフォーマットされます：
"LINESTRING (x1 y1, x2 y2)"
ここで(x1 y1)、(x2 y2)は線分の頂点座標です。座標値は数値（整数または小数）です。

戻り値​

Line型の幾何オブジェクトを返します。これはDorisの内部空間データ形式でメモリに格納されます。他の空間関数（ST_LENGTH、ST_INTERSECTSなど）のパラメータとして直接渡して計算に使用できます。

  • 入力されたWKT文字列が無効な場合（頂点が2個未満、構文エラー、非数値座標など）、NULLを返します。
  • <wkt>がNULLまたは空文字列の場合、NULLを返します。

Example​

通常のLINE型

mysql> SELECT ST_AsText(ST_LineFromText("LINESTRING (1 1, 2 2)"));
+-----------------------------------------------------+
| ST_AsText(ST_LineFromText("LINESTRING (1 1, 2 2)")) |
+-----------------------------------------------------+
| LINESTRING (1 1, 2 2)                               |
+-----------------------------------------------------+

無効なWKT（頂点数不足）

mysql> SELECT ST_LineFromText("LINESTRING (1 1)");
+-------------------------------------+
| ST_LineFromText("LINESTRING (1 1)") |
+-------------------------------------+
| NULL                                |
+-------------------------------------+

無効なWKT（構文エラー）

mysql> SELECT ST_LineFromText("LINESTRING (1 1, 2 2");
+-----------------------------------------+
| ST_LineFromText("LINESTRING (1 1, 2 2") |
+-----------------------------------------+
| NULL                                    |
+-----------------------------------------+

複数の頂点を持つLineString

mysql> SELECT ST_AsText(ST_LineFromText('LINESTRING (1 1, 2 2)'));
+-----------------------------------------------------+
| ST_AsText(ST_LineFromText('LINESTRING (1 1, 2 2)')) |
+-----------------------------------------------------+
| LINESTRING (1 1, 2 2)                               |
+-----------------------------------------------------+

入力 NULL

mysql> SELECT ST_LineFromText(NULL);
+-----------------------+
| ST_LineFromText(NULL) |
+-----------------------+
| NULL                  |
+-----------------------+