ST_Contains

ST_Contains 會在第一個輸入幾何的 2D 投影包含第二個輸入幾何的 2D 投影時傳回 true。如果 B 中的每個點都是 A 中的點，且其內部包含非空白的交集，則幾何 A 包含幾何 B。

ST_Contains(A, B) 與 ST_Within(B, A) 相等。

語法

ST_Contains(geom1, geom2)

引數

geom1

GEOMETRY 資料類型的值，或是評估為 GEOMETRY 類型的表達式。

geom2

GEOMETRY 資料類型的值，或是評估為 GEOMETRY 類型的表達式。這個值會和 geom1 比較，以判斷其是否包含在 geom1 中。

傳回類型

BOOLEAN

如果 geom1 或 geom2 為 Null，則會傳回 Null。

如果 geom1 和 geom2 的空間參考系統識別碼 (SRID) 不同，則會傳回錯誤。

如果 geom1 或 geom2 是幾何集合，則會傳回錯誤。

範例

以下 SQL 會檢查第一個多邊形是否包含第二個多邊形。

SELECT ST_Contains(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'));

st_contains
-----------
 false