如果Geometry對象A包含Geometry對象B,則返回True。
語法
boolean ST_Contains(geometry geomA , geometry geomB);
參數
參數名稱 | 描述 |
---|---|
geomA | 第一個Geometry對象。 |
geomB | 第二個Geometry對象。 |
描述
- 當且僅當B對象的點不位于A的外部且B內部至少存在一個點位于A內部時,A對象才包含B對象:
- A不包含其邊界,但包含其自身。
- 當使用ST_ContainsProperly函數時,A不包含其自身。
- 兩個Geometry對象必須都具有相同的投影方式,并且具有相同的SRID。
- ST_Contains函數是ST_Within的反函數。
ST_Contains(A,B)與ST_Within(B,A)結果一致,除非輸入的Geometry對象是無效的Geometry對象。
- 該函數不支持GeometryCollection類型對象作為輸入參數。
- 該函數會自動生成一個bounding box用于利用Geometry對象上的索引。如果不想使用索引,請使用函數_ST_Contains。
示例
SELECT ST_Contains('POLYGON((0 0,0 3,3 0,0 0))'::geometry,'POLYGON((0 0,0 1,1 0,0 0))'::geometry);
st_contains
-------------
t
(1 row)