本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
ST_Contains
如果第一个输入几何体包含第二个输入几何体,则 ST_Contains 返回 true。如果 B
中的每个点均为 A
中的一个点,并且其内部有非空相交区域,则几何体 A
包含几何体 B
。
ST_Contains(A
, B
) 与 ST_Within(B
, A
) 等效。
Syntax
ST_Contains(geom1, geom2)
Arguments
- geom1
-
一个
GEOMETRY
数据类型的值,或一个计算结果为GEOMETRY
类型的表达式。 - geom2
-
一个
GEOMETRY
数据类型的值,或一个计算结果为GEOMETRY
类型的表达式。此值将与 geom1 进行比较以确定它是否包含在 geom1 中。
返回类型
BOOLEAN
如果 geom1 或 geom2 为 null,则返回 null。
如果 geom1 和 geom2 不具有相同的空间参考系统标识符 (SRID) 值,则返回一个错误。
如果 geom1 或 geom2 为几何体集合,则返回一个错误。
Examples
以下 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