功能描述
尝试将任何排队的输出数据刷新到服务器。
原型
int
PQflush(PGconn *conn);
参数
表8-58 PQflush 参数
关键字
参数说明
conn
指向包含链接信息的对象指针。
返回值
int:如果成功(或者如果发送队列为空),则返回0;如果由于某种原因失败,则返回
-1;如果发送队列中的所有数据都发送失败,则返回1。(此情况只有在连接为非阻塞时才
能发生),失败原因存到conn->error_message 中。
注意事项
在非阻塞连接上发送任何命令或数据之后,调用PQflush。如果返回1,则等待套接字
变为读或写就绪。如果为写就绪状态,则再次调用PQflush。如果已经读到,调用
PQconsumeInput,然后再次调用PQflush。重复,直到PQflush 返回0。(必须检查读就绪,
并用PQconsumeInput 排出输入,因为服务器可以阻止试图向我们发送数据,例如。通知信
息,直到我们读完它才会读我们的数据。)一旦PQflush 返回0,就等待套接字准备好,然后
按照上面描述读取响应。
示例
参见6.4.3 示例。
取消正在处理的查询
客户端应用可以使用本节描述的函数,要求取消一个仍在被服务器处理的命令。