↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / 数据类型 / 几何

line

平面上的无限直线

当前查看 PostgreSQL 18.6。

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

定义

平面上的无限直线

line
目录名称
pg_catalog.line
类型 OID
628
类型种类
基础类型
声明长度
24 字节
存储策略
plain
输入函数
line_in
输出函数
line_out
手册中的声明
line
存储大小
24 字节
手册说明
无限直线
表示方式
{A,B,C}

中文手册

阅读完整手册章节

阅读来源定义

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 节。

点是几何类型的基本二维构造块。用下面任一种语法描述point类型的值:

( x , y )
  x , y

其中x和y分别是坐标,都是浮点数。

点使用第一种语法输出。

直线由线性方程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 ) , r
    x , y   , r

其中(x,y)是圆心,而r是圆的半径。

圆的输出用第一种语法。

系统目录属性

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

oid
628
descr
geometric line, formats '{A,B,C}'/'[point1,point2]'
typacl
_null_
typlen
24
typelem
float8
typname
line
typsend
line_send
typtype
b
typalign
d
typarray
0
typbyval
f
typdelim
','
typinput
line_in
typmodin
-
typndims
0
typowner
POSTGRES
typrelid
0
typmodout
-
typoutput
line_out
typtypmod
-1
typanalyze
-
typdefault
_null_
typnotnull
f
typreceive
line_recv
typstorage
p
typbasetype
0
typcategory
G
typcollation
0
typisdefined
t
typnamespace
pg_catalog
typsubscript
raw_array_subscript_handler
typdefaultbin
_null_
array_type_oid
629
typispreferred
f
array_type_name
_line

运算符重载 18

每种操作数签名均为独立重载。实现函数和返回类型来自同一源码构建。

运算符左操作数右操作数返回类型含义实现函数
<->pointlinefloat8两者之间的距离dist_pl
<->linepointfloat8两者之间的距离dist_lp
<->lseglinefloat8两者之间的距离dist_sl
<->linelsegfloat8两者之间的距离dist_ls
<->linelinefloat8两者之间的距离line_distance
?#lseglinebool求交集inter_sl
?#lineboxbool求交集inter_lb
<@pointlinebool点位于直线上on_pl
<@lseglinebool线段位于直线上on_sl
##pointlinepointB 上距离 A 最近的点close_pl
##linelsegpointB 上距离 A 最近的点close_ls
?#linelinebool求交集line_intersect
?||linelinebool平行line_parallel
?-|linelinebool垂直line_perp
?-无(一元)linebool横向line_horizontal
?|无(一元)linebool竖直line_vertical
=linelinebool等于line_eq
#linelinepoint交点line_interpt

版本比较

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

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

这些构建的文档也有差异,请查看对应版本的手册定义。

文档与源码

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

相关条目

全部数据类型 · 下载此版本 JSON · 最早收录的样本不代表该类型的实际引入版本。