ST_DumpRings
Prev  7.4. Geometrische Zugriffsfunktionen  Next

Name

ST_DumpRings — Gibt einen Satz von geometry_dump Zeilen für die äußeren und inneren Ringe eines Polygons zurück.

Synopsis

geometry_dump[] ST_DumpRings(geometry a_polygon);

Beschreibung

Eine Funktion, die eine Menge zurückgibt (SRF), die die Ringe eines Polygons extrahiert. Sie gibt einen Satz von geometry_dump Zeilen zurück, die jeweils eine Geometrie (geom Feld) und eine Reihe von Ganzzahlen (path Feld) enthalten.

Das Feld geom enthält jeden Ring als POLYGON. Das Feld path ist ein ganzzahliges Feld der Länge 1, das den Polygonringindex enthält. Der äußere Ring (Schale) hat den Index 0. Die inneren Ringe (Löcher) haben Indizes von 1 und höher.

[Note]

This only works for POLYGON geometries, not MULTIPOLYGONs. Use ST_Dump to extract polygon elements from polygonal geometries: ST_DumpRings( (ST_Dump(geom)).geom )

Verfügbarkeit: PostGIS 1.1.3. Benötigt PostgreSQL 7.3 oder höher.

Diese Funktion unterstützt 3d und lässt den Z-Index nicht fallen.

Beispiele

Extracting all rings as polygons.

SELECT polyTable.field1, polyTable.field1,
          (ST_DumpRings(polyTable.geom)).geom As geom
FROM polyTable

Extracting shell and holes from a polygon.

SELECT path, ST_AsText(geom) As geom
        FROM ST_DumpRings(
                    'POLYGON ((1 9, 9 9, 9 1, 1 1, 1 9), (2 2, 2 3, 3 3, 3 2, 2 2), (4 2, 4 4, 6 4, 6 2, 4 2))');

 path |              geom              
------+--------------------------------
 {0}  | POLYGON((1 9,9 9,9 1,1 1,1 9))
 {1}  | POLYGON((2 2,2 3,3 3,3 2,2 2))
 {2}  | POLYGON((4 2,4 4,6 4,6 2,4 2))