通过2D框以快速方式裁剪Geometry对象。

语法

geometry  ST_ClipByBox2D(geometry  geom , box2d  box);

参数

参数名称 描述
geom 目标Geometry对象。
box 裁剪所用的Box2d对象。

描述

  • 无法保证输出几何形状有效（可能会引入多边形的自相交）。
  • 带有拓扑错误的Geometry对象不会引发异常。

示例

默认调用：
SELECT ST_AsText(ST_ClipByBox2D('LINESTRING(0 1,2 1)'::geometry,ST_MakeEnvelope(0,0,1,2)));
      st_astext
---------------------
 LINESTRING(0 1,1 1)
(1 row)
1