24.17 SDO_LRS.GEOM_SEGMENT_LENGTH

書式

SDO_LRS.GEOM_SEGMENT_LENGTH(
     geom_segment IN SDO_GEOMETRY 
     [, dim_array IN SDO_DIM_ARRAY] 
     ) RETURN NUMBER;

説明

ジオメトリ・セグメントの長さを戻します。

パラメータ

geom_segment

長さを算出するジオメトリ・セグメントを指定します。

dim_array

geom_segmentに対応する次元情報の配列を指定します。通常、xxx_SDO_GEOM_METADATAビューの1つから選択します(「ジオメトリのメタデータ・ビュー」を参照)。

使用上の注意

このファンクションは、geom_segmentの長さを戻します。長さはジオメトリの長さで、メジャー単位値の合計とは異なります。メジャー単位でのセグメントの長さを測るには、SDO_LRS.GEOM_SEGMENT_END_MEASURE操作の結果からSDO_LRS.GEOM_SEGMENT_START_MEASURE操作の結果を引きます。

geom_segmentに無効なジオメトリ・タイプまたは次元が含まれる場合、例外が発生します。

このファンクションは_3D 形式(SDO_LRS.GEOM_SEGMENT_LENGTH_3D)が使用可能です。LRSファンクションの3D形式については、「LRSファンクションの3D形式」を参照してください。

例

次の例では、ジオメトリ・セグメントRoute 1の長さを戻します。(例では、「LRSファンクションの例」の例の定義を使用しています。)

SELECT  SDO_LRS.GEOM_SEGMENT_LENGTH(route_geometry)
  FROM lrs_routes WHERE route_id = 1;

SDO_LRS.GEOM_SEGMENT_LENGTH(ROUTE_GEOMETRY)                                     
-------------------------------------------                                     
                                         27