ST_LINEFROMTEXT

説明

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

エイリアス

• ST_LINESTRINGFROMTEXT

構文

ST_LINEFROMTEXT( <wkt>)

パラメータ

パラメータ	説明
<wkt>	LINE型に準拠したWKT文字列。以下の形式で記述されます：
"LINE (x1 y1, x2 y2)"
ここで、(x1 y1)、(x2 y2)は線分の頂点座標です。座標値は数値（整数または小数）です。

戻り値

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

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

例

通常の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                                    |
+-----------------------------------------+

無効なWKT（頂点が多すぎます）

mysql> SELECT ST_LineFromText("LINESTRING (1 1,2 2,3 3)");
+---------------------------------------------------------------------------------+
| ST_LineFromText("LINESTRING (1 1,2 2,3 3)")                                     |
+---------------------------------------------------------------------------------+
|     ��_<���?'���Xޑ?݉+
                       ߑ?�����?(Qjm�ۡ?'���Xޡ?�3|ʏ��?lW<�`ª?��H�˪?       |
+---------------------------------------------------------------------------------+

入力がNULL

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