Skip to content

适用虚谷数据库版本

v12.9



适用虚谷数据库版本

v12.9


ST_CLIPBYBOX2D

📄字数 308
👁️阅读量 加载中...

功能描述

以快速且宽松但可能无效的方式通过 2D 框剪切几何体。

语法格式

sql
GEOMETRY ST_CLIPBYBOX2D(GEOMETRY geom, BOX2D box);

参数说明

  • geom:目标 GEOMETRY 对象。
  • box:裁剪所用的 BOX2D 对象。

函数返回类型

GEOMETRY 类型

使用说明

  1. 拓扑上无效的输入几何图形不会导致抛出异常。
  2. 不保证输出几何图形有效(特别是,可能会引入多边形的自相交)。
  3. 这个函数是由 GEOS 模块执行的。

示例

sql
SQL> SELECT ST_AsText(ST_ClipByBox2D('LINESTRING(0 1,2 1)'::geometry,ST_MakeEnvelope(0,0,1,2)));

+---------------------+
|        EXPR1        |
+---------------------+
| LINESTRING(0 1,1 1) |
+---------------------+

(1 row)