向服务器提交一个命令并等待结果。

PGresult *PQexec(PGconn *conn, const char *command);

返回一个 PGresult 指针，也可能返回空指针。除内存耗尽或无法将命令发送到服务器等严重错误外，一般会返回非空指针。如果返回了空指针，应将其视同 PGRES_FATAL_ERROR 结果。使用 PQerrorMessage 获取该错误的更多信息。

提交一个命令给服务器并且等待结果，它可以在 SQL 命令文本之外独立地传递参数。

PGresult *PQexecParams(PGconn *conn,
                       const char *command,
                       int nParams,
                       const Oid *paramTypes,
                       const char * const *paramValues,
                       const int *paramLengths,
                       const int *paramFormats,
                       int resultFormat);

PQexecParams与PQexec相似，但是提供了额外的功能：参数值可以与命令字符串分开指定，并且可以以文本或二进制格式请求查询结果。 PQexecParams 仅支持使用协议 3.0 及更高版本的连接；使用协议 2.0 时会失败。

如果使用了参数，它们在命令字符串中被引用为$1、$2等。 nParams是提供的参数数量；它是数组paramTypes[]、paramValues[]、paramLengths[]和paramFormats[]的长度（当nParams为零时，数组指针可以是NULL）。 paramTypes[]通过 OID 指定要赋予给参数符号的数据类型。如果paramTypes为NULL或者该数组中任何特定元素为零，服务器会用对待未指定类型的字符串字面量的相同方式为参数符号指派一种数据类型。 paramValues[]指定参数的实际值。数组中的空指针表示对应参数为 null；否则，指针指向以零结尾的文本字符串（文本格式），或采用服务器所要求格式的二进制数据（二进制格式）。 paramLengths[]指定二进制格式参数的实际数据长度。对于 null 参数和文本格式参数，该值会被忽略。如果没有二进制参数，数组指针可以为空指针。 paramFormats[]指定参数采用文本格式（在数组中填入零）还是二进制格式（填入一）。如果数组指针为空指针，则将所有参数视为文本。 resultFormat为零时获取文本格式的结果，为一时获取二进制格式的结果。（目前无法让不同结果列使用不同格式，尽管底层协议支持这样做。）

发送一个以给定参数执行预备语句的请求，并等待结果。

PGresult *PQexecPrepared(PGconn *conn,
                         const char *stmtName,
                         int nParams,
                         const char * const *paramValues,
                         const int *paramLengths,
                         const int *paramFormats,
                         int resultFormat);

PQexecPrepared 与 PQexecParams 相似，但要执行的命令通过命名一个先前已准备好的语句来指定，而不是给出查询字符串。此特性让将反复使用的命令只需解析和规划一次，而不是每次执行时都进行。PQexecPrepared 只在协议 3.0 及更高版本的连接中受支持；使用协议 2.0 时会失败。

参数与 PQexecParams 相同，只是用预备语句的名称代替查询字符串，且没有 paramTypes[] 参数（不需要它，因为预备语句的参数类型在创建时就已确定）。

返回命令的结果状态。

ExecStatusType PQresultStatus(const PGresult *res);

PQresultStatus 可以返回下列值之一：

如果结果状态为 PGRES_TUPLES_OK，就可以使用下面描述的函数检索查询返回的行。注意，碰巧检索到零行的 SELECT 命令仍然显示 PGRES_TUPLES_OK。PGRES_COMMAND_OK 用于永远不会返回行的命令（INSERT、 UPDATE 等）。PGRES_EMPTY_QUERY 响应可能表明客户端软件有 bug。

状态为 PGRES_NONFATAL_ERROR 的结果永远不会由 PQexec 或其他查询执行函数直接返回；这类结果会被传递给通知处理器（见 第 27.9 节）。

把 PQresultStatus 返回的枚举类型转换为描述该状态码的字符串常量。

char *PQresStatus(ExecStatusType status);

返回与命令相关联的错误消息；如果没有错误则返回空字符串。

char *PQresultErrorMessage(const PGresult *res);

如果发生过错误，返回的字符串将包含一个末尾换行符。

在 PQexec 或 PQgetResult 调用之后紧接着，（连接上的）PQerrorMessage 会返回与（结果上的）PQresultErrorMessage 相同的字符串。但 PGresult 会保留其错误消息直到被销毁，而连接的错误消息会随后续操作而变化。想知道与某个特定 PGresult 相关联的状态时使用 PQresultErrorMessage；想知道连接上最新操作的状态时使用 PQerrorMessage。

返回错误报告的单个字段。

char *PQresultErrorField(const PGresult *res, int fieldcode);

fieldcode 是错误字段标识符；见下面列出的符号。如果 PGresult 不是错误或警告结果，或不包含指定字段，则返回 NULL。字段值通常不包含末尾换行符。

可用的字段代码如下：

客户端负责按自身需要格式化要显示的信息；特别是应当在需要时折行。错误消息字段中出现的换行符应被视为段落分隔而不是换行。

libpq 内部产生的错误会有严重级别和主要消息，但通常没有其他字段。3.0 之前协议的服务器返回的错误会包含严重级别和主要消息，有时还有一条细节消息，但没有其他字段。

注意，错误字段只能从 PGresult 对象获取，不能从 PGconn 对象获取；不存在 PQerrorField 函数。

释放与 PGresult 关联的存储。每个命令结果在不再需要时都应通过 PQclear 释放。

void PQclear(PQresult *res);

PGresult 对象需要保留多久就可以保留多久；发出新命令时它不会消失，即使关闭连接也不会。要清除它，必须调用 PQclear。不这样做将导致应用内存泄漏。

以给定的状态构造一个空的 PGresult 对象。

PGresult* PQmakeEmptyPGresult(PGconn *conn, ExecStatusType status);

这是 libpq 分配并初始化空 PGresult 对象的内部函数。导出它是因为某些应用发现自己生成结果对象（特别是带有错误状态的对象）很有用。如果 conn 非空且 status 指示一个错误，指定连接的当前错误消息会被复制到 PGresult 中。注意，最终也应对该对象调用 PQclear，就像对待 libpq 本身返回的 PGresult 一样。

返回查询结果中的行（元组）数量。

int PQntuples(const PGresult *res);

返回查询结果中每一行的列（字段）数。

int PQnfields(const PGresult *res);

返回与给定列号相关联的列名。列号从 0 开始。

char *PQfname(const PGresult *res,
              int column_number);

如果列号超出范围，将返回NULL。

返回与给定列名相关联的列号。

int PQfnumber(const PGresult *res,
              const char *column_name);

如果给定的名字不匹配任何列，将返回 -1。

给定的名称会被当作 SQL 命令中的标识符来处理，也就是说，除非用双引号括起来，否则会转换为小写。例如，对于由 SQL 命令

select 1 as FOO, 2 as "BAR";

生成的查询结果，将有如下结果：

PQfname(res, 0)              foo
PQfname(res, 1)              BAR
PQfnumber(res, "FOO")        0
PQfnumber(res, "foo")        0
PQfnumber(res, "BAR")        -1
PQfnumber(res, "\"BAR\"")    1

返回给定列所取自的表的 OID。列号从 0 开始。

Oid PQftable(const PGresult *res,
             int column_number);

如果列号超出范围、指定的列不是对表列的简单引用，或者使用 3.0 之前的协议，则返回 InvalidOid。可以查询系统表 pg_class，确定所引用的具体表。

包含 libpq 头文件后，将定义类型 Oid 和常量 InvalidOid。它们都属于某种整数类型。

返回构成指定查询结果列的列在其所属表中的列号。结果列号从 0 开始。

int PQftablecol(const PGresult *res,
                int column_number);

如果列号超出范围、指定的列不是对表列的简单引用，或者使用 3.0 之前的协议，则返回零。

返回表示给定列格式的格式代码。列号从 0 开始。

int PQfformat(const PGresult *res,
              int column_number);

格式代码零表示文本数据，格式代码一表示二进制数据。（其他代码保留供将来定义。）

返回与给定列号相关联的数据类型。被返回的整数是该类型的内部 OID 号。列号从 0 开始。

Oid PQftype(const PGresult *res,
            int column_number);

可以查询系统表 pg_type 来获取各种数据类型的名称和属性。内置数据类型的 OID 定义在源码树的 src/include/catalog/pg_type.h 文件中。

返回与给定列号相关联的列的类型修饰符。列号从 0 开始。

int PQfmod(const PGresult *res,
           int column_number);

修饰符值的含义由数据类型决定，通常表示精度或大小限制。值 -1 表示“没有可用信息”。大多数数据类型不使用修饰符，此时该值始终为 -1。

返回给定列号对应列的大小，以字节计。列号从 0 开始。

int PQfsize(const PGresult *res,
            int column_number);

PQfsize 返回数据库行中为该列分配的空间，即服务器内部表示该数据类型所需的大小。（因此，它对客户端用处不大。）负值表示该数据类型是变长类型。

如果PGresult包含二进制数据，返回 1。如果包含的是文本数据，返回 0。

int PQbinaryTuples(const PGresult *res);

此函数已弃用（与 COPY 配合使用的情况除外），因为单个 PGresult 可能在部分列中包含文本数据，而在其他列中包含二进制数据。推荐使用 PQfformat。只有结果中的所有列都采用二进制格式（格式 1）时，PQbinaryTuples 才返回 1。

返回 PGresult 中某一行的一个字段值。行号和列号都从 0 开始。

char* PQgetvalue(const PGresult *res,
                 int row_number,
                 int column_number);

对于文本格式的数据，PQgetvalue 返回字段值的字符串表示，以零字节结尾。对于二进制格式的数据，返回值采用该数据类型的 typsend 和 typreceive 函数所决定的二进制表示。（这种情况下，值后面实际上也有一个零字节，但通常没有用处，因为值本身很可能包含零字节。）

如果字段值为 null，则返回空字符串。关于如何区分 null 值与空字符串值，参见 PQgetisnull。

PQgetvalue 返回的指针指向属于 PGresult 结构体的存储空间。不应修改它所指向的数据；如果需要在 PGresult 结构体的生命周期结束后继续使用这些数据，就必须显式地将数据复制到其他存储空间。

测试一个字段是否为 null 值。行号和列号从 0 开始。

int PQgetisnull(const PGresult *res,
                int row_number,
                int column_number);

如果字段为 null，此函数返回 1；如果包含非 null 值，则返回 0。（注意，对于 null 字段，PQgetvalue 返回空字符串，而非空指针。）

返回字段值的实际长度，以字节计。行号和列号从 0 开始。

int PQgetlength(const PGresult *res,
                int row_number,
                int column_number);

这是该数据值的实际数据长度，即 PQgetvalue 所指对象的大小。对于文本格式的数据，它与 strlen() 的结果相同。对于二进制格式，这是必不可少的信息。注意，不应依赖 PQfsize 来获取实际数据长度。

打印出所有的行以及（可选的）列名到指定的输出流。

void PQprint(FILE* fout,      /* output stream */
             const PGresult *res,
             const PQprintOpt *po);

typedef struct {
    pqbool  header;      /* print output field headings and row count */
    pqbool  align;       /* fill align the fields */
    pqbool  standard;    /* old brain dead format */
    pqbool  html3;       /* output HTML tables */
    pqbool  expanded;    /* expand tables */
    pqbool  pager;       /* use pager for output if needed */
    char    *fieldSep;   /* field separator */
    char    *tableOpt;   /* attributes for HTML table element */
    char    *caption;    /* HTML table caption */
    char    **fieldName; /* null-terminated array of replacement field names */
} PQprintOpt;

psql 以前用此函数打印查询结果，现在已不再使用。注意，此函数假定所有数据都是文本格式。

返回生成该 PGresult 的 SQL 命令的命令状态标签。

char * PQcmdStatus(PGresult *res);

通常这只是命令的名称，但可能包含附加数据，例如处理的行数。

返回受 SQL 命令影响的行数。

char * PQcmdTuples(PGresult *res);

如果生成该 PGresult 的 SQL 命令是 INSERT、 UPDATE、DELETE、MOVE 或 FETCH，此函数返回一个包含受影响行数的字符串。如果是其他命令，返回空字符串。

如果 SQL 命令是一个向带 OID 的表中恰好插入一行的 INSERT，返回所插入行的 OID。否则返回 InvalidOid。

Oid PQoidValue(const PGresult *res);

如果 SQL 命令是一个 INSERT，返回一个含有所插入行 OID 的字符串。（如果该 INSERT 并非恰好插入一行，或目标表不带 OID，字符串为 0。）如果命令不是 INSERT，返回空字符串。

char * PQoidStatus(const PGresult *res);

此函数已被弃用，推荐使用PQoidValue。它不是线程安全的。

对二进制数据进行转义，使其能够在 SQL 命令中用作 bytea 类型的值。与 PQescapeStringConn 一样，这仅用于将数据直接插入 SQL 命令字符串的情况。

unsigned char *PQescapeByteaConn(PGconn *conn,
                                 const unsigned char *from,
                                 size_t from_length,
                                 size_t *to_length);

当某些字节值被用作一个 SQL 语句中的 bytea 字面量的一部分时，它们必须 被转义（但所有字节值都可以被转义）。一般而言， 要转义一个字节，需要把它转换为与该字节值相等的三位八进制数， 并在前面加上一个或两个反斜线。单引号（'）和 反斜线（\）字符有特殊的替代转义序列。更多信息见 第 8.4 节。PQescapeByteaConn 执行这种操作，只转义最少必需的字节。

from 参数指向待转义字符串的首字节，from_length 参数给出该二进制字符串的字节数。（末尾零字节既不需要，也不计入长度。）to_length 参数指向用于保存转义后字符串长度的变量。该结果字符串长度包含结果末尾的零字节。

PQescapeByteaConn 返回 from 参数所指二进制字符串的转义版本，存放在通过 malloc() 分配的内存中。结果不再需要时，应使用 PQfreemem() 释放该内存。返回字符串中的所有特殊字符都已替换，以便 PostgreSQL 字符串字面量解析器和 bytea 输入函数正确处理。还会添加一个末尾零字节。包围 PostgreSQL 字符串字面量所需的单引号不包含在结果字符串中。

在发生错误时，将返回一个空指针，并且一个合适的错误消息被存储在conn对象中。当前，唯一可能的错误是没有足够的内存用于结果串。

PQescapeBytea 是 PQescapeByteaConn 的旧版本，现已弃用。

unsigned char *PQescapeBytea(const unsigned char *from,
                             size_t from_length,
                             size_t *to_length);

与 PQescapeByteaConn 唯一的区别是，PQescapeBytea 不接受 PGconn 参数。因此，它无法根据连接属性（尤其是是否启用了标准符合字符串）调整行为，可能给出错误的结果。此外，它也无法在失败时返回错误消息。

PQescapeBytea 可以在同一时刻仅使用一个 PostgreSQL 连接的单线程客户端程序中安全使用（在这种情况下，它能够“在内部”取得所需信息）。在其他情形下，它存在安全隐患，应改用 PQescapeByteaConn。

把二进制数据的字符串表示转换为二进制数据——即 PQescapeBytea 的逆操作。以文本格式检索 bytea 数据时需要此函数；以二进制格式检索时则不需要。

unsigned char *PQunescapeBytea(const unsigned char *from, size_t *to_length);

from参数指向一个字符串，例如对bytea列调用PQgetvalue时返回的字符串。 PQunescapeBytea将这个字符串表示转换为二进制表示。 它返回指向通过malloc()分配的缓冲区的指针，出错时返回NULL，并将缓冲区大小存入to_length。 不再需要结果时，必须使用PQfreemem释放它。

此转换并不完全是PQescapeBytea的逆操作，因为从PQgetvalue收到的字符串并非经过“转义”的形式。 具体而言，这意味着无需考虑字符串引号，因此也不需要PGconn参数。

释放libpq分配的内存。

void PQfreemem(void *ptr);

释放 libpq 分配的内存，特别是 PQescapeByteaConn、PQescapeBytea、PQunescapeBytea 和 PQnotifies 分配的内存。Microsoft Windows 需要此函数，因为它无法跨 DLL 释放内存，除非使用多线程 DLL（VC6 中的/MD）。在其他平台上，此函数与标准库函数free()相同。