ST_Disjoint
ST_Disjoint returns true if the 2D projections of the two input geometries have no points in common.
Syntax
ST_Disjoint(geom1, geom2)
Arguments
- geom1
-
A value of data type
GEOMETRY
or an expression that evaluates to aGEOMETRY
type. - geom2
-
A value of data type
GEOMETRY
or an expression that evaluates to aGEOMETRY
type.
Return type
BOOLEAN
If geom1 or geom2 is null, then null is returned.
If geom1 and geom2 don't have the same value for the spatial reference system identifier (SRID), then an error is returned.
If geom1 or geom2 is a geometry collection, then an error is returned.
Examples
The following SQL checks if the first polygon is disjoint from the second polygon.
SELECT ST_Disjoint(ST_GeomFromText('POLYGON((0 0,10 0,10 10,0 10,0 0),(2 2,2 5,5 5,5 2,2 2))'), ST_Point(4, 4));
st_disjoint
-----------
true