Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
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
GEOMETRYou expression qui est évaluée sur un typeGEOMETRY. - geom2
-
Valeur de type de données
GEOMETRYou expression qui est évaluée sur un typeGEOMETRY. 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
