box
平面上的矩形框
当前查看 PostgreSQL 18.6。
PG10–20 核心源码清单。类型转换与操作符类列出源码显式声明的关系;缺少记录不能排除通过其他机制进行转换或使用索引。
定义
平面上的矩形框
box
- 目录名称
- pg_catalog.box
- 类型 OID
- 603
- 类型种类
- 基础类型
- 声明长度
- 32 字节
- 存储策略
- plain
- 输入函数
- box_in
- 输出函数
- box_out
- 手册中的声明
- box
- 存储大小
- 32 字节
- 手册说明
- 矩形框
- 表示方式
- (x1,y1),(x2,y2)
中文手册
阅读来源定义
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 。包含头文件默认值;依赖构建的常量保留符号形式,不作为服务器运行时实测。
oid603descrgeometric box, format 'lower left point,upper right point'typacl_null_typlen32typelempointtypnameboxtypsendbox_sendtyptypebtypaligndtyparray0typbyvalftypdelim;typinputbox_intypmodin-typndims0typownerPOSTGREStyprelid0typmodout-typoutputbox_outtyptypmod-1typanalyze-typdefault_null_typnotnullftypreceivebox_recvtypstorageptypbasetype0typcategoryGtypcollation0typisdefinedttypnamespacepg_catalogtypsubscriptraw_array_subscript_handlertypdefaultbin_null_array_type_oid1020typispreferredfarray_type_name_box
类型转换 7
与此类型相关的显式 pg_cast 记录。PostgreSQL 还支持 pg_cast 之外的类型转换,缺少记录不能证明转换不可能。
运算符重载 38
每种操作数签名均为独立重载。实现函数和返回类型来自同一源码构建。
| 运算符 | 左操作数 | 右操作数 | 返回类型 | 含义 | 实现函数 |
|---|---|---|---|---|---|
<< | box | box | bool | 位于左侧 | box_left |
&< | box | box | bool | 重叠或位于左侧 | box_overleft |
&> | box | box | bool | 重叠或位于右侧 | box_overright |
>> | box | box | bool | 位于右侧 | box_right |
<@ | box | box | bool | 被包含于 | box_contained |
@> | box | box | bool | 包含 | box_contain |
~= | box | box | bool | 相同 | box_same |
&& | box | box | bool | 重叠 | box_overlap |
>= | box | box | bool | 面积大于或等于 | box_ge |
> | box | box | bool | 面积大于 | box_gt |
= | box | box | bool | 面积相等 | box_eq |
< | box | box | bool | 面积小于 | box_lt |
<= | box | box | bool | 面积小于或等于 | box_le |
<@ | point | box | bool | 点位于矩形框内 | on_pb |
@> | box | point | bool | 包含 | box_contain_pt |
@@ | 无(一元) | box | point | 中心点 | box_center |
<-> | point | box | float8 | 两者之间的距离 | dist_pb |
<-> | box | point | float8 | 两者之间的距离 | dist_bp |
<-> | lseg | box | float8 | 两者之间的距离 | dist_sb |
<-> | box | lseg | float8 | 两者之间的距离 | dist_bs |
<-> | box | box | float8 | 两者之间的距离 | box_distance |
>^ | box | box | bool | 位于上方(允许接触) | box_above_eq |
<^ | box | box | bool | 位于下方(允许接触) | box_below_eq |
?# | box | box | bool | 已弃用,请改用 && | box_overlap |
# | box | box | box | 矩形框的交集 | box_intersect |
+ | box | point | box | 矩形框与点相加(平移) | box_add |
- | box | point | box | 矩形框减去点(平移) | box_sub |
* | box | point | box | 矩形框乘以点(缩放) | box_mul |
/ | box | point | box | 矩形框除以点(缩放) | box_div |
?# | lseg | box | bool | 求交集 | inter_sb |
?# | line | box | bool | 求交集 | inter_lb |
<@ | lseg | box | bool | 被包含于 | on_sb |
## | point | box | point | B 上距离 A 最近的点 | close_pb |
## | lseg | box | point | B 上距离 A 最近的点 | close_sb |
<<| | box | box | bool | 位于下方 | box_below |
&<| | box | box | bool | 重叠或位于下方 | box_overbelow |
|&> | box | box | bool | 重叠或位于上方 | box_overabove |
|>> | box | box | bool | 位于上方 | box_above |
操作符类 3
声明输入类型与此类型相符的操作符类。多态操作符类、类型转换和表达式索引还可能提供其他索引路径;不能仅凭此表判断是否支持索引。
版本比较
PostgreSQL 17.11 → 18.6。属性比较不包含构建标识和说明正文;原始目录字段与源描述保留原文。
这两个样本的系统目录和结构化属性没有变化。
这些构建的文档也有差异,请查看对应版本的手册定义。
文档与源码
- 构建
- 18.6 · https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
- 指纹
555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f
相关条目
全部数据类型 · 下载此版本 JSON · 最早收录的样本不代表该类型的实际引入版本。