path
平面上的几何路径
当前查看 PostgreSQL 18.6。
PG10–20 核心源码清单。类型转换与操作符类列出源码显式声明的关系;缺少记录不能排除通过其他机制进行转换或使用索引。
定义
平面上的几何路径
path
- 目录名称
- pg_catalog.path
- 类型 OID
- 602
- 类型种类
- 基础类型
- 声明长度
- 变长(varlena)
- 存储策略
- 扩展
- 输入函数
- path_in
- 输出函数
- path_out
- 手册中的声明
- path
- 存储大小
- 16+16n 字节
- 手册说明
- 闭合路径(类似多边形)
- 表示方式
- ((x1,y1),...)
- 手册说明
- 开放路径
- 表示方式
- [(x1,y1),...]
中文手册
阅读来源定义
8.8. 几何类型
8.8. 几何类型
几何数据类型表示二维的空间物体。表 8.20展示了PostgreSQL中可以用的几何类型。
表 8.20. 几何类型
| 名字 | 存储大小 | 说明 | 表示方式 |
|---|---|---|---|
point |
16 字节 | 平面上的点 | (x,y) |
line |
24 字节 | 无限直线 | {A,B,C} |
lseg |
32 字节 | 有限线段 | [(x1,y1),(x2,y2)] |
box |
32 字节 | 矩形框 | (x1,y1),(x2,y2) |
path |
16+16n 字节 | 闭合路径(类似多边形) | ((x1,y1),...) |
path |
16+16n 字节 | 开放路径 | [(x1,y1),...] |
polygon |
40+16n字节 | 多边形(类似于封闭路径) | ((x1,y1),...) |
circle |
24 字节 | 圆 | <(x,y),r>(圆心和半径) |
在所有这些类型中,单个坐标都以 double precision(float8)数值存储。
我们提供了丰富的函数和操作符来进行各种几何操作,例如缩放、平移、旋转以及求交等,详见第 9.11 节。
直线由线性方程Ax + By + C = 0 表示,其中A和B不能同时为零。类型line 的值采用以下形式输入和输出:
{ A, B, C }
另外,还可以用下列任一形式输入:
[ (x1,y1) , (x2,y2) ] ( (x1,y1) , (x2,y2) ) (x1,y1) , (x2,y2)x1,y1,x2,y2
其中 ( 和 x1,y1)( 是直线上不同的两点。x2,y2)
线段用其两个端点来表示。lseg类型的值用下面任一种语法指定:
[ (x1,y1) , (x2,y2) ] ( (x1,y1) , (x2,y2) ) (x1,y1) , (x2,y2)x1,y1,x2,y2
其中( 和 x1,y1)( 是线段的端点。x2,y2)
线段使用第一种语法输出。
方框用其对角的点对表示。box类型的值使用下面任一种语法指定:
( (x1,y1) , (x2,y2) ) (x1,y1) , (x2,y2)x1,y1,x2,y2
其中( 和 x1,y1)( 是方框的对角点。x2,y2)
方框使用第二种语法输出。
在输入时可以提供任意两个对角,但是值将根据需要被重新排列,并依次存储为右上角和左下角。
路径由一系列连接的点组成。路径可能是开放的,也就是认为列表中第一个点和最后一个点没有被连接起来;也可能是封闭的,这时认为第一个和最后一个点被连接起来。
path类型的值用下面任一种语法指定:
[ (x1,y1) , ... , (xn,yn) ] ( (x1,y1) , ... , (xn,yn) ) (x1,y1) , ... , (xn,yn) (x1,y1, ... ,xn,yn)x1,y1, ... ,xn,yn
其中的点是组成路径的线段的端点。方括弧([])表示一个开放的路径,圆括弧(())表示一个封闭的路径。如第三种到第五种语法所示,当最外面的圆括号被省略时,路径将被假定为封闭。
路径的输出视情况使用第一种或第二种语法。
多边形由点的列表来表示,这些点就是多边形的顶点。多边形与封闭路径非常相似;其本质语义差异在于,多边形被认为包含其内部区域,而路径则不包含。
多边形与路径在实现上的一个重要区别是,多边形的存储表示中包含其最小包围框。这会加快某些搜索操作,尽管在构造新多边形时,计算该包围框会带来额外开销。
polygon类型的值用下列任一种语法指定:
( (x1,y1) , ... , (xn,yn) ) (x1,y1) , ... , (xn,yn) (x1,y1, ... ,xn,yn)x1,y1, ... ,xn,yn
其中的点是组成多边形边界的线段的端点。
多边形的输出使用第一种语法。
圆由一个圆心和一个半径代表。circle类型的值用下面任一种语法指定:
< (x,y) ,r> ( (x,y) ,r) (x,y) ,rx,y,r
其中(是圆心,而x,y)r是圆的半径。
圆的输出用第一种语法。
系统目录属性
此构建的源码初始化值。字段含义参见 pg_type 。包含头文件默认值;依赖构建的常量保留符号形式,不作为服务器运行时实测。
oid602descrgeometric path, format '(point1,...)'typacl_null_typlen-1typelem0typnamepathtypsendpath_sendtyptypebtypaligndtyparray0typbyvalftypdelim','typinputpath_intypmodin-typndims0typownerPOSTGREStyprelid0typmodout-typoutputpath_outtyptypmod-1typanalyze-typdefault_null_typnotnullftypreceivepath_recvtypstoragextypbasetype0typcategoryGtypcollation0typisdefinedttypnamespacepg_catalogtypsubscript-typdefaultbin_null_array_type_oid1019typispreferredfarray_type_name_path
类型转换 2
与此类型相关的显式 pg_cast 记录。PostgreSQL 还支持 pg_cast 之外的类型转换,缺少记录不能证明转换不可能。
运算符重载 18
每种操作数签名均为独立重载。实现函数和返回类型来自同一源码构建。
| 运算符 | 左操作数 | 右操作数 | 返回类型 | 含义 | 实现函数 |
|---|---|---|---|---|---|
<@ | point | path | bool | 点位于闭合路径内,或位于开放路径上 | on_ppath |
<-> | point | path | float8 | 两者之间的距离 | dist_ppath |
<-> | path | point | float8 | 两者之间的距离 | dist_pathp |
<-> | path | path | float8 | 两者之间的距离 | path_distance |
+ | path | path | path | 连接 | path_add |
+ | path | point | path | 相加(平移路径) | path_add_pt |
- | path | point | path | 相减(平移路径) | path_sub_pt |
* | path | point | path | 相乘(旋转或缩放路径) | path_mul_pt |
/ | path | point | path | 相除(旋转或缩放路径) | path_div_pt |
@> | path | point | bool | 包含 | path_contain_pt |
= | path | path | bool | 等于 | path_n_eq |
< | path | path | bool | 小于 | path_n_lt |
> | path | path | bool | 大于 | path_n_gt |
<= | path | path | bool | 小于等于 | path_n_le |
>= | path | path | bool | 大于等于 | path_n_ge |
# | 无(一元) | path | int4 | 点的数量 | path_npoints |
?# | path | path | bool | 求交集 | path_inter |
@-@ | 无(一元) | path | float8 | 路径线段长度之和 | path_length |
版本比较
PostgreSQL 17.11 → 18.6。属性比较不包含构建标识和说明正文;原始目录字段与源描述保留原文。
这两个样本的系统目录和结构化属性没有变化。
这些构建的文档也有差异,请查看对应版本的手册定义。
文档与源码
- 构建
- 18.6 · https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
- 指纹
555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f
相关条目
全部数据类型 · 下载此版本 JSON · 最早收录的样本不代表该类型的实际引入版本。