如果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)