释放 libpq 分配的内存。

void PQfreemem(void *ptr);

释放 libpq 分配的内存，特别是 PQescapeByteaConn、PQescapeBytea、PQunescapeBytea 和 PQnotifies 分配的内存。特别重要的是，在 Microsoft Windows 上，必须使用此函数而不是 free()。这是因为在 DLL 中分配内存并在应用程序中释放内存，只有在 DLL 和应用程序的多线程/单线程、发布/调试以及静态/动态标志相同时才有效。在非 Microsoft Windows 平台上，此函数与标准库函数 free() 相同。

释放由 PQconndefaults 或 PQconninfoParse 分配的数据结构。

void PQconninfoFree(PQconninfoOption *connOptions);

如果参数是指向 NULL 的指针，则不执行任何操作。

简单的 PQfreemem 对此无效，因为数组包含指向辅助字符串的引用。

准备 PostgreSQL 密码的加密形式。

char *PQencryptPasswordConn(PGconn *conn, const char *passwd, const char *user, const char *algorithm);

此函数旨在供希望发送诸如 ALTER USER joe PASSWORD 'pwd' 之类的命令的客户端应用程序使用。不建议在此类命令中发送原始明文密码，因为它们可能会暴露在命令日志、活动显示等地方。相反，请在此函数将密码转换为加密形式后再发送。

名为 passwd 和 user 的参数分别是明文密码，以及它所属用户的 SQL 名称。algorithm 指定用于加密密码的加密算法。目前支持的算法有 md5 和 scram-sha-256（为了兼容旧版服务器，也接受 on 和 off 作为 md5 的别名）。请注意，对 scram-sha-256 的支持是在 PostgreSQL 版本 10 中引入的，并且与旧版服务器不兼容。如果 algorithm 是 NULL，此函数将查询服务器以获取 password_encryption 设置的当前值。这可能会阻塞，并且如果在当前事务被中止或连接正忙于执行另一个查询时失败。如果您想使用服务器的默认算法但又想避免阻塞，请在调用 PQencryptPasswordConn 之前自行查询 password_encryption，并将该值作为 algorithm 传递。

返回值是一个由 malloc 分配的字符串。调用者可以假定字符串不包含任何需要转义的特殊字符。完成后使用 PQfreemem 来释放结果。发生错误时，返回 NULL，并将适当的消息存储在连接对象中。

更改 PostgreSQL 密码。

PGresult *PQchangePassword(PGconn *conn, const char *user, const char *passwd);

此函数使用 PQencryptPasswordConn 来构建和执行 ALTER USER ... PASSWORD '...' 命令，从而更改用户的密码。它存在的原因与 PQencryptPasswordConn 相同，但更方便，因为它会为您构建和运行命令。PQencryptPasswordConn 将 NULL 传递给算法参数，因此加密将根据服务器的 password_encryption 设置进行。

名为 user 和 passwd 的参数分别是目标用户的 SQL 名称和新的明文密码。

返回一个 PGresult 指针，表示 ALTER USER 命令的结果，如果该例程在发出任何命令之前失败，则返回一个空指针。应调用 PQresultStatus 函数来检查返回值中是否存在任何错误（包括空指针值，在这种情况下它将返回 PGRES_FATAL_ERROR）。使用 PQerrorMessage 获取有关此类错误的更多信息。

准备 PostgreSQL 密码的 md5 加密形式。

char *PQencryptPassword(const char *passwd, const char *user);

PQencryptPassword 是 PQencryptPasswordConn 的旧版、已弃用的版本。区别在于 PQencryptPassword 不需要连接对象，并且始终使用 md5 作为加密算法。

使用给定的状态构建一个空的 PGresult 对象。

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

这是 libpq 内部函数，用于分配和初始化一个空的 PGresult 对象。如果内存分配失败，此函数将返回 NULL。它被导出是因为有些应用程序发现生成结果对象（特别是具有错误状态的对象）很有用。如果 conn 不为 null 且 status 指示错误，则将指定连接的当前错误消息复制到 PGresult 中。此外，如果 conn 不为 null，则会将其注册到连接中的任何事件过程复制到 PGresult 中。（它们不会收到 PGEVT_RESULTCREATE 调用，但请参阅 PQfireResultCreateEvents。）请注意，最终应使用 PQclear 来清理该对象，就像清理 libpq 本身返回的 PGresult 一样。

为 PGresult 对象中注册的每个事件过程触发一个 PGEVT_RESULTCREATE 事件（请参阅 第 32.14 节）。如果所有事件过程都失败，则返回非零表示成功，零表示失败。

int PQfireResultCreateEvents(PGconn *conn, PGresult *res);

conn 参数会被传递给事件过程，但不会直接使用。如果事件过程不使用它，则可以为 NULL。

已为此对象收到 PGEVT_RESULTCREATE 或 PGEVT_RESULTCOPY 事件的事件过程将不会再次触发。

此函数独立于 PQmakeEmptyPGresult 的主要原因是，通常在调用事件过程之前创建 PGresult 对象并填充数据是合适的。

复制一个 PGresult 对象。复制品与源结果没有任何关联，并且在不再需要复制品时必须调用 PQclear。如果函数失败，则返回 NULL。

PGresult *PQcopyResult(const PGresult *src, int flags);

这不是为了进行精确复制。返回的结果始终处于 PGRES_TUPLES_OK 状态，并且不复制源中的任何错误消息。（但它会复制命令状态字符串。）flags 参数决定了复制的其他内容。它是一个多个标志的按位或。PG_COPYRES_ATTRS 指定复制源结果的属性（列定义）。PG_COPYRES_TUPLES 指定复制源结果的元组。（这隐含了复制属性。）PG_COPYRES_NOTICEHOOKS 指定复制源结果的通知钩子。PG_COPYRES_EVENTS 指定复制源结果的事件。（但源的任何实例数据都不会被复制。）事件过程会收到 PGEVT_RESULTCOPY 事件。

设置 PGresult 对象的属性。

int PQsetResultAttrs(PGresult *res, int numAttributes, PGresAttDesc *attDescs);

提供的 attDescs 会被复制到结果中。如果 attDescs 指针为 NULL 或者 numAttributes 小于一，则请求将被忽略，函数将成功。如果 res 已包含属性，则函数将失败。如果函数失败，返回值为零。如果函数成功，返回值非零。

设置 PGresult 对象的元组字段值。

int PQsetvalue(PGresult *res, int tup_num, int field_num, char *value, int len);

该函数将根据需要自动扩展结果的内部元组数组。但是，tup_num 参数必须小于或等于 PQntuples，这意味着此函数只能一次增长一个元组的元组数组。但是，任何现有元组的任何字段都可以按任何顺序修改。如果 field_num 处的字段值已存在，则会被覆盖。如果 len 为 -1 或 value 为 NULL，则字段值将设置为 SQL null 值。value 会被复制到结果的私有存储中，因此函数返回后不再需要它。如果函数失败，返回值将为零。如果函数成功，返回值将为非零。

为 PGresult 对象分配辅助存储。

void *PQresultAlloc(PGresult *res, size_t nBytes);

使用此函数分配的任何内存将在清除 res 时被释放。如果函数失败，返回值是 NULL。结果保证与 malloc 一样，对任何类型的数据都进行了充分的对齐。

检索为 PGresult 对象分配的字节数。

size_t PQresultMemorySize(const PGresult *res);

此值是与 PGresult 对象相关的所有 malloc 请求的总和，即所有将由 PQclear 释放的内存。此信息对于管理内存消耗很有用。

返回正在使用的 libpq 的版本。

int PQlibVersion(void);

此函数的结果可用于在运行时确定当前加载的 libpq 版本中是否可用特定功能。例如，该函数可用于确定 PQconnectdb 中可用的连接选项。

结果通过将库的主版本号乘以 10000 并加上次版本号形成。例如，版本 10.1 将返回 100001，版本 11.0 将返回 110000。

在主版本 10 之前，PostgreSQL 使用三部分版本号，其中前两部分一起表示主版本。对于这些版本，PQlibVersion 为每个部分使用两位数；例如，版本 9.1.5 将返回 90105，版本 9.2.0 将返回 90200。

因此，为了确定功能兼容性，应用程序应将 PQlibVersion 的返回值除以 100 而不是 10000 来确定逻辑主版本号。在所有发行系列中，只有最后两位数字在次要版本（错误修复版本）之间有所不同。

检索当前时间，表示自 Unix 纪元以来的微秒数（即 time_t 乘以一百万）。

pg_usec_time_t PQgetCurrentTimeUSec(void);

这主要用于计算要与 PQsocketPoll 一起使用的超时值。