# 31.5\. 逐行檢索查詢結果 通常，libpq收集SQL命令的全部結果并作為單個`PGresult` 返回到應用中。這對于返回大量行的命令是不可能實現的。對于這種情況， 應用可以在_單行模式_中使用`PQsendQuery`和`PQgetResult`。 在這個模式中，結果行一次返回一行到應用中，就像從服務器中接收到它們一樣。 要進入單行模式，在成功調用`PQsendQuery`（或者一個兄弟函數） 之后立即調用`PQsetSingleRowMode`。這種模式選擇只對當前執行的查詢有效。 然后重復的調用`PQgetResult`，直到它返回空，在[Section 31.4](#calibre_link-624) 中記錄。如果查詢返回任意行，它們作為獨立的`PGresult`對象返回， 就像普通的查詢結果，除了狀態碼是`PGRES_SINGLE_TUPLE`而不是 `PGRES_TUPLES_OK`。在最后一行之后，或者一旦查詢返回零行， 返回一個帶有狀態`PGRES_TUPLES_OK`的零行對象； 這是沒有更多行的一個信號。（但是，請注意，仍然需要繼續調用`PQgetResult` 直到它返回空。）所有這些`PGresult`對象將包含相同的描述數據 （字段名、類型等），就像該查詢的一個普通`PGresult`對象擁有的那樣。 像往常一樣，每個對象都應該使用`PQclear`釋放。 `PQsetSingleRowMode` 為當前執行的查詢選擇單行模式。 ``` int PQsetSingleRowMode(PGconn *conn); ``` 這個函數只能在`PQsendQuery`或它的一個兄弟函數之后立即調用， 在任何連接上的其他操作，比如`PQconsumeInput`或 `PQgetResult`之前。如果在正確的時間調用了， 該函數為當前查詢激活單行模式并返回1。否則模式保持不變并返回0。在任何情況下， 該模式在當前查詢完成之后恢復到正常。 | **Caution** | |:--- | | 處理一個查詢時，服務器可能返回一些行然后遇到一個錯誤，導致查詢退出。通常， libpq丟棄任何這樣的行并且只報告錯誤。但是在單行模式中， 這些行將早已返回到應用中。因此，應用將看到一些 `PGRES_SINGLE_TUPLE` `PGresult` 對象跟隨在`PGRES_FATAL_ERROR`對象后面。對于適當的事務行為， 如果查詢最終失敗了，那么應用必須設計為拋棄或撤銷先前處理的行。 |