pgtypes 库将 PostgreSQL 数据库类型映射到 C 等效项,这些等效项可在 C 程序中使用。它还提供函数,可在 C 中对这些类型进行基本计算,即无需 PostgreSQL 服务器的帮助。请参见以下示例
EXEC SQL BEGIN DECLARE SECTION; date date1; timestamp ts1, tsout; interval iv1; char *out; EXEC SQL END DECLARE SECTION; PGTYPESdate_today(&date1); EXEC SQL SELECT started, duration INTO :ts1, :iv1 FROM datetbl WHERE d=:date1; PGTYPEStimestamp_add_interval(&ts1, &iv1, &tsout); out = PGTYPEStimestamp_to_asc(&tsout); printf("Started + duration: %s\n", out); PGTYPESchar_free(out);
某些函数(如 PGTYPESnumeric_to_asc
)返回指向新分配的字符字符串的指针。这些结果应使用 PGTYPESchar_free
而非 free
释放。(这仅在 Windows 上很重要,在 Windows 上有时需要由同一库进行内存分配和释放。)
numeric 类型提供使用任意精度进行计算的功能。有关 PostgreSQL 服务器中的等效类型,请参见 第 8.1 节。由于精度任意,此变量需要能够动态扩展和收缩。这就是为什么只能通过 PGTYPESnumeric_new
和 PGTYPESnumeric_free
函数在堆上创建 numeric 变量的原因。decimal 类型与 numeric 类似,但精度有限,可以在堆栈和堆上创建。
可以使用以下函数处理 numeric 类型
PGTYPESnumeric_new
#请求指向新分配的 numeric 变量的指针。
numeric *PGTYPESnumeric_new(void);
PGTYPESnumeric_free
#释放 numeric 类型,释放其所有内存。
void PGTYPESnumeric_free(numeric *var);
PGTYPESnumeric_from_asc
#从其字符串表示形式解析 numeric 类型。
numeric *PGTYPESnumeric_from_asc(char *str, char **endptr);
有效格式例如:-2
、.794
、+3.44
、592.49E07
或 -32.84e-4
。如果可以成功解析该值,则返回一个有效指针,否则返回 NULL 指针。目前,ECPG 始终解析完整字符串,因此目前不支持将第一个无效字符的地址存储在 *endptr
中。您可以安全地将 endptr
设置为 NULL。
PGTYPESnumeric_to_asc
#返回由 malloc
分配的字符串的指针,其中包含 numeric 类型 num
的字符串表示形式。
char *PGTYPESnumeric_to_asc(numeric *num, int dscale);
将打印 numeric 值,小数位数为 dscale
,必要时应用舍入。结果必须使用 PGTYPESchar_free()
释放。
PGTYPESnumeric_add
#将两个 numeric 变量添加到第三个变量中。
int PGTYPESnumeric_add(numeric *var1, numeric *var2, numeric *result);
该函数将变量 var1
和 var2
添加到结果变量 result
中。该函数在成功时返回 0,在出错时返回 -1。
PGTYPESnumeric_sub
#减去两个数字变量,并将结果返回到第三个变量中。
int PGTYPESnumeric_sub(numeric *var1, numeric *var2, numeric *result);
该函数从变量 var1
中减去变量 var2
。操作结果存储在变量 result
中。该函数在成功时返回 0,在出错时返回 -1。
PGTYPESnumeric_mul
#将两个数字变量相乘,并将结果返回到第三个变量中。
int PGTYPESnumeric_mul(numeric *var1, numeric *var2, numeric *result);
该函数将变量 var1
和 var2
相乘。操作结果存储在变量 result
中。该函数在成功时返回 0,在出错时返回 -1。
PGTYPESnumeric_div
#将两个数字变量相除,并将结果返回到第三个变量中。
int PGTYPESnumeric_div(numeric *var1, numeric *var2, numeric *result);
该函数将变量 var1
除以 var2
。操作结果存储在变量 result
中。该函数在成功时返回 0,在出错时返回 -1。
PGTYPESnumeric_cmp
#比较两个数字变量。
int PGTYPESnumeric_cmp(numeric *var1, numeric *var2)
该函数比较两个数字变量。如果出错,则返回 INT_MAX
。如果成功,则该函数返回三个可能的结果之一
1,如果 var1
大于 var2
-1,如果 var1
小于 var2
0,如果 var1
和 var2
相等
PGTYPESnumeric_from_int
#将 int 变量转换为数字变量。
int PGTYPESnumeric_from_int(signed int int_val, numeric *var);
此函数接受类型为有符号 int 的变量,并将其存储在数字变量 var
中。成功时,返回 0,失败时返回 -1。
PGTYPESnumeric_from_long
#将 long int 变量转换为数字变量。
int PGTYPESnumeric_from_long(signed long int long_val, numeric *var);
此函数接受类型为有符号 long int 的变量,并将其存储在数字变量 var
中。成功时,返回 0,失败时返回 -1。
PGTYPESnumeric_copy
#将一个数字变量复制到另一个数字变量中。
int PGTYPESnumeric_copy(numeric *src, numeric *dst);
此函数将 src
指向的变量的值复制到 dst
指向的变量中。成功时返回 0,如果发生错误则返回 -1。
PGTYPESnumeric_from_double
#将类型为 double 的变量转换为数字。
int PGTYPESnumeric_from_double(double d, numeric *dst);
此函数接受类型为 double 的变量,并将结果存储在 dst
指向的变量中。成功时返回 0,如果发生错误则返回 -1。
PGTYPESnumeric_to_double
#将类型为数字的变量转换为 double。
int PGTYPESnumeric_to_double(numeric *nv, double *dp)
此函数将 nv
指向的变量中的数字值转换为 dp
指向的 double 变量。成功时返回 0,如果发生错误则返回 -1,包括溢出。溢出时,全局变量 errno
将另外设置为 PGTYPES_NUM_OVERFLOW
。
PGTYPESnumeric_to_int
#将类型为数字的变量转换为 int。
int PGTYPESnumeric_to_int(numeric *nv, int *ip);
此函数将 nv
指向的变量中的数字值转换为 ip
指向的整数变量。成功时返回 0,如果发生错误则返回 -1,包括溢出。溢出时,全局变量 errno
将另外设置为 PGTYPES_NUM_OVERFLOW
。
PGTYPESnumeric_to_long
#将类型为数字的变量转换为 long。
int PGTYPESnumeric_to_long(numeric *nv, long *lp);
此函数将 nv
指向的变量中的数字值转换为 lp
指向的长整数变量。成功时返回 0,如果发生错误则返回 -1,包括溢出。溢出时,全局变量 errno
将另外设置为 PGTYPES_NUM_OVERFLOW
。
PGTYPESnumeric_to_decimal
#将类型为数字的变量转换为 decimal。
int PGTYPESnumeric_to_decimal(numeric *src, decimal *dst);
该函数将 src
指向的变量中的数字值转换为 dst
指向的十进制变量。如果成功,则返回 0,如果出现错误(包括溢出),则返回 -1。如果溢出,则全局变量 errno
还将设置为 PGTYPES_NUM_OVERFLOW
。
PGTYPESnumeric_from_decimal
#将 decimal 类型的变量转换为 numeric。
int PGTYPESnumeric_from_decimal(decimal *src, numeric *dst);
该函数将 src
指向的变量中的十进制值转换为 dst
指向的数字变量。如果成功,则返回 0,如果出现错误,则返回 -1。由于 decimal 类型是 numeric 类型的受限版本,因此此转换不会发生溢出。
C 中的日期类型使您的程序能够处理 SQL 类型 date 的数据。有关 PostgreSQL 服务器中同等类型的详细信息,请参见 第 8.5 节。
可以使用以下函数处理日期类型
PGTYPESdate_from_timestamp
#从时间戳中提取日期部分。
date PGTYPESdate_from_timestamp(timestamp dt);
该函数接收时间戳作为其唯一参数,并从该时间戳中返回提取的日期部分。
PGTYPESdate_from_asc
#从其文本表示形式解析日期。
date PGTYPESdate_from_asc(char *str, char **endptr);
该函数接收 C char* 字符串 str
和指向 C char* 字符串 endptr
的指针。目前,ECPG 始终解析完整字符串,因此当前不支持将第一个无效字符的地址存储在 *endptr
中。您可以安全地将 endptr
设置为 NULL。
请注意,该函数始终假定 MDY 格式的日期,并且 ECPG 中当前没有变量可以更改此格式。
表 36.2 显示了允许的输入格式。
表 36.2. PGTYPESdate_from_asc
的有效输入格式
输入 | 结果 |
---|---|
1999 年 1 月 8 日 |
1999 年 1 月 8 日 |
1999-01-08 |
1999 年 1 月 8 日 |
1/8/1999 |
1999 年 1 月 8 日 |
1/18/1999 |
1999 年 1 月 18 日 |
01/02/03 |
2003 年 2 月 1 日 |
1999-01-08 |
1999 年 1 月 8 日 |
08-01-1999 |
1999 年 1 月 8 日 |
08-01-1999 |
1999 年 1 月 8 日 |
99-01-08 |
1999 年 1 月 8 日 |
08-01-99 |
1999 年 1 月 8 日 |
08-01-06 |
2006 年 1 月 8 日 |
08-01-99 |
1999 年 1 月 8 日 |
19990108 |
ISO 8601;1999 年 1 月 8 日 |
990108 |
ISO 8601;1999 年 1 月 8 日 |
1999.008 |
年份和年中的天数 |
J2451187 |
儒略日 |
公元前 99 年 1 月 8 日 |
公元前 99 年 |
PGTYPESdate_to_asc
#返回日期变量的文本表示形式。
char *PGTYPESdate_to_asc(date dDate);
该函数接收日期 dDate
作为其唯一参数。它将以 1999-01-18
的形式输出日期,即 YYYY-MM-DD
格式。结果必须使用 PGTYPESchar_free()
释放。
PGTYPESdate_julmdy
#从日期类型变量中提取天、月和年的值。
void PGTYPESdate_julmdy(date d, int *mdy);
该函数接收日期 d
和指向 3 个整数值数组 mdy
的指针。变量名表示顺序:mdy[0]
将被设置为包含月份数,mdy[1]
将被设置为天的值,mdy[2]
将包含年。
PGTYPESdate_mdyjul
#根据指定日期的天、月和年的 3 个整数数组创建一个日期值。
void PGTYPESdate_mdyjul(int *mdy, date *jdate);
该函数接收 3 个整数的数组 (mdy
) 作为其第一个参数,并作为其第二个参数接收指向日期类型变量的指针,该变量应保存操作结果。
PGTYPESdate_dayofweek
#返回一个数字,表示日期值的星期几。
int PGTYPESdate_dayofweek(date d);
该函数接收日期变量 d
作为其唯一参数,并返回一个整数,表示该日期的星期几。
0 - 星期日
1 - 星期一
2 - 星期二
3 - 星期三
4 - 星期四
5 - 星期五
6 - 星期六
PGTYPESdate_today
#获取当前日期。
void PGTYPESdate_today(date *d);
该函数接收一个指向日期变量的指针(d
),它将该指针设置为当前日期。
PGTYPESdate_fmt_asc
#使用格式掩码将类型为日期的变量转换为其文本表示形式。
int PGTYPESdate_fmt_asc(date dDate, char *fmtstring, char *outbuf);
该函数接收要转换的日期(dDate
)、格式掩码(fmtstring
)以及将保存日期文本表示形式的字符串(outbuf
)。
如果成功,则返回 0,如果发生错误,则返回负值。
以下文字是可用的字段说明符
dd
- 月份中的天数。
mm
- 年份中的月份数。
yy
- 年份数,两位数字。
yyyy
- 年份数,四位数字。
ddd
- 星期名称(缩写)。
mmm
- 月份名称(缩写)。
所有其他字符都按 1:1 复制到输出字符串。
表 36.3 指示了一些可能的格式。这将让你了解如何使用此函数。所有输出行都基于同一天:1959 年 11 月 23 日。
表 36.3. PGTYPESdate_fmt_asc
的有效输入格式
格式 | 结果 |
---|---|
mmddyy |
112359 |
ddmmyy |
231159 |
yymmdd |
591123 |
yy/mm/dd |
59/11/23 |
yy mm dd |
59 11 23 |
yy.mm.dd |
59.11.23 |
.mm.yyyy.dd. |
.11.1959.23. |
mmm. dd, yyyy |
Nov. 23, 1959 |
mmm dd yyyy |
Nov 23 1959 |
yyyy dd mm |
1959 23 11 |
ddd, mmm. dd, yyyy |
Mon, Nov. 23, 1959 |
(ddd) mmm. dd, yyyy |
(Mon) Nov. 23, 1959 |
PGTYPESdate_defmt_asc
#使用格式掩码将 C char*
字符串转换为类型为日期的值。
int PGTYPESdate_defmt_asc(date *d, char *fmt, char *str);
该函数接收一个指针,指向应保存操作结果的日期值 (d
)、用于解析日期的格式掩码 (fmt
) 和包含日期文本表示形式的 C char* 字符串 (str
)。文本表示形式应与格式掩码匹配。但是,您不需要字符串与格式掩码之间进行 1:1 映射。该函数仅分析顺序,并查找指示年份位置的文字 yy
或 yyyy
、指示月份位置的 mm
和指示日期位置的 dd
。
表 36.4 指示了一些可能的格式。这将让您了解如何使用此函数。
表 36.4. rdefmtdate
的有效输入格式
格式 | 字符串 | 结果 |
---|---|---|
ddmmyy |
21-2-54 |
1954-02-21 |
ddmmyy |
2-12-54 |
1954-12-02 |
ddmmyy |
20111954 |
1954-11-20 |
ddmmyy |
130464 |
1964-04-13 |
mmm.dd.yyyy |
MAR-12-1967 |
1967-03-12 |
yy/mm/dd |
1954, February 3rd |
1954-02-03 |
mmm.dd.yyyy |
041269 |
1969-04-12 |
yy/mm/dd |
In the year 2525, in the month of July, mankind will be alive on the 28th day |
2525-07-28 |
dd-mm-yy |
I said on the 28th of July in the year 2525 |
2525-07-28 |
mmm.dd.yyyy |
9/14/58 |
1958-09-14 |
yy/mm/dd |
47/03/29 |
1947-03-29 |
mmm.dd.yyyy |
oct 28 1975 |
1975-10-28 |
mmddyy |
Nov 14th, 1985 |
1985-11-14 |
C 中的时间戳类型使您的程序能够处理 SQL 类型时间戳的数据。有关 PostgreSQL 服务器中的等效类型,请参见 第 8.5 节。
可以使用以下函数来处理时间戳类型
PGTYPEStimestamp_from_asc
#将时间戳从其文本表示形式解析为时间戳变量。
timestamp PGTYPEStimestamp_from_asc(char *str, char **endptr);
该函数接收要解析的字符串 (str
) 和一个 C char* 指针 (endptr
)。目前,ECPG 始终解析完整的字符串,因此它目前不支持将第一个无效字符的地址存储在 *endptr
中。您可以安全地将 endptr
设置为 NULL。
该函数在成功时返回解析后的时间戳。如果出错,则返回 PGTYPESInvalidTimestamp
,并将 errno
设置为 PGTYPES_TS_BAD_TIMESTAMP
。有关此值的注意事项,请参见 PGTYPESInvalidTimestamp
。
通常,输入字符串可以包含允许的日期规范、空格字符和允许的时间规范的任意组合。请注意,ECPG 不支持时区。它可以解析它们,但不会应用任何计算,例如 PostgreSQL 服务器所做的。时区说明符将被静默丢弃。
表 36.5 包含一些输入字符串的示例。
表 36.5. PGTYPEStimestamp_from_asc
的有效输入格式
输入 | 结果 |
---|---|
1999-01-08 04:05:06 |
1999-01-08 04:05:06 |
1999 年 1 月 8 日 04:05:06 PST |
1999-01-08 04:05:06 |
1999-01-08 04:05:06.789-8 |
1999-01-08 04:05:06.789(忽略时区说明符) |
J2451187 04:05-08:00 |
1999-01-08 04:05:00(忽略时区说明符) |
PGTYPEStimestamp_to_asc
#将日期转换为 C char* 字符串。
char *PGTYPEStimestamp_to_asc(timestamp tstamp);
该函数接收时间戳 tstamp
作为其唯一参数,并返回一个已分配的字符串,其中包含时间戳的文本表示形式。结果必须使用 PGTYPESchar_free()
释放。
PGTYPEStimestamp_current
#检索当前时间戳。
void PGTYPEStimestamp_current(timestamp *ts);
该函数检索当前时间戳,并将其保存到 ts
指向的时间戳变量中。
PGTYPEStimestamp_fmt_asc
#使用格式掩码将时间戳变量转换为 C char*。
int PGTYPEStimestamp_fmt_asc(timestamp *ts, char *output, int str_len, char *fmtstr);
该函数接收要转换的时间戳的指针作为其第一个参数 (ts
)、输出缓冲区的指针 (output
)、已为输出缓冲区分配的最大长度 (str_len
) 以及用于转换的格式掩码 (fmtstr
)。
成功后,该函数返回 0,如果发生错误,则返回负值。
你可以对格式掩码使用以下格式说明符。格式说明符与 libc 中 strftime
函数中使用的格式说明符相同。任何非格式说明符都将复制到输出缓冲区中。
%A
- 替换为星期全称的国家表示形式。
%a
- 替换为星期简称的国家表示形式。
%B
- 替换为月份全称的国家表示形式。
%b
- 替换为月份简称的国家表示形式。
%C
- 替换为 (年份 / 100) 的十进制数字;个位数前面会加上一个零。
%c
- 替换为国家/地区的时间和日期表示形式。
%D
- 等效于 %m/%d/%y
。
%d
- 替换为十进制数字表示的月份中的天数 (01–31)。
%E*
%O*
- POSIX 语言环境扩展。序列 %Ec
%EC
%Ex
%EX
%Ey
%EY
%Od
%Oe
%OH
%OI
%Om
%OM
%OS
%Ou
%OU
%OV
%Ow
%OW
%Oy
应该提供备用表示形式。
此外,%OB
用于表示备用月份名称(独立使用,不带天数)。
%e
- 替换为十进制数字表示的月份中的天数 (1–31);个位数前面会加上一个空格。
%F
- 等效于 %Y-%m-%d
。
%G
- 替换为带世纪的十进制数字表示的年份。该年份包含一周的大部分时间(星期一为一周的第一天)。
%g
- 替换为与 %G
中相同的年份,但为不带世纪的十进制数字 (00–99)。
%H
- 替换为十进制数字表示的 24 小时制时间 (00–23)。
%h
- 与 %b
相同。
%I
- 替换为十进制数字表示的 12 小时制时间 (01–12)。
%j
- 替换为十进制数字表示的年份中的天数 (001–366)。
%k
- 替换为十进制数字表示的 24 小时制时间 (0–23);个位数前面会加上一个空格。
%l
- 替换为十进制数字表示的 12 小时制时间 (1–12);个位数前面会加上一个空格。
%M
- 替换为十进制数字表示的分 (00–59)。
%m
- 替换为十进制数字表示的月份 (01–12)。
%n
- 替换为换行符。
%O*
- 与 %E*
相同。
%p
- 替换为 “上午” 或 “下午” 的国家表示形式(视情况而定)。
%R
- 等同于 %H:%M
。
%r
- 等同于 %I:%M:%S %p
。
%S
- 替换为十进制数形式的秒数(00–60)。
%s
- 替换为自纪元时间(UTC)以来的秒数。
%T
- 等同于 %H:%M:%S
%t
- 替换为制表符。
%U
- 替换为十进制数形式的一年中的周数(星期日为一周的第一天)(00–53)。
%u
- 替换为十进制数形式的一周中的星期(星期一为一周的第一天)(1–7)。
%V
- 替换为十进制数形式的一年中的周数(星期一为一周的第一天)(01–53)。如果包含 1 月 1 日的那一周在新的一年中包含四天或更多天,则该周为第 1 周;否则,该周为上一年中的最后一周,而下一周为第 1 周。
%v
- 等同于 %e-%b-%Y
。
%W
- 替换为十进制数形式的一年中的周数(星期一为一周的第一天)(00–53)。
%w
- 替换为十进制数形式的一周中的星期(星期日为一周的第一天)(0–6)。
%X
- 替换为时间的国家表示形式。
%x
- 替换为日期的国家表示形式。
%Y
- 替换为十进制数形式的带世纪的年份。
%y
- 替换为十进制数形式的不带世纪的年份(00–99)。
%Z
- 替换为时区名称。
%z
- 替换为相对于 UTC 的时区偏移;正号表示 UTC 以东,负号表示 UTC 以西,小时和分钟分别用两位数字表示,中间没有分隔符(RFC 822 日期头的常见形式)。
%+
- 被日期和时间的国家表示形式替换。
%-*
- GNU libc 扩展。执行数字输出时不进行任何填充。
$_* - GNU libc 扩展。明确指定填充空间。
%0*
- GNU libc 扩展。明确指定零进行填充。
%%
- 被 %
替换。
PGTYPEStimestamp_sub
#从另一个时间戳中减去一个时间戳,并将结果保存在类型为 interval 的变量中。
int PGTYPEStimestamp_sub(timestamp *ts1, timestamp *ts2, interval *iv);
该函数将 ts2
指向的时间戳变量从 ts1
指向的时间戳变量中减去,并将结果存储在 iv
指向的 interval 变量中。
成功后,该函数返回 0,如果发生错误,则返回负值。
PGTYPEStimestamp_defmt_asc
#使用格式化掩码从其文本表示形式解析时间戳值。
int PGTYPEStimestamp_defmt_asc(char *str, char *fmt, timestamp *d);
该函数在变量 str
中接收时间戳的文本表示形式以及在变量 fmt
中使用的格式化掩码。结果将存储在 d
指向的变量中。
如果格式化掩码 fmt
为 NULL,该函数将回退到默认格式化掩码,即 %Y-%m-%d %H:%M:%S
。
这是 PGTYPEStimestamp_fmt_asc
的反向函数。请参阅其中的文档以了解可能的格式化掩码条目。
PGTYPEStimestamp_add_interval
#向时间戳变量添加一个 interval 变量。
int PGTYPEStimestamp_add_interval(timestamp *tin, interval *span, timestamp *tout);
该函数接收一个指向时间戳变量 tin
的指针和一个指向 interval 变量 span
的指针。它将 interval 添加到时间戳,并将结果时间戳保存在 tout
指向的变量中。
成功后,该函数返回 0,如果发生错误,则返回负值。
PGTYPEStimestamp_sub_interval
#从时间戳变量中减去一个 interval 变量。
int PGTYPEStimestamp_sub_interval(timestamp *tin, interval *span, timestamp *tout);
该函数从 tin
指向的时间戳变量中减去 span
指向的 interval 变量,并将结果保存到 tout
指向的变量中。
成功后,该函数返回 0,如果发生错误,则返回负值。
C 中的 interval 类型使您的程序能够处理 SQL 类型 interval 的数据。有关 PostgreSQL 服务器中的等效类型,请参见 第 8.5 节。
可以使用以下函数来处理间隔类型
PGTYPESinterval_new
#返回指向新分配的间隔变量的指针。
interval *PGTYPESinterval_new(void);
PGTYPESinterval_free
#释放之前分配的间隔变量的内存。
void PGTYPESinterval_free(interval *intvl);
PGTYPESinterval_from_asc
#从文本表示中解析间隔。
interval *PGTYPESinterval_from_asc(char *str, char **endptr);
该函数解析输入字符串 str
,并返回指向已分配间隔变量的指针。目前,ECPG 始终解析完整字符串,因此当前不支持将第一个无效字符的地址存储在 *endptr
中。您可以安全地将 endptr
设置为 NULL。
PGTYPESinterval_to_asc
#将类型为间隔的变量转换为其文本表示。
char *PGTYPESinterval_to_asc(interval *span);
该函数将 span
指向的间隔变量转换为 C char*。输出类似于此示例: @ 1 day 12 hours 59 mins 10 secs
。结果必须使用 PGTYPESchar_free()
释放。
PGTYPESinterval_copy
#复制类型为间隔的变量。
int PGTYPESinterval_copy(interval *intvlsrc, interval *intvldest);
该函数将 intvlsrc
指向的间隔变量复制到 intvldest
指向的变量中。请注意,您需要在之前为目标变量分配内存。
十进制类型与数字类型类似。但是,它的有效数字的最大精度限制为 30 位。与只能在堆上创建的数字类型不同,十进制类型可以在堆上或栈上创建(通过函数 PGTYPESdecimal_new
和 PGTYPESdecimal_free
)。在 第 36.15 节中描述的 Informix 兼容模式中,还有许多其他函数处理十进制类型。
可以使用以下函数处理十进制类型,它们不仅包含在 libcompat
库中。
PGTYPES_NUM_BAD_NUMERIC
#参数应包含一个数字变量(或指向一个数字变量),但实际上它的内存中表示无效。
PGTYPES_NUM_OVERFLOW
#发生溢出。由于数字类型可以处理几乎任意精度,因此将数字变量转换为其他类型可能会导致溢出。
PGTYPES_NUM_UNDERFLOW
#发生下溢。由于数字类型可以处理几乎任意精度,因此将数字变量转换为其他类型可能会导致下溢。
PGTYPES_NUM_DIVIDE_ZERO
#尝试除以零。
PGTYPES_DATE_BAD_DATE
#无效的日期字符串传递给 PGTYPESdate_from_asc
函数。
PGTYPES_DATE_ERR_EARGS
#无效的参数传递给 PGTYPESdate_defmt_asc
函数。
PGTYPES_DATE_ERR_ENOSHORTDATE
#由 PGTYPESdate_defmt_asc
函数在输入字符串中找到无效的令牌。
PGTYPES_INTVL_BAD_INTERVAL
#无效的间隔字符串传递给 PGTYPESinterval_from_asc
函数,或无效的间隔值传递给 PGTYPESinterval_to_asc
函数。
PGTYPES_DATE_ERR_ENOTDMY
#在 PGTYPESdate_defmt_asc
函数中,日期/月份/年份分配不匹配。
PGTYPES_DATE_BAD_DAY
#由 PGTYPESdate_defmt_asc
函数发现无效的月日值。
PGTYPES_DATE_BAD_MONTH
#由 PGTYPESdate_defmt_asc
函数发现无效的月份值。
PGTYPES_TS_BAD_TIMESTAMP
#无效的时间戳字符串传递给 PGTYPEStimestamp_from_asc
函数,或无效的时间戳值传递给 PGTYPEStimestamp_to_asc
函数。
PGTYPES_TS_ERR_EINFTIME
#在无法处理无限时间戳值的上下文中遇到无限时间戳值。