百科 / 数据类型 / 几何

box

平面上的矩形框

当前查看 PostgreSQL 18。

中文定义与说明

平面上的矩形框

同版本中文手册定义

box 32 字节矩形框 (x1,y1),(x2,y2)

查看完整中文手册与上下文。

PG10–20 核心源码清单。类型转换与操作符类列出源码显式声明的关系；缺少记录不能排除通过其他机制进行转换或使用索引。

定义

平面上的矩形框

box

目录名称: pg_catalog.box
类型 OID: 603
类型种类: 基础类型
声明长度: 32 字节
存储策略: plain
输入函数: box_in
输出函数: box_out
手册中的声明: box
存储大小: 32 字节
手册说明: 矩形框
表示方式: (x1,y1),(x2,y2)

系统目录属性

此构建的源码初始化值。字段含义参见 pg_type 。包含头文件默认值；依赖构建的常量保留符号形式，不作为服务器运行时实测。

oid: 603
descr: geometric box, format 'lower left point,upper right point'
typacl: _null_
typlen: 32
typelem: point
typname: box
typsend: box_send
typtype: b
typalign: d
typarray: 0
typbyval: f
typdelim: ;
typinput: box_in
typmodin: -
typndims: 0
typowner: POSTGRES
typrelid: 0
typmodout: -
typoutput: box_out
typtypmod: -1
typanalyze: -
typdefault: _null_
typnotnull: f
typreceive: box_recv
typstorage: p
typbasetype: 0
typcategory: G
typcollation: 0
typisdefined: t
typnamespace: pg_catalog
typsubscript: raw_array_subscript_handler
typdefaultbin: _null_
array_type_oid: 1020
typispreferred: f
array_type_name: _box

类型转换 7

与此类型相关的显式 pg_cast 记录。PostgreSQL 还支持 pg_cast 之外的类型转换，缺少记录不能证明转换不可能。

源类型	目标类型	转换上下文	转换方式	函数
`point`	`box`	`赋值`	`函数`	`box(point)`
`box`	`point`	`显式`	`函数`	`point(box)`
`box`	`lseg`	`显式`	`函数`	`lseg(box)`
`box`	`polygon`	`赋值`	`函数`	`polygon(box)`
`box`	`circle`	`显式`	`函数`	`circle(box)`
`polygon`	`box`	`显式`	`函数`	`box(polygon)`
`circle`	`box`	`显式`	`函数`	`box(circle)`

运算符重载 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

声明输入类型与此类型相符的操作符类。多态操作符类、类型转换和表达式索引还可能提供其他索引路径；不能仅凭此表判断是否支持索引。

操作符类	索引方法	输入类型	操作符族	默认	存储类型
`box_ops`	`gist`	`box`	`gist/box_ops`	`是`	`与输入类型相同`
`box_ops`	`spgist`	`box`	`spgist/box_ops`	`是`	`与输入类型相同`
`box_inclusion_ops`	`brin`	`box`	`brin/box_inclusion_ops`	`是`	`box`

版本比较

PostgreSQL 17 → 18。属性比较不包含构建标识和说明正文；原始目录字段与源描述保留原文。

这两个样本的系统目录和结构化属性没有变化。

文档与源码

构建: 18.6 · https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
指纹: 555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f

快速链接

box

中文定义与说明

同版本中文手册定义

定义

系统目录属性

类型转换 7

运算符重载 38

操作符类 3

版本比较

文档与源码

相关条目