書式
SDO_LRS.MEASURE_TO_PERCENTAGE( geom_segment IN SDO_GEOMETRY, measure IN NUMBER ) RETURN NUMBER;
または
SDO_LRS.MEASURE_TO_PERCENTAGE( geom_segment IN SDO_GEOMETRY, dim_array IN SDO_DIM_ARRAY, measure IN NUMBER ) RETURN NUMBER;
説明
ジオメトリ・セグメントのメジャー範囲に対する指定したメジャーの割合(0から100%)を戻します。
パラメータ
線形フィーチャの地図的表現を指定します。
geom_segment
に対応する次元情報の配列を指定します。通常、xxx_SDO_GEOM_METADATAビューの1つから選択します(「ジオメトリのメタデータ・ビュー」を参照)。
メジャー値を指定します。このファンクションは、メジャー範囲に対するメジャー値の割合を戻します。
使用上の注意
このファンクションは、指定したメジャーが表すメジャー範囲に対する割合を、0から100の数字で戻します。(メジャー範囲は終了メジャーから開始メジャーを引いた値です。)たとえば、geom_segment
のメジャー範囲が50でmeasure
が20の場合、ファンクションは40を戻します(20/50 = 40%)。
このファンクションは、割合の値に対応するメジャーを戻すSDO_LRS.PERCENTAGE_TO_MEASUREファンクションとは逆に動作します。
geom_segment
またはmeasure
が無効な場合、例外が発生します。
例
次の例では、ジオメトリ・セグメントRoute 1のメジャー範囲に対する5の割合を戻します。(例では、「LRSファンクションの例」の例の定義を使用しています。)このセグメントのメジャー範囲は27で、5は27の約18.5%です。
SELECT SDO_LRS.MEASURE_TO_PERCENTAGE(a.route_geometry, m.diminfo, 5) FROM lrs_routes a, user_sdo_geom_metadata m WHERE m.table_name = 'LRS_ROUTES' AND m.column_name = 'ROUTE_GEOMETRY' AND a.route_id = 1; SDO_LRS.MEASURE_TO_PERCENTAGE(A.ROUTE_GEOMETRY,M.DIMINFO,5) ----------------------------------------------------------- 18.5185185