PQflush

功能描述

尝试将任何排队的输出数据刷新到服务器。

原型

int PQflush(PGconn *conn);

参数

表 1 PQflush参数

返回值

int：如果成功（或者如果发送队列为空），则返回0；如果由于某种原因失败，则返回-1；如果发送队列中的所有数据都发送失败，则返回1。（此情况只有在连接为非阻塞时才能发生），失败原因存到conn->error_message中。

注意事项

在非阻塞连接上发送任何命令或数据之后，调用PQflush。如果返回1，则等待套接字变为读或写就绪。如果为写就绪状态，则再次调用PQflush。如果已经读到，调用PQconsumeInput，然后再次调用PQflush。重复，直到PQflush返回0。（必须检查读就绪，并用PQconsumeInput排出输入，因为服务器可以阻止试图向我们发送数据，例如，通知信息，直到我们读完它才会读我们的数据。）一旦PQflush返回0，就等待套接字准备好，然后按照上面描述读取响应。

示例

请参见示例章节。