27.4. 異步命令處理

向伺服器提交一個命令而不等待結果。 如果查詢成功發送則返回 1，否則返回 0。 （此時，可以用PQerrorMessage獲取關於失敗的訊息）。

int PQsendQuery(PGconn *conn, const char *command);

在成功調用 PQsendQuery後，調用 PQgetResult 一次或者多次獲取結果。 在 PQgetResult 返回 NULL 指針，資料表明命令完成之前， 我們不能再調用 PQsendQuery （在同一次連接裡）。

給伺服器提交一個命令和（命令需要的）分隔的參數，而不等待結果。

int PQsendQueryParams(PGconn *conn,
                      const char *command,
                      int nParams,
                      const Oid *paramTypes,
                      const char * const *paramValues,
                      const int *paramLengths,
                      const int *paramFormats,
                      int resultFormat);

這個等效於 PQsendQuery，只是查詢參數可以和查詢字串分開聲明。 函數的參數處理和 PQexecParams 一樣。和 PQexecParams 類似， 它不能在 2.0 版本的協議連接上工作，並且它只允許在查詢字串裡出現一條命令。

發送一個請求，建立一個給定參數的準備好語句，而不等待結束。

int PQsendPrepare(PGconn *conn,
                  const char *stmtName,
                  const char *query,
                  int nParams,
                  const Oid *paramTypes);

這是 PQprepare 的異步版本：如果它能發送這個請求，則返回 1， 如果不能，則返回 0。在成功調用之後，調用 PQgetResult 判斷伺服器是否成功建立了準備好語句。 這個函數的參數的處理和 PQprepare 一樣。 類似 PQprepare，它不能在 2.0 版本協議的連接上運轉。

發送一個執行帶有給出參數的準備好的語句的請求，不等待結果。

int PQsendQueryPrepared(PGconn *conn,
                        const char *stmtName,
                        int nParams,
                        const char * const *paramValues,
                        const int *paramLengths,
                        const int *paramFormats,
                        int resultFormat);

這個函數類似 PQsendQueryParams，但是要執行的命令是透過給一個前面準備好的語句命名來聲明的， 而不是給出一個查詢字串。函數的參數處理和 PQexecPrepared 一樣。類似 PQexecPrepared， 它也不能在 2.0 版本的協議連接上跑。

等待從前面 PQsendQuery，PQsendQueryParams， PQsendPrepare， 或者 PQsendQueryPrepared 調用返回的下一個結果， 然後返回之。當命令結束並且沒有更多結果後返回 NULL。

PGresult *PQgetResult(PGconn *conn);

必須重複的調用 PQgetResult ，直到它返回 NULL， 資料表明該命令結束。（如果在沒有活躍的命令時調用， PQgetResult 將只是立即返回一個空指針。） 每個 PQgetResult 返回的非 NULL 結果都應該用前面描述的 PGresult 訪問函數進行分析。 不要忘了在結束分析後用 PQclear 釋放每個結果對象。 注意，PQgetResult 只是在有一個命令是活躍的而且必須的返回資料還沒有被 PQconsumeInput 讀取時阻塞。

如果存在伺服器來的輸入可用，則使用之。

int PQconsumeInput(PGconn *conn);

PQconsumeInput 通常返回 1 資料表明"沒有錯誤"， 而返回 0 資料表明有某種錯誤發生,（這個時候可以用PQerrorMessage）。 注意這個結果並不資料表明實際上是否蒐集了資料。在調用 PQconsumeInput之後，應用可以檢查 PQisBusy 和/或 PQnotifies 看一眼它們的狀態是否改變。

PQconsumeInput 可以在應用還沒有做好處理結果或通知的情況下被調用。 這個函數將讀取可用的資料並且在一個緩衝區裡保存它，這樣導致一個 select() 讀準備好標識的生成。這樣應用就可以使用 PQconsumeInput 立即清掉 select() 條件，然後在空閒的時候檢查結果。

在查詢忙的時候返回 1 ，也就是說，PQgetResult 將阻塞住等待輸入。 一個 0 的返回資料表明這時調用 PQgetResult等以確保不阻塞。

int PQisBusy(PGconn *conn);

PQisBusy 本身將不會試圖從伺服器讀取資料；所以必須先調用 PQconsumeInput，否則忙狀態將永遠不會消除。

把連接的狀態設置為非阻塞。

int PQsetnonblocking(PGconn *conn, int arg);

如果arg為 1，把連接狀態設置為非阻塞， 如果arg為 0， 把連接狀態設置為阻塞。如果 OK 返回 0，如果錯誤返回 -1。

在非阻塞狀態，調用 PQputline，PQputnbytes， PQsendQuery 和 PQendcopy 的時候不被阻塞， 而是在如果需要再次調用它們時將返回一個錯誤。

請注意 PQexec 不會在意任何非阻塞模式； 如果調用了 PQexec，那麼它的行為總是阻塞的。

返回資料庫連接的阻塞狀態。

int PQisnonblocking(const PGconn *conn);

如果連接設置為非阻塞狀態，返回 1，如果是阻塞狀態返回 0。

試圖把任何正在排隊的資料沖刷到伺服器， 如果成功（或者發送隊列為空）返回 0，如果因某種原因失敗返回 -1， 或者是在無法把發送隊列中的所有資料都發送出去，返回 1。 （這種情況只有在連接不為阻塞模式的時候才會出現）。

int PQflush(PGconn *conn);