名称

ST_DumpRings — 返回多边形的外部和内部环的一组 geometry_dump 行。

语法

geometry_dump[] ST_DumpRings(geometry a_polygon);

说明

一个集返回函数 (SRF),用于提取多边形的环。它返回一组 geometry_dump 行,每行包含一个几何 (geom 字段) 和一个整数数组 (path 字段)。

geom 字段将每个环作为多边形包含。 path 字段是一个长度为 1 的整数数组,包含多边形环索引。外部环 (外壳) 的索引为 0。内部环 (孔) 的索引为 1 及更高。

[Note]

这仅适用于多边形几何。它不适用于多面体

可用性:PostGIS 1.1.3。需要 PostgreSQL 7.3 或更高版本。

此函数支持 3d,并且不会丢弃 z 索引。

示例

查询的一般形式。

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

带有一个孔的多边形。

SELECT path, ST_AsEWKT(geom) As geom
	FROM ST_DumpRings(
		ST_GeomFromEWKT('POLYGON((-8149064 5133092 1,-8149064 5132986 1,-8148996 5132839 1,-8148972 5132767 1,-8148958 5132508 1,-8148941 5132466 1,-8148924 5132394 1,
		-8148903 5132210 1,-8148930 5131967 1,-8148992 5131978 1,-8149237 5132093 1,-8149404 5132211 1,-8149647 5132310 1,-8149757 5132394 1,
		-8150305 5132788 1,-8149064 5133092 1),
		(-8149362 5132394 1,-8149446 5132501 1,-8149548 5132597 1,-8149695 5132675 1,-8149362 5132394 1))')
		)  as foo;
 path |                                            geom
----------------------------------------------------------------------------------------------------------------
  {0} | POLYGON((-8149064 5133092 1,-8149064 5132986 1,-8148996 5132839 1,-8148972 5132767 1,-8148958 5132508 1,
	  |          -8148941 5132466 1,-8148924 5132394 1,
	  |          -8148903 5132210 1,-8148930 5131967 1,
	  |          -8148992 5131978 1,-8149237 5132093 1,
	  |          -8149404 5132211 1,-8149647 5132310 1,-8149757 5132394 1,-8150305 5132788 1,-8149064 5133092 1))
  {1} | POLYGON((-8149362 5132394 1,-8149446 5132501 1,
	  |          -8149548 5132597 1,-8149695 5132675 1,-8149362 5132394 1))

另请参见

geometry_dump第 12.6 节,“PostGIS 几何/地理/栅格转储函数”ST_DumpST_ExteriorRingST_InteriorRingN