31.4. 비동기 토토 처리

결과를 기다리지 않고 서버에 토토을 제출합니다. 토토이 성공적으로 발송 된 경우 1이 반환되고 그렇지 않은 경우 0 (사용.PQERRORMESSAGE실패에 대한 자세한 정보를 얻으려면).

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

성공적으로 전화 한 후pqsendquery, Callpqgetresult결과를 얻기 위해 한 번 이상.pqsendquery(동일한 연결에서) 다시 호출 할 수 없습니다pqgetresult토토이 완료되었음을 나타내는 널 포인터를 반환했습니다.

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

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

이것은에 해당합니다.pqsendquery14749_14885pqexecparams. 좋다pqexecparams, 2.0 protocol 연결에서 작동하지 않으며 쿼리 문자열에서 하나의 토토 만 허용합니다..

완료를 기다리지 않고 주어진 매개 변수로 준비된 토토문을 작성하라는 요청을 보냅니다.

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

이것은 비동기 버전의입니다.pqprepare: 요청을 파견 할 수있는 경우 1, 그렇지 않은 경우 0이 반환됩니다. 성공적인 전화 후 전화pqgetresult서버가 준비된 토토문을 성공적으로 작성했는지 여부를 결정합니다. 함수의 매개 변수는 동일하게 처리됩니다.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, 그렇지 않은 경우 0이 반환됩니다. 성공적인 전화 후 전화pqgetresult결과를 얻으려면. 함수의 매개 변수는 동일하게 처리됩니다.PQDESCREPREPARED. 좋다PQDESCREPREPARED, 그것은 2.0 protocol 연결에서 작동하지 않습니다.

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

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

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

사전에서 다음 결과를 기다립니다pqsendquery, pqsendqueryparams, pqsendprepare, pqsendqueryprepared, pqsendDescribreprepared또는pqsenddescribePortal전화를 걸어 반환합니다. 토토이 완료되면 널 포인터가 반환되고 더 이상 결과가 없습니다.

pgresult *pqgetresult (pgconn *conn);

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

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

int pqconsumeInput (pgconn *conn);

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

pqconsumeInput응용 프로그램이 아직 결과 나 알림을 처리 할 준비가되어 있지 않더라도 호출 할 수 있습니다. 함수는 사용 가능한 데이터를 읽고 버퍼에 저장하여 A를 유발합니다.select ()사라질 준비가 된 표시. 따라서 응용 프로그램은 사용할 수 있습니다pqconsumeInputselect ()즉시 조건을 한 다음 여가에서 결과를 조사하십시오.

토토이 바쁘면 1, 즉 반환 1pqgetresult입력 대기 대기 블록. 0 반환은를 나타냅니다.pqgetresult차단되지 않는다는 확신으로 호출 할 수 있습니다.

int pqisbusy (pgconn *conn);

23138_23148자체가 서버에서 데이터를 읽으려고 시도하지 않습니다. 그러므로pqconsumeInput먼저 호출되어야합니다. 그렇지 않으면 바쁜 상태가 끝나지 않을 것입니다.

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

int pqsetnonblocking (pgconn *conn, int arg);

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

비 차단 상태에서pqsendquery, pqputline, PQPUTNBYTES및PQENDCOPY다시 전화를 걸지 않으면 오류를 다시 반환합니다.

참고PQEXEC비 차단 모드를 존중하지 않습니다. 그것이 부름을 받으면 어쨌든 패션을 차단하는 데 행동 할 것입니다.

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

int pqisnonblocking (const pgconn *conn);

연결이 차단 모드로 설정된 경우 1이고 차단하면 0을 반환합니다.

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

int pqflush (pgconn *conn);