ST_Contains

ST_Contains renvoie true si la projection 2D de la première géométrie en entrée contient la projection 2D de la deuxième géométrie en entrée. La géométrie A contient la géométrie B si chaque point dans B est un point dans A, et leur intérieur comporte une intersection non vide.

ST_Contains(A, B) équivaut à ST_Within(B, A).

Syntaxe

ST_Contains(geom1, geom2)

Arguments

geom1

Valeur de type de données GEOMETRY ou expression qui est évaluée sur un type GEOMETRY.

geom2

Valeur de type de données GEOMETRY ou expression qui est évaluée sur un type GEOMETRY. Cette valeur est comparée à geom1 afin de déterminer si elle est contenue dans geom1.

Type de retour

BOOLEAN

Si geom1 ou geom2 est null, null est renvoyé.

Si geom1 et geom2 n’ont pas la même valeur pour l’identifiant de système de référence spatiale (SRID), une erreur est renvoyée.

Si geom1 ou geom2 est une collection géométrique, une erreur est renvoyée.

Exemples

Le SQL suivant vérifie si le premier polygone contient le deuxième polygone.

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