32.5. 사설 토토 결과 검색 row-row

보통,libpqSQL 명령의 전체 결과를 수집하여 응용 프로그램에 단일로 반환합니다pgresult. 많은 수의 행을 반환하는 명령에 대해서는 불가능할 수 있습니다.pqsendqueryandpqgetresultin단일 로우 모드. 이 모드에서는 결과 행이 서버에서 수신되면서 한 번에 하나씩 응용 프로그램으로 반환됩니다.

싱글 열 모드로 들어가려면 전화pqsetsinglerowmode성공적인 전화 직후pqsendquery(또는 형제 기능). 이 모드 선택은 현재 실행중인 쿼리에만 효과적입니다.pqgetresult반복적으로, null을 반환 할 때까지, 문서화 된대로섹션 32.4. 사설 토토가 행을 반환하면 개인으로 반환됩니다pgresult객체, 상태 코드를 제외한 일반적인 사설 토토 결과처럼 보이는 객체pgres_single_tuple대신pgres_tuples_ok. 마지막 행 후 또는 사설 토토가 0 행을 반환하는 경우 즉시, 상태가있는 제로 로우 객체pgres_tuples_ok반환됩니다. 이것은 더 이상 행이 도착하지 않을 것이라는 신호입니다.pqgetresultNULL을 반환 할 때까지.) 이들 모두pgresult개체는 평범한 것과 동일한 행 설명 데이터 (열 이름, 유형 등)를 포함합니다pgresult사설 토토의 개체. 각 객체는PQCLEAR평소와 같이.