curve-expression.ST_Length([ unit-name])

ST_Length 方法返回以通过 unit-name 参数确定的单位表示的曲线长度。如果曲线为空，则返回 NULL。

如果曲线包含 Z 值，计算几何长度时不考虑这些值。

• 类型 ST_MultiCurve 的 ST_Length 方法

以下示例返回结果 [2]。

SELECT NEW ST_LineString( 'LineString(1 0, 1 1, 2 1)' ).ST_Length()

以下示例创建表示半圆的圆弧线串，并使用 ST_Length 确定几何长度，返回值 PI。

SELECT NEW ST_CircularString( 'CircularString( 0 0, 1 1, 2 0 )' ).ST_Length()

以下示例创建表示从加拿大诺瓦斯克提亚省哈利法克斯到加拿大安大略省沃特卢的路径的线串，并使用 ST_Length 确定该路径以米表示的长度，返回结果 [1361967.76789]。

SELECT NEW ST_LineString( 'LineString( -63.573566 44.646244, -80.522372 43.465187 )', 4326 )
		.ST_Length()

以下示例创建空线串，并使用 ST_Length 确定几何长度。该示例返回 NULL。

begin
    declare @curve ST_Curve;
    set @curve = NEW ST_LineString('LineString EMPTY');
    SELECT @curve.ST_Length('metre');
end

以下示例创建线串和示例测量单位 (example_unit_halfmetre)。ST_Length 方法确定以此测量单位表示的几何长度，返回值 4.0。

begin
    declare @curve ST_Curve;
    CREATE SPATIAL UNIT OF MEASURE IF NOT EXISTS  "example_unit_halfmetre" TYPE LINEAR CONVERT USING .5;
    set @curve = NEW ST_LineString( 'LineString(1 0, 1 1, 2 1)' ) ;
    SELECT @curve.ST_Length('example_unit_halfmetre');
end