PQmakeEmptyPGresult
功能描述
用给定的状态构造一个空PGresult对象。
接口原型
PGresult *PQmakeEmptyPGresult(PGconn *conn, ExecStatusType status);
参数说明
参数 | 描述 |
---|---|
conn | 建立连接时返回的连接结构体指针,该指针用于标识某个特定连接。 |
status | 给定的状态。 |
返回值
分配和初始化一个空PGresult对象并返回, 如果不能分配内存,那么这个函数返回NULL。
其他
这是一个libpq内部使用的函数,之所以将此接口暴露给用户,是因为在某些场景中中,由应用程序自己生成结果对象(尤其是错误状态下的结果对象)是很有意义的。如果conn不为空并且指定了错误状态,则当前的错误信息被放入PGresult。它们不会获得PGEVT_RESULTCREATE请求, 但会接收到PQfireResultCreateEvents)。需要注意的是PGresult对象,最后应采用PQclear释放。