pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。
如前所述，PostgreSQL中有两类类型： 基本类型（用编程语言定义）和组合类型。本章描述如何定义 新的基本类型。
本节中的示例可以在 tutorial 目录下的 complex.sql和complex.c中 找到。组合类型的示例在funcs.sql中。
用户定义的类型必须始终具有输入和输出函数。 这些函数决定该类型在字符串中如何表示（供用户输入和输出给 用户）以及在内存中如何组织。输入函数接受一个以空字符结尾的 字符串作为输入，并返回该类型的内部（内存中）表示。输出函数 接受该类型的内部表示，并返回一个以空字符结尾的字符串。
假设我们想定义一个表示复数的 complex 类型。很自然，我们会 选择用下面的C结构在内存中表示复数：
typedef struct Complex {
double x;
double y;
} Complex;
并选择形如(x,y)的字符串作为外部字符串 表示。
这些函数通常不难编写，输出函数尤其如此。不过，有几点需要 记住：
在定义你的外部（字符串）表示时，请记住：你最终必须为该 表示编写一个完整而健壮的解析器作为输入函数！
例如：
Complex *
complex_in(char *str)
{
double x, y;
Complex *result;
if (sscanf(str, " ( %lf , %lf )", &x, &y) != 2) {
elog(ERROR, "complex_in: error in parsing %s", str);
return NULL;
}
result = (Complex *)palloc(sizeof(Complex));
result->x = x;
result->y = y;
return (result);
}
输出函数可以简单地写成：
char *
complex_out(Complex *complex)
{
char *result;
if (complex == NULL)
return(NULL);
result = (char *) palloc(60);
sprintf(result, "(%g,%g)", complex->x, complex->y);
return(result);
}
你应当尽量让输入和输出函数互为逆函数。否则，在你需要把 数据转储到文件中再读回来时（比如读到另一台计算机上某人 的数据库中），就会出现严重的问题。当涉及浮点数时，这是 一个特别常见的问题。
要定义complex类型，我们需要在创建类型之前先创建 complex_in和complex_out 这两个用户定义的函数：
CREATE FUNCTION complex_in(cstring)
RETURNS complex
AS 'PGROOT/tutorial/complex'
LANGUAGE C;
CREATE FUNCTION complex_out(complex)
RETURNS cstring
AS 'PGROOT/tutorial/complex'
LANGUAGE C;
最后，我们可以声明该数据类型：
CREATE TYPE complex (
internallength = 16,
input = complex_in,
output = complex_out
);
注意，输入和输出函数的声明必须引用尚未定义的类型。这是 允许的，但会产生一些可以忽略的警告消息。
如前面所讨论的，PostgreSQL完全支持 基本类型的数组。此外，PostgreSQL也 支持用户定义类型的数组。当你定义一个类型时， PostgreSQL会自动提供对该类型数组的 支持。由于历史原因，数组类型的名称与用户定义类型相同，只是 在前面加上下划线字符_。
组合类型不需要在其上定义任何函数，因为系统已经知道它们 内部是什么样子。
如果你的数据类型的值（内部形式）大小可能超过几百字节，就 应当小心地把它们标记为支持 TOAST。为此，内部表示必须遵循 变长数据的标准布局：前四个字节必须是一个int32， 包含该 datum 的总字节长度（包括其自身）。然后，所有接受该 类型值的函数都必须小心地对提供的值调用 pg_detoast_datum()——如果你的函数不是 strict 的，则要在检查该值不为 NULL 之后进行。最后，在给出 CREATE TYPE命令时选择合适的存储选项。
译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题，请在当前版本的对应页面向上游反馈；上游不再修订已结束维护的版本。