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

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 *PQprepare(PGconn *conn,
                    const char *stmtName,
                    const char *query,
                    int nParams,
                    const Oid *paramTypes);

PQprepare 创建一个预备语句，供随后使用 PQexecPrepared 执行。此功能允许将被反复使用的命令只解析和规划一次，而不是每次执行时都重复进行。PQprepare 仅在使用协议 3.0 及更高版本的连接中受支持，使用协议 2.0 时会失败。

该函数从query串创建一个名为stmtName的预备语句，该串必须包含一个单一 SQL 命令。 stmtName可以是""来创建一个未命名语句，在这种情况下任何已存在的未命名语句将被自动替换。 否则，如果语句名称已经在当前会话中被定义，则是一种错误。如果使用了任何参数，它们在查询中以$1、$2等引用。 nParams 是在数组 paramTypes[] 中预先指定了类型的参数数量（当nParams为零时，该数组指针可以是NULL）。 paramTypes[]通过 OID 指定要赋予给参数符号的数据类型。 如果paramTypes是NULL或者该数组中任何特定元素为零，服务器会用对待未指定类型的字符串字面量的方式为参数符号推测一种数据类型。 还有，查询能够使用编号高于nParams的参数符号，它们的数据类型也会被自动推测。

正如PQexec一样，结果通常是一个PGresult对象，其内容代表服务器端成功或失败。 返回空指针表示内存不足，或者根本无法发送命令。关于错误的更多信息请见PQerrorMessage。

目前，没有办法确定未在paramTypes[]中指定类型的任何参数实际被推测出的数据类型。这是libpq的一个缺失，将来可能会补上。

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

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或者其他查询执行函数直接返回，这类结果将被传递给通知处理器（见 第 28.10 节）。

将 PQresultStatus 返回的枚举值转换为描述该状态码的字符串常量。调用者不应释放此结果。

char *PQresStatus(ExecStatusType status);

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

char *PQresultErrorMessage(const PGresult *res);

如果发生了错误，返回的字符串会以换行符结尾。调用者不应直接释放结果；当关联的 PGresult 句柄被传给 PQclear 时，结果会被释放。

紧跟着一个PQexec 或 PQgetResult调用，PQerrorMessage（在连接上）将返回与PQresultErrorMessage相同的字符串（在结果上）。 不过，一个PGresult将保持它的错误消息直到被销毁，而连接的错误消息将在后续操作被执行时被更改。 当你想要知道与一个特定PGresult相关的状态，使用PQresultErrorMessage。 而当你想要知道连接上最后一个操作的状态，使用PQerrorMessage。

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

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

fieldcode 是错误字段标识符，参见下文列出的符号。如果 PGresult 不是错误或警告结果，或者不包含指定字段，则返回 NULL。字段值通常不含末尾换行符。调用者不应直接释放结果；当关联的 PGresult 句柄被传给 PQclear 时，结果会被释放。

可以使用以下字段代码：

客户端负责按自身需要格式化所显示的信息，尤其应在需要时将长行折行。错误消息字段中的换行符应当视为段落分隔，而非行分隔。

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

注意，错误字段只对PGresult对象有效，对PGconn对象无效。没有PQerrorField函数。

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

void PQclear(PGresult *res);

你可以在需要时一直保留PGresult对象；它不会在你发出新命令时消失，甚至在关闭连接后也不会消失。要销毁它，你必须调用PQclear。否则应用程序会发生内存泄漏。

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

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

这是libpq内部用于分配并初始化一个空PGresult对象的函数。 如果无法分配内存，此函数返回NULL。 将它导出供外部调用，是因为一些应用需要自行生成结果对象，特别是带有错误状态的对象。 如果conn 不为 null，并且status表示错误，指定连接的当前错误消息会被复制到PGresult中。 注意，最终应对该对象调用PQclear，就像处理libpq自身返回的PGresult一样。

返回查询结果中的行（元组）数。因为它返回一个整数结果，在 32 位操作系统上大的结果集可能会导致返回值溢出。

int PQntuples(const PGresult *res);

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

int PQnfields(const PGresult *res);

返回给定列号对应的列名。列号从 0 开始。调用者不应直接释放结果；当关联的 PGresult 句柄被传给 PQclear 时，结果会被释放。

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 开始。调用者不应直接释放结果；当关联的 PGresult 句柄被传给 PQclear 时，结果会被释放。

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,      /* 输出流 */
             const PGresult *res,
             const PQprintOpt *po);
typedef struct
{
    pqbool  header;      /* 打印输出字段标题和行数 */
    pqbool  align;       /* 填充并对齐字段 */
    pqbool  standard;    /* 旧的简陋格式 */
    pqbool  html3;       /* 输出 HTML 表格 */
    pqbool  expanded;    /* 展开表格 */
    pqbool  pager;       /* 需要时使用分页器输出 */
    char    *fieldSep;   /* 字段分隔符 */
    char    *tableOpt;   /* 用于 HTML 表格元素的属性 */
    char    *caption;    /* HTML 表格标题 */
    char    **fieldName; /* 以空指针结尾的替换字段名数组 */
} PQprintOpt;

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

返回来自于产生PGresult的 SQL 命令的命令状态标签。

char *PQcmdStatus(PGresult *res);

通常这就是该命令的名称，但是它可能包括额外数据，例如已被处理的行数。调用者不应该直接释放该结果。它将在相关的PGresult句柄被传递给PQclear之后被释放。

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

char *PQcmdTuples(PGresult *res);

此函数返回一个字符串，其中包含产生该 PGresult 的 SQL 语句所影响的行数。此函数只能在执行 SELECT、INSERT、UPDATE、DELETE、MOVE 或 FETCH 语句之后使用，也可以在对包含 INSERT、UPDATE 或 DELETE 语句的预备查询执行 EXECUTE 之后使用。如果产生 PGresult 的是其他命令，PQcmdTuples 将返回空字符串。调用者不应直接释放返回值；当关联的 PGresult 句柄被传给 PQclear 时，返回值会被释放。

如果该SQL命令是一个正好将一行插入到具有 OID 的表的INSERT，或者是一个包含合适INSERT语句的预备查询的EXECUTE，这个函数返回被插入行的 OID。否则，这个函数返回InvalidOid。如果被INSERT语句影响的表不包含 OID，这个函数也将返回InvalidOid。

Oid PQoidValue(const PGresult *res);

如果该SQL命令是一个恰好插入一行的INSERT，或者是一个由合适的INSERT构成的预备语句的EXECUTE，返回一个带有被插入行 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() 相同。