名称

ST_Force3D — 强制将几何图形转换为 XYZ 模式。这是 ST_Force3DZ 的别名。

语法

geometry ST_Force3D(geometry geomA, float Zvalue = 0.0);

说明

强制将几何图形转换为 XYZ 模式。这是 ST_Force3DZ 的别名。如果几何图形没有 Z 组件,则会附加一个 Zvalue Z 坐标。

增强:2.0.0 引入了对多面体的支持。

已更改:2.1.0。在 2.0.x 之前,这称为 ST_Force_3D。

已更改:3.1.0。添加了对提供非零 Z 值的支持。

此函数支持多面体。

此方法支持圆形字符串和曲线。

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

示例

		--Nothing happens to an already 3D geometry
		SELECT ST_AsEWKT(ST_Force3D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
				   st_asewkt
-----------------------------------------------
 CIRCULARSTRING(1 1 2,2 3 2,4 5 2,6 7 2,5 6 2)


SELECT  ST_AsEWKT(ST_Force3D('POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))'));

						 st_asewkt
--------------------------------------------------------------
 POLYGON((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))
		

另请参阅

ST_AsEWKTST_Force2DST_Force3DMST_Force3DZ