PQexec 向 Postgres 提交一个查询并等待结果。

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

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

PQresultStatus 返回查询的结果状态。

ExecStatusType PQresultStatus(const PGresult *res)

PQresultStatus 可以返回下列值之一：

如果结果状态为 PGRES_TUPLES_OK，就可以使用下面描述的例程检索查询返回的元组。注意，碰巧检索到零个元组的 SELECT 仍然显示 PGRES_TUPLES_OK。PGRES_COMMAND_OK 用于永远不会返回元组的命令（INSERT、UPDATE 等）。PGRES_EMPTY_QUERY 响应往往暴露客户端软件中的 bug。

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

char *PQresStatus(ExecStatusType status);

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

char *PQresultErrorMessage(const PGresult *res);

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

PQntuples 返回查询结果中的元组（实例）数。

int PQntuples(const PGresult *res);

PQnfields 返回查询结果中每个元组的字段（属性）数。

int PQnfields(const PGresult *res);

PQbinaryTuples 如果 PGresult 包含二进制元组数据则返回 1，包含 ASCII 数据则返回 0。

int PQbinaryTuples(const PGresult *res);

目前，只有从 BINARY 游标提取数据的查询才能返回二进制元组数据。

PQfname 返回与给定字段下标相关联的字段（属性）名。字段下标从 0 开始。

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

PQfnumber 返回与给定字段名相关联的字段（属性）下标。

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

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

PQftype 返回与给定字段编号相关联的字段类型。返回的整数是该类型的内部编码。字段编号从 0 开始。

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

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

PQfsize 返回与给定字段下标相关联的字段的大小，以字节计。字段下标从 0 开始。

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

PQfsize 返回数据库元组中为该字段分配的空间，换句话说，即服务器对该数据类型的二进制表示的大小。如果字段是变长的则返回 -1。

PQfmod 返回与给定字段下标相关联的字段的类型专属修饰数据。字段下标从 0 开始。

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

PQgetvalue 返回 PGresult 中某个元组的单个字段（属性）值。元组和字段下标都从 0 开始。

char* PQgetvalue(const PGresult *res,
                 int tup_num,
                 int field_num);

对大多数查询而言，PQgetvalue 返回的是属性值的以空字符结尾的 ASCII 字符串表示。但如果 PQbinaryTuples() 为 1，PQgetvalue 返回的就是该类型以后端服务器内部格式表示的二进制表示（若字段为变长则不含大小字）。此时由程序员负责把数据转换成正确的 C 类型。PQgetvalue 返回的指针指向属于 PGresult 结构的存储空间。不应修改它；如果需要在 PGresult 结构的生命周期结束后继续使用该值，就必须显式地将它复制到其他存储空间。

PQgetlength 返回字段（属性）的长度，以字节计。元组和字段编号从 0 开始。

int PQgetlength(const PGresult *res,
                int tup_num,
                int field_num);

这是该特定数据值的实际数据长度，即 PQgetvalue 所指对象的大小。注意，对于以 ASCII 表示的值，此大小与 PQfsize 报告的二进制大小几乎没有关系。

PQgetisnull 测试一个字段是否为 NULL 条目。元组和字段下标从 0 开始。

int PQgetisnull(const PGresult *res,
                int tup_num,
                int field_num);

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

PQcmdStatus 返回生成该 PGresult 的 SQL 命令的命令状态字符串。

char * PQcmdStatus(const PGresult *res);

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

char * PQcmdTuples(const PGresult *res);

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

PQoidValue 如果 SQL 命令是一个 INSERT，返回所插入元组的对象 id。否则返回 InvalidOid。

Oid PQoidValue(const PGresult *res);

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

PQoidStatus 如果 SQL 命令是一个 INSERT，返回一个含有所插入元组对象 id 的字符串。否则返回空字符串。

char * PQoidStatus(const PGresult *res);

此函数已被弃用，由 PQoidValue 取代，且不是线程安全的。

PQprint 打印出所有的元组以及（可选的）属性名到指定的输出流。

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

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;   /* insert to HTML table ... */
    char    *caption;    /* HTML caption */
    char    **fieldName; /* null terminated array of replacement field names */
} PQprintOpt;
       

此函数以前被 psql 用于打印查询结果，但现在已不再如此，此函数也不再被积极维护。

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

void PQclear(PQresult *res);

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

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

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

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