Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
ST_Within
ST_Within gibt true zurück, wenn die 2D-Projektion der ersten Eingabegeometrie innerhalb der 2D-Projektion der zweiten Eingabegeometrie liegt.
Die Geometrie A liegt beispielsweise innerhalb der Geometrie B, wenn jeder Punkt in A ein Punkt in B ist und ihre Innenräume einen nicht leeren Schnittpunkt haben.
ST_Within(A, B) entspricht ST_Contains(B, A).
Syntax
ST_Within(geom1, geom2)
Argumente
- geom1
-
Ein Wert vom Datentyp
GEOMETRYoder ein Ausdruck, der zu einemGEOMETRY-Typ ausgewertet wird. Dieser Wert wird mit geom2 verglichen, um festzustellen, ob er innerhalb von geom2 liegt. - geom2
-
Ein Wert vom Datentyp
GEOMETRYoder ein Ausdruck, der zu einemGEOMETRY-Typ ausgewertet wird.
Rückgabetyp
BOOLEAN
Wenn geom1 oder geom2 null ist, wird null zurückgegeben.
Wenn geom1 und geom2 nicht den gleichen SRID-Wert (Spatial Reference System Identifier) haben, wird ein Fehler zurückgegeben.
Wenn geom1 oder geom2 eine Geometrie-Collection ist, wird ein Fehler zurückgegeben.
Beispiele
Das folgende SQL prüft, ob das erste Polygon innerhalb des zweiten Polygons liegt.
SELECT ST_Within(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'));
st_within
-----------
true
