PostgreSQL 一行一行地檢索查詢結(jié)果

通常，libpq會(huì)收集一個(gè) SQL 命令的整個(gè)結(jié)果并且把它作為單個(gè)PGresult返回給應(yīng)用。這對(duì)于返回大量行的命令是行不通的。 對(duì)于這類情況，應(yīng)用可以使用PQsendQuery和 PQgetResult 的單行模式。 在這種模式中，結(jié)果行以一次一行的方式被返回給應(yīng)用。

要進(jìn)入到單行模式，在一次成功的PQsetSingleRowMode（或者其他兄弟函數(shù)）調(diào)用后立即調(diào)用PQsendQuery。 這種模式選擇只對(duì)當(dāng)前正在執(zhí)行的查詢有效。然后反復(fù)調(diào)用PQgetResult，直到它返回空，如第 33.4 節(jié)中所示。 如果該查詢返回行，它們會(huì)作為單個(gè)的 PGresult對(duì)象返回，它們看起來都像普通的查詢結(jié)果，只不過其狀態(tài)代碼是PGRES_SINGLE_TUPLE而非PGRES_TUPLES_OK。 在最后一行之后或者緊接著該查詢返回零行之后，一個(gè)狀態(tài)為PGRES_TUPLES_OK的零行對(duì)象會(huì)被返回，這就是代表不會(huì)有更多行的信號(hào)（但是注意仍然有必要繼續(xù)調(diào)用 PQgetResult 直到它返回空）。 所有這些PGresult對(duì)象將包含相同的行描述數(shù)據(jù)（列名、類型等等），這些數(shù)據(jù)和通常一個(gè)查詢的PGresult對(duì)象的相同。 每一個(gè)對(duì)象都應(yīng)該按常規(guī)用PQclear釋放。