Ordinarily, <application>libpq</application> collects an SQL command's entire result and returns it to the application as a single <structname>PGresult</structname>. This can be unworkable for commands that return a large number of rows. For such cases, applications can use <xref linkend="libpq-PQsendQuery"/> and <xref linkend="libpq-PQgetResult"/> in <firstterm>single-row mode</firstterm>. In this mode, the result row(s) are returned to the application one at a time, as they are received from the server. 通常、libpqはSQLコマンドの結果全体を収集し、それを１つのPGresultとしてアプリケーションに返します。 これは、多くの行数を返すコマンドでは動作しなくなるかもしれません。 こうした場合、アプリケーションはPQsendQueryとPQgetResultを単一行モードで使用することができます。 このモードでは、結果行は、サーバから受け取ったかのように、アプリケーションに１度に１行返されます。

To enter single-row mode, call <xref linkend="libpq-PQsetSingleRowMode"/> immediately after a successful call of <xref linkend="libpq-PQsendQuery"/> (or a sibling function). This mode selection is effective only for the currently executing query. Then call <xref linkend="libpq-PQgetResult"/> repeatedly, until it returns null, as documented in <xref linkend="libpq-async"/>. If the query returns any rows, they are returned as individual <structname>PGresult</structname> objects, which look like normal query results except for having status code <literal>PGRES_SINGLE_TUPLE</literal> instead of <literal>PGRES_TUPLES_OK</literal>. After the last row, or immediately if the query returns zero rows, a zero-row object with status <literal>PGRES_TUPLES_OK</literal> is returned; this is the signal that no more rows will arrive. (But note that it is still necessary to continue calling <xref linkend="libpq-PQgetResult"/> until it returns null.) All of these <structname>PGresult</structname> objects will contain the same row description data (column names, types, etc.) that an ordinary <structname>PGresult</structname> object for the query would have. Each object should be freed with <xref linkend="libpq-PQclear"/> as usual. 単一行モードに入るためには、PQsendQuery（または同系列の関数）の呼び出しに成功した直後にPQsetSingleRowModeを呼び出してください。 このモード選択は、現在実行中の問い合わせに対してのみ有効です。 その後、34.4の説明通りに、NULLを返すようになるまでPQgetResultを繰り返し呼び出してください。 問い合わせが何らかの行を返す場合、PGRES_TUPLES_OKではなくPGRES_SINGLE_TUPLEである点を除けば、通常の問い合わせ結果と同じように見える、個々のPGresultオブジェクトを返します。 最後の行の後、または問い合わせがゼロ行を返す場合は即座に、PGRES_TUPLES_OK状態のゼロ行のオブジェクトが返されます。 これはもう行が届かないことを通知するものです。 （しかしNULLが返るまでPQgetResultを呼び出さなければならないことに注意してください。） PGresultオブジェクトのすべては、その問い合わせに対する通常のPGresultと同一の行説明データ（列名、型など）を持ちます。 各オブジェクトは通常通りPQclearで解放しなければなりません。

When using pipeline mode, single-row mode needs to be activated for each query in the pipeline before retrieving results for that query with <function>PQgetResult</function>. See <xref linkend="libpq-pipeline-mode"/> for more information. パイプラインモードを使用する場合、単一行モードは、PQgetResultでその問い合わせの結果を取得する前に、パイプラインの各問い合わせに対してアクティブにする必要があります。 詳細は34.5を参照してください。