Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
ST_Contains
ST_Contains restituisce true se la proiezione 2D della prima geometria di input contiene la proiezione 2D della seconda geometria di input. L'oggetto geometrico A
contiene l'oggetto geometrico B
se ogni punto di B
è un punto di A
, e le loro aree interne presentano un'intersezione non vuota.
ST_Contains(A
, B
) è equivalente a ST_Within(B
, A
).
Sintassi
ST_Contains(geom1, geom2)
Argomenti
- geom1
-
Un valore di tipo
GEOMETRY
o un'espressione che restituisce un valore di tipoGEOMETRY
. - geom2
-
Un valore di tipo
GEOMETRY
o un'espressione che restituisce un valore di tipoGEOMETRY
. Questo valore è confrontato con geom1 per determinare se è contenuto all'interno di geom1.
Tipo restituito
BOOLEAN
Se geom1 o geom2 sono nulli, allora viene restituito il valore nullo.
Se geom1 e geom2 non presentano lo stesso valore di identificatore del sistema di riferimento spaziale (SRID), allora viene restituito il valore nullo.
Se geom1 o geom2 sono una collezione di geometrie, allora viene restituito il valore nullo.
Esempi
Il seguente comando SQL verifica se il primo poligono contiene il secondo poligono.
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