ST_ContainsProperly

両方の入力ジオメトリが空ではなく、2 番目のジオメトリにおける 2D 射影のすべてのポイントが、1 番目のジオメトリにおける 2D 射影の内部ポイントである場合、ST_ContainsProperly は true を返します。

構文

ST_ContainsProperly(geom1, geom2)

引数

geom1

データ型 GEOMETRY の値または GEOMETRY 型と評価される式の値。サブタイプは GEOMETRYCOLLECTION にすることはできません。

geom2

データ型 GEOMETRY の値または GEOMETRY 型と評価される式の値。サブタイプは GEOMETRYCOLLECTION にすることはできません。この値を geom1 と比較して、そのすべてのポイントが geom1 の内部ポイントであるかどうかを判断します。

戻り型

BOOLEAN

geom1 または geom2 が null の場合、null が返されます。

geom1 および geom2 の空間リファレンスシステム識別子 (SRID) が同じ値でない場合、エラーが返されます。

geom1 または geom2 がジオメトリコレクションである場合、エラーが返されます。

例

次の SQL は、ST_Contains および ST_ContainsProperly の値を返します。ここで、入力ライン文字列は、入力ポリゴンの内部と境界で交差しますが、外部では交差しません。ポリゴンにはライン文字列が含まれていますが、含まれているライン文字列が正しくありません。

WITH tmp(g1, g2) 
AS (SELECT ST_GeomFromText('POLYGON((0 0,10 0,10 10,0 10,0 0))'), ST_GeomFromText('LINESTRING(5 5,10 5,10 6,5 5)')) SELECT ST_Contains(g1, g2), ST_ContainsProperly(g1, g2) 
FROM tmp;

 st_contains | st_containsproperly 
-------------+---------------------
 t           | f