database/postgres
database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-05-11 05:41:32 +03:00
Code

Update catalog lists for v6.2.

Browse Source 
Add documentation of some text functions.
Add descriptions of some new SQL/92-compatible string functions.
This commit is contained in:
Thomas G. Lockhart 1997-09-27 04:37:33 +00:00
parent c19bd8c764
commit 384d4f6eba
1 changed files with 133 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

163
src/man/pgbuiltin.3
View File

@ -1,6 +1,6 @@
.\" This is -*-nroff-*- .\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here.... .\" XXX standard disclaimer belongs here....
.\" $Header: /cvsroot/pgsql/src/man/Attic/pgbuiltin.3,v 1.4 1997/09/16 03:01:43 momjian Exp $ .\" $Header: /cvsroot/pgsql/src/man/Attic/pgbuiltin.3,v 1.5 1997/09/27 04:37:33 thomas Exp $
.TH PGBUILTIN INTRO 04/01/97 PostgreSQL PostgreSQL .TH PGBUILTIN INTRO 04/01/97 PostgreSQL PostgreSQL
.SH "DESCRIPTION" .SH "DESCRIPTION"
This section describes the data types, functions and operators This section describes the data types, functions and operators
@ -37,12 +37,9 @@ described in this section.
date ANSI SQL date type date ANSI SQL date type
datetime general-use date and time datetime general-use date and time
filename large object filename filename large object filename
int alias for int4
integer alias for int4
int2 two-byte signed integer int2 two-byte signed integer
int28 array of 8 int2 int28 array of 8 int2
int4 four-byte signed integer int4 four-byte signed integer
float alias for float4
float4 single-precision floating-point number float4 single-precision floating-point number
float8 double-precision floating-point number float8 double-precision floating-point number
lseg 2-dimensional line segment lseg 2-dimensional line segment
@ -57,11 +54,9 @@ described in this section.
point 2-dimensional geometric point point 2-dimensional geometric point
polygon 2-dimensional polygon (same as a closed path) polygon 2-dimensional polygon (same as a closed path)
circle 2-dimensional circle (center and radius) circle 2-dimensional circle (center and radius)
real alias for float4
regproc registered procedure regproc registered procedure
reltime (relative) date and time span (duration) reltime (relative) date and time span (duration)
smgr storage manager smgr storage manager
smallint alias for int2
text variable length array of characters text variable length array of characters
tid tuple identifier type tid tuple identifier type
time ANSI SQL time type time ANSI SQL time type
@ -71,6 +66,52 @@ described in this section.
varchar variable-length characters varchar variable-length characters
xid transaction identifier type xid transaction identifier type
.fi
.in
.PP
There are some data types defined by SQL/92 syntax which are mapped directly
into native Postgres types. Note that the "exact numerics"
.IR decimal
and
.IR numeric
have fully implemented syntax but currently (postgres v6.2) support only a limited
range of the values allowed by SQL/92.
.SH "List of SQL/92 types"
.PP
.if n .ta 5 +15 +25 +40
.if t .ta 0.5i +1.5i +3.0i
.in 0
.nf
\fBPOSTGRES Type\fP \fBSQL/92 Type\fP \fBMeaning\fP
char(n) character(n) fixed-length character string
varchar(n) character varying(n) variable-length character string
float4/8 float(p) floating-point number with precision p
float8 double precision double-precision floating-point number
float8 real double-precision floating-point number
int2 smallint signed two-byte integer
int4 int signed 4-byte integer
int4 integer signed 4-byte integer
int4 decimal(p,s) exact numeric for p <= 9, s = 0
int4 numeric(p,s) exact numeric for p == 9, s = 0
timestamp timestamp with time zone date/time
timespan interval general-use time span
.fi
.in
.PP
There are some constants and functions defined in SQL/92.
.SH "List of SQL/92 constants"
.PP
.if n .ta 5 +20 +40
.if t .ta 0.5i +1.5i +3.0i +4.0i
.in 0
.nf
\fBSQL/92 Function\fP \fBMeaning\fP
current_date date of current transaction
current_time time of current transaction
current_timestamp date and time of current transaction
.fi .fi
.in .in
.PP .PP
@ -83,8 +124,11 @@ Most date and time types share code for data input. For those types (
.IR datetime , .IR datetime ,
.IR abstime , .IR abstime ,
.IR timestamp , .IR timestamp ,
.IR timespan and .IR timespan ,
.IR reltime ) .IR reltime ,
.IR date ,
and
.IR time )
the input can have any of a wide variety of styles. For numeric date representations, the input can have any of a wide variety of styles. For numeric date representations,
European and US conventions can differ, and the proper interpretation is obtained European and US conventions can differ, and the proper interpretation is obtained
by using the by using the
@ -97,6 +141,11 @@ Postgres (see section on
with the SQL style having European and US variants (see with the SQL style having European and US variants (see
.IR set (l)). .IR set (l)).
In future releases, the number of date/time types will decrease, with the current
implementation of datetime becoming timestamp, timespan becoming interval,
and (possibly) abstime
and reltime being deprecated in favor of timestamp and interval.
.SH "DATETIME" .SH "DATETIME"
General-use date and time is input using a wide range of General-use date and time is input using a wide range of
styles, including ISO-compatible, SQL-compatible, traditional styles, including ISO-compatible, SQL-compatible, traditional
@ -531,7 +580,11 @@ tinterval
.SH "FUNCTIONS" .SH "FUNCTIONS"
Many data types have functions available for conversion to other related types. Many data types have functions available for conversion to other related types.
In addition, there are some type-specific functions. In addition, there are some type-specific functions. Functions which are also
available through operators are documented as operators only.
.PP
Some functions defined for text are also available for char() and varchar().
.PP .PP
For the For the
date_part() and date_trunc() date_part() and date_trunc()
@ -546,6 +599,23 @@ to return day of week and `epoch' to return seconds since 1970.
.nf .nf
Functions: Functions:
integer
float8 float(int) convert integer to floating point
float4 float4(int) convert integer to floating point
float
int integer(float) convert floating point to integer
text
text lower(text) convert text to lower case
text lpad(text,int,text) left pad string to specified length
text ltrim(text,text) left trim characters from text
text position(text,text) extract specified substring
text rpad(text,int,text) right pad string to specified length
text rtrim(text,text) right trim characters from text
text substr(text,int[,int]) extract specified substring
text upper(text) convert text to upper case
abstime abstime
bool isfinite(abstime) TRUE if this is a finite time bool isfinite(abstime) TRUE if this is a finite time
datetime datetime(abstime) convert to datetime datetime datetime(abstime) convert to datetime
@ -587,6 +657,22 @@ circle
float8 radius(circle) radius of circle float8 radius(circle) radius of circle
float8 diameter(circle) diameter of circle float8 diameter(circle) diameter of circle
float8 area(circle) area of circle float8 area(circle) area of circle
.fi
.PP
SQL/92 defines functions with specific syntax. Some of these
are implemented using other Postgres functions.
.nf
SQL/92 Functions:
text
text position(text in text) extract specified substring
text substring(text [from int] [for int])
extract specified substring
text trim([leading|trailing|both] [text] from text)
trim characters from text
.fi .fi
.SH "BINARY OPERATORS" .SH "BINARY OPERATORS"
@ -819,8 +905,8 @@ bool |lseg |line |?# |inter_sl
bool |lseg |line |@ |on_sl bool |lseg |line |@ |on_sl
bool |lseg |lseg |= |lseg_eq bool |lseg |lseg |= |lseg_eq
bool |lseg |lseg |?# |lseg_intersect bool |lseg |lseg |?# |lseg_intersect
bool |lseg |lseg |?-\| |lseg_perp bool |lseg |lseg |?-| |lseg_perp
bool |lseg |lseg |?\|\| |lseg_parallel bool |lseg |lseg |?|| |lseg_parallel
bool |money |money |< |cash_lt bool |money |money |< |cash_lt
bool |money |money |<= |cash_le bool |money |money |<= |cash_le
bool |money |money |<> |cash_ne bool |money |money |<> |cash_ne
@ -876,14 +962,14 @@ bool |point |box |@ |on_pb
bool |point |circle |@ |pt_contained_circle bool |point |circle |@ |pt_contained_circle
bool |point |line |@ |on_pl bool |point |line |@ |on_pl
bool |point |lseg |@ |on_ps bool |point |lseg |@ |on_ps
bool |point |path |@ |pt_contained_path
bool |point |path |@ |on_ppath bool |point |path |@ |on_ppath
bool |point |path |@ |pt_contained_path
bool |point |point |<< |point_left bool |point |point |<< |point_left
bool |point |point |<^ |point_below bool |point |point |<^ |point_below
bool |point |point |>> |point_right bool |point |point |>> |point_right
bool |point |point |>^ |point_above bool |point |point |>^ |point_above
bool |point |point |?- |point_horiz bool |point |point |?- |point_horiz
bool |point |point |?\| |point_vert bool |point |point |?| |point_vert
bool |point |point |~= |point_eq bool |point |point |~= |point_eq
bool |point |polygon |@ |pt_contained_poly bool |point |polygon |@ |pt_contained_poly
bool |polygon |point |~ |poly_contain_pt bool |polygon |point |~ |poly_contain_pt
@ -939,8 +1025,14 @@ bool |tinterval |reltime |#> |intervallengt
bool |tinterval |reltime |#>= |intervallenge bool |tinterval |reltime |#>= |intervallenge
bool |tinterval |tinterval |&& |intervalov bool |tinterval |tinterval |&& |intervalov
bool |tinterval |tinterval |< |intervalct bool |tinterval |tinterval |< |intervalct
bool |tinterval |tinterval |< |intervallt
bool |tinterval |tinterval |<< |intervalct bool |tinterval |tinterval |<< |intervalct
bool |tinterval |tinterval |<= |intervalle
bool |tinterval |tinterval |<> |intervalne
bool |tinterval |tinterval |= |intervaleq bool |tinterval |tinterval |= |intervaleq
bool |tinterval |tinterval |> |intervalgt
bool |tinterval |tinterval |>= |intervalge
bool |tinterval |tinterval |~= |intervalsame
bool |varchar |text |!~ |textregexne bool |varchar |text |!~ |textregexne
bool |varchar |text |!~* |texticregexne bool |varchar |text |!~* |texticregexne
bool |varchar |text |!~~ |textnlike bool |varchar |text |!~~ |textnlike
@ -996,8 +1088,8 @@ float8 |lseg |box |<-> |dist_sb
float8 |lseg |line |<-> |dist_sl float8 |lseg |line |<-> |dist_sl
float8 |lseg |lseg |<-> |lseg_distance float8 |lseg |lseg |<-> |lseg_distance
float8 |path |path |<-> |path_distance float8 |path |path |<-> |path_distance
float8 |point |box |<-> |dist_pl
float8 |point |box |<-> |dist_pb float8 |point |box |<-> |dist_pb
float8 |point |box |<-> |dist_pl
float8 |point |lseg |<-> |dist_ps float8 |point |lseg |<-> |dist_ps
float8 |point |path |<-> |dist_ppath float8 |point |path |<-> |dist_ppath
float8 |point |point |<-> |point_distance float8 |point |point |<-> |point_distance
@ -1035,8 +1127,18 @@ int4 |int4 |int4 |* |int4mul
int4 |int4 |int4 |+ |int4pl int4 |int4 |int4 |+ |int4pl
int4 |int4 |int4 |- |int4mi int4 |int4 |int4 |- |int4mi
int4 |int4 |int4 |/ |int4div int4 |int4 |int4 |/ |int4div
money |money |float8 |* |cash_mul money |float4 |money |* |flt4_mul_cash
money |money |float8 |/ |cash_div money |float8 |money |* |flt8_mul_cash
money |int2 |money |* |int2_mul_cash
money |int4 |money |* |int4_mul_cash
money |money |float4 |* |cash_mul_flt4
money |money |float4 |/ |cash_div_flt4
money |money |float8 |* |cash_mul_flt8
money |money |float8 |/ |cash_div_flt8
money |money |int2 |* |cash_mul_int2
money |money |int2 |/ |cash_div_int2
money |money |int4 |* |cash_mul_int4
money |money |int4 |/ |cash_div_int4
money |money |money |+ |cash_pl money |money |money |+ |cash_pl
money |money |money |- |cash_mi money |money |money |- |cash_mi
path |path |path |+ |path_add path |path |path |+ |path_add
@ -1064,7 +1166,7 @@ timespan |timespan |timespan |+ |timespan_pl
timespan |timespan |timespan |- |timespan_mi timespan |timespan |timespan |- |timespan_mi
timespan |timespan |timespan |/ |timespan_div timespan |timespan |timespan |/ |timespan_div
tinterval|abstime |abstime |<#> |mktinterval tinterval|abstime |abstime |<#> |mktinterval
(446 rows) (462 rows)
.ec .ec
.fi .fi
@ -1089,28 +1191,28 @@ left_unary|operand |return_type
----------+---------+----------- ----------+---------+-----------
@@ |box |point @@ |box |point
@@ |circle |point @@ |circle |point
@ |float4 |float4
- |float4 |float4 - |float4 |float4
\|/ |float8 |float8 @ |float4 |float4
@ |float8 |float8
; |float8 |float8
: |float8 |float8
% |float8 |float8
\|\|/ |float8 |float8
- |float8 |float8 - |float8 |float8
@ |float8 |float8
|/ |float8 |float8
||/ |float8 |float8
% |float8 |float8
: |float8 |float8
; |float8 |float8
- |int2 |int2 - |int2 |int2
- |int4 |int4
!! |int4 |int4 !! |int4 |int4
?- |lseg |bool - |int4 |int4
?\| |lseg |bool
@@ |lseg |point @@ |lseg |point
?? |path |float8 ?- |lseg |bool
?| |lseg |bool
# |path |int4 # |path |int4
?? |path |float8
@@ |path |point @@ |path |point
@@ |polygon |point @@ |polygon |point
# |polygon |int4 # |polygon |int4
- |timespan |timespan - |timespan |timespan
\| |tinterval|abstime | |tinterval|abstime
(24 rows) (24 rows)
.ec .ec
@ -1150,7 +1252,8 @@ This list was generated from the Postgres system catalogs with the query:
.nf .nf
.eo .eo
SELECT a.aggname, t.typname SELECT a.aggname AS aggname,
t.typname AS typname
FROM pg_aggregate a, pg_type t FROM pg_aggregate a, pg_type t
WHERE a.aggbasetype = t.oid WHERE a.aggbasetype = t.oid
ORDER BY aggname, typname; ORDER BY aggname, typname;