名稱

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))