D'habitude, libpq récupère le résultat complet d'une commande SQL et la renvoie à l'application sous la forme d'une seule structure PGresult. Ce peut être impraticable pour les commandes renvoyant un grand nombre de lignes. Dans de tels cas, les applications peuvent utiliser PQsendQuery et PQgetResult dans le mode ligne-à-ligne. Dans ce mode, les lignes du résultat sont renvoyées à l'application une par une, au fur et à mesure qu'elles sont reçues du serveur.

Pour entrer dans le mode ligne-à-ligne, appelez PQsetSingleRowMode immédiatement après un appel réussi à PQsendQuery (ou une fonction similaire). Cette sélection de mode ne fonctionne que pour la requête en cours d'exécution. Puis appelez PQgetResult de façon répétée, jusqu'à ce qu'elle renvoit NULL, comme documenté dans Section 34.4. Si la requête renvoit des lignes, elles sont renvoyées en tant qu'objets PGresult individuels, qui ressemblent à des résultats de requêtes standards en dehors du fait qu'elles ont le code de statut PGRES_SINGLE_TUPLE au lieu de PGRES_TUPLES_OK. Après la dernière ligne, ou immédiatement si la requête ne renvoit aucune ligne, un objet à zéro ligne avec le statut PGRES_TUPLES_OK est renvoyé ; c'est le signal qu'aucune autre ligne ne va arriver. (Notez cependant qu'il est toujours nécessaire de continuer à appeler PQgetResult jusqu'à ce qu'elle renvoit NULL.) Tous les objets PGresult contiendront les mêmes données de description de lignes (noms de colonnes, types, etc.) qu'un objet PGresult standard aurait pour cette requête. Chaque objet doit être libéré avec la fonction PQclear comme d'ordinaire.

Lors de l'utilisation du mode pipeline, le mode single-row doit être activé pour chaque requête dans le pipeline avant de récupérer les résultats pour cette requête avec PQgetResult. Voir Section 34.5 pour plus d' informations.