ST_CONTAINS

引入或更新于：v1.2.564

如果第二个 GEOMETRY 对象完全位于第一个 GEOMETRY 对象内部，则返回 TRUE。

语法

ST_CONTAINS(<geometry1>, <geometry2>)

参数

参数	描述
<geometry1>	参数必须是 GEOMETRY 对象类型的表达式，且不能是 GeometryCollection。
<geometry2>	参数必须是 GEOMETRY 对象类型的表达式，且不能是 GeometryCollection。

备注

• 如果两个输入的 GEOMETRY 对象具有不同的 SRID，则函数会报告错误。

返回类型

布尔值（Boolean）。

示例

SELECT ST_CONTAINS(TO_GEOMETRY('POLYGON((-2 0, 0 2, 2 0, -2 0))'), TO_GEOMETRY('POLYGON((-1 0, 0 1, 1 0, -1 0))')) AS contains

┌──────────┐
│ contains │
├──────────┤
│ true     │
└──────────┘

SELECT ST_CONTAINS(TO_GEOMETRY('POLYGON((-2 0, 0 2, 2 0, -2 0))'), TO_GEOMETRY('LINESTRING(-1 1, 0 2, 1 1)')) AS contains

┌──────────┐
│ contains │
├──────────┤
│ false    │
└──────────┘

SELECT ST_CONTAINS(TO_GEOMETRY('POLYGON((-2 0, 0 2, 2 0, -2 0))'), TO_GEOMETRY('LINESTRING(-2 0, 0 0, 0 1)')) AS contains

┌──────────┐
│ contains │
├──────────┤
│ true     │
└──────────┘