名前

ST_StartM — LINESTRING, CIRCULARLINESTRING, NURBSCURVE の最初のポイントのM値を返します。

概要

float8 ST_StartM(geometry geom);

説明

LINESTRING, CIRCULARLINESTRING, NURBSCURVEジオメトリーの最初のポイントのM値を返します。入力ジオメトリーがM値を持っていないか、LINESTRING, CIRCULARLINESTRING, NURBSCURVEのいずれえでもない場合には、 NULLが返ります。

このメソッドは曲線ストリングと曲線に対応しています。

LINESTRINGの最初のM値

Code
SELECT ST_StartM('LINESTRING M(0 0 10,1 1 20,2 0 30)'::geometry);
出力:
10
Figure
Geometry figure for visual-st-startm-01

CIRCULARSTRINGの最初のM値

Code
SELECT ST_StartM('CIRCULARSTRING M(0 0 5,1 1 10,2 0 15)'::geometry);
出力:
5
Figure
Geometry figure for visual-st-startm-02

NURBSCURVEの最初のM値

Code
SELECT ST_StartM('NURBSCURVE M(2, (0 0 100, 1 1 200, 2 0 300))'::geometry);
出力:
100
Figure
Geometry figure for visual-st-startm-03

M値を持たないジオメトリーについてはNULLを返します

Code
SELECT ST_StartM('LINESTRING(0 0,1 1)'::geometry) IS NULL AS is_null;
出力:
t
Figure
Geometry figure for visual-st-startm-04