31.4. 비동기 무지개 토토 처리

기다리지 않고 서버에 무지개 토토을 제출합니다. 결과). 무지개 토토이 성공적으로 있으면 1이 반환됩니다 파견 된 경우 0이 아닌 경우 (어떤 경우 사용PQERRORMESSAGE더 많은 정보를 얻으려면 실패에 대해).

int pqsendquery (pgconn *conn, const char *command);

성공적으로 전화 한 후pqsendquery, Callpqgetresult얻을 수있는 한 번 이상 결과.pqsendquery(동일한 연결에서) 다시 호출 할 수 없습니다pqgetresulta 널 포인터, 무지개 토토이 완료되었음을 나타냅니다.

서버에 무지개 토토 및 별도의 매개 변수를 제출합니다 결과를 기다리지 않고 (들)

int pqsendqueryparams (pgconn *conn,
                      const char *명령,
                      int nparams,
                      const oid *paramtypes,
                      const char * const * paramvalues,
                      const int *paramlengths,
                      const int *faramformats,
                      int resultformat);

이것은에 해당합니다.pqsendquery15299_15459pqexecparams. 좋다pqexecparams, 그렇지 않을 것입니다 2.0 protocol 연결에서 작업하면 하나만 허용합니다 쿼리 문자열의 무지개 토토.

완료를 기다리지 않고 매개 변수가 주어진다.

int pqsendprepare (pgconn *conn,
                  const char *stmtname,
                  const char *쿼리,
                  int nparams,
                  const oid *paramtypes);

이것은 비동기 버전의입니다.pqprepare: 가능하면 1을 반환합니다 요청을 발송하고 그렇지 않은 경우 0. 성공 후 전화, 전화pqgetresultTO 서버가 성공적으로 생성했는지 여부를 결정하십시오 준비된 진술. 함수의 매개 변수가 처리됩니다 동일하게pqprepare. 좋다pqprepare, 그렇지 않습니다 2.0 protocol 연결 작업.

준비한 문을 실행하라는 요청을 보냅니다 결과를 기다리지 않고 매개 변수가 주어진 매개 변수.

int pqsendqueryprepared (pgconn *conn,
                        const char *stmtname,
                        int nparams,
                        const char * const * paramvalues,
                        const int *paramlengths,
                        const int *faramformats,
                        int resultformat);

이것은와 유사합니다.pqsendqueryparams, 그러나 명령 실행 된 것은 이전에 준비된 준비를하여 지정됩니다 쿼리 문자열을 제공하는 대신 진술. 기능 매개 변수는 동일하게 처리됩니다pqExecprepared. 좋다pqExecprepared, 작동하지 않습니다 2.0 protocol 연결.

에 대한 정보를 얻기위한 요청을 제출합니다 대기하지 않고 지정된 준비된 진술 완성.

int pqsenddescribeprepared (pgconn *conn, const char *stmtname);

이것은 비동기 버전의입니다.PQDESCREPREPARED: 1이면 1을 반환합니다 요청을 파견 할 수 있었고, 그렇지 않은 경우 0. 후 성공적인 전화, 전화pqgetresult결과를 얻으려면. 그만큼 함수의 매개 변수는 동일하게 처리됩니다.PQDESCREPREPARED. 좋다PQDESCREPREPARED2.0 protocol 연결에서 작동하지 않습니다.

에 대한 정보를 얻기위한 요청을 제출합니다 완료를 기다리지 않고 지정된 포털.

int pqsenddescribePortal (pgconn *conn, const char *portalname);

이것은 비동기 버전의입니다.pqdescribePortal: 그렇다면 1이 반환됩니다 요청을 파견 할 수 있고 그렇지 않은 경우 0. 후 성공적인 전화, 전화pqgetresult결과를 얻으려면. 그만큼 함수의 매개 변수는 동일하게 처리됩니다.pqdescribePortal. 좋다pqdescribePortal, 그렇지 않을 것입니다 2.0 protocol 연결 작업.

사전에서 다음 결과를 기다립니다pqsendquery, pqsendqueryparams, pqsendprepare, pqsendqueryprepared, pqsenddescribeprepared또는pqsenddescribePortal전화를 걸어 반환합니다 그것. 무지개 토토이 완료되면 널 포인터가 반환됩니다. 그리고 더 이상 결과가 없을 것입니다.

pgresult *pqgetresult (pgconn *conn);

pqgetresult호출해야합니다 널 포인터를 반환 할 때까지 반복해서 나타냅니다 무지개 토토이 완료되었습니다. (무지개 토토이 활성화되지 않은 경우 호출되면pqgetresult그냥 돌아올 것입니다 한 번에 null 포인터.) 각각의 비 널은에서 비롯됩니다.pqgetresult동일한 것을 사용하여 처리pgresult액세서 기능 이전 설명. 로 각 결과 객체를 자유롭게하는 것을 잊지 마십시오.PQCLEAR완료되면. 참고pqgetresult의지 무지개 토토이 활성화되어 있고 필요한 경우에만 차단 응답 데이터는 아직 읽지 않았습니다.pqconsumeInput.

서버에서 입력을 사용할 수 있으면 소비하십시오.

int pqconsumeInput (pgconn *conn);

pqconsumeInput일반적으로 반환 1 표시"오류 없음", 그러나 어떤 종류의 문제가 있으면 0을 반환합니다 ( 사례PQERRORMESSAGE할 수 있습니다 상담). 결과는 어떤지 여부를 말하지 않습니다 입력 데이터가 실제로 수집되었습니다. 전화 후pqconsumeInput, 응용 프로그램이 확인할 수 있습니다PQISBUSY및/또는pqnotifies주 상태가 있는지 확인합니다 변경.

pqconsumeInput할 수 있습니다 응용 프로그램이 처리 할 준비가되지 않은 경우에도 호출 아직 결과 또는 알림. 함수가 읽습니다 사용 가능한 데이터 및 버퍼에 저장하여 A를 유발합니다.select ()읽기 준비 사라지는 징후. 따라서 응용 프로그램은 사용할 수 있습니다pqconsumeInputselect ()조건 즉시, 여가에서 결과를 조사하십시오.

무지개 토토이 바쁘면 1을 반환합니다. 즉,pqgetresult대기를 막을 것입니다 입력. 0 반환은를 나타냅니다.pqgetresult보증으로 호출 할 수 있습니다 차단되지 않음.

int pqisbusy (pgconn *conn);

PQISBUSY그 자체가 아닙니다 서버에서 데이터를 읽으려고 시도합니다. 그러므로pqconsumeInput먼저 호출되거나 바쁜 상태는 결코 끝나지 않을 것입니다.

연결의 비 차단 상태를 설정합니다.

int pqsetnonblocking (pgconn *conn, int arg);

if 비 블로킹에 연결 상태를 설정합니다.argIS 1 또는 if 차단arg는 0입니다. OK 인 경우 0, -1 if를 반환합니다 오류.

비 차단 상태에서 전화pqsendquery, pqputline, pqputnbytes및PQENDCOPY대신 차단되지 않고 대신 다시 호출 해야하는 경우 오류를 반환합니다.

참고PQEXEC그렇지 않습니다 비 차단 모드를 존중하십시오. 그것이 호출되면, 그것은 행동합니다 어쨌든 패션 차단.

데이터베이스의 차단 상태를 반환합니다 연결.

int pqisnonblocking (const pgconn *conn);

연결이 비 차단 모드로 설정된 경우 1 그리고 차단하면 0.

대기열 출력 데이터를 서버로 플러시하려고 시도합니다. 성공한 경우 0을 반환합니다 (또는 보내기 큐가 비어있는 경우), -1 어떤 이유로 실패한 경우, 또는 보낼 수없는 경우 1 Send 큐의 모든 데이터는 아직 연결이 차단되지 않은 경우 발생합니다).

int pqflush (pgconn *conn);