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。
• 若输入 为 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                  |
+-----------------------+