32.4. 비동기 와이즈 토토 처리

결과를 기다리지 않고 서버에 명령을 제출합니다. 명령이 성공적으로 전달되면 1이 반환되고, 그렇지 않으면 0이 반환됩니다. 이 경우에는 다음을 사용하세요.PQerrorMessage실패에 대한 추가 정보를 얻으려면).

int PQsendQuery(PGconn *conn, const char *command);

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

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

int PQsendQueryParams(PGconn *conn,
                      const char *명령,
                      정수 nParams,
                      const Oid *paramTypes,
                      const char * const *paramValues,
                      const int *paramLengths,
                      const int *paramFormats,
                      int resultFormat);

이것은 다음과 같습니다.PQsendQuery단, 쿼리 매개변수는 쿼리 문자열과 별도로 지정할 수 있습니다. 함수의 매개변수는 다음과 동일하게 처리됩니다.PQexecParams. 좋아요PQexecParams, 2.0 프로토콜 연결에서는 작동하지 않으며 쿼리 문자열에는 하나의 와이즈 토토만 허용됩니다.

완료를 기다리지 않고 주어진 매개변수를 사용하여 준비된 와이즈 토토문을 생성하라는 요청을 보냅니다.

int PQsendPrepare(PGconn *conn,
                  const char *stmt이름,
                  const char *쿼리,
                  정수 nParams,
                  const Oid *paramTypes);

이것은 비동기 버전입니다.PQprepare: 요청을 전달할 수 있으면 1을 반환하고 그렇지 않으면 0을 반환합니다. 통화가 성공한 후 전화하세요.PQgetResult서버가 준비된 명령문을 성공적으로 생성했는지 여부를 확인합니다. 함수의 매개변수는 다음과 동일하게 처리됩니다.PQprepare. 좋아요PQprepare, 2.0 프로토콜 연결에서는 작동하지 않습니다.

결과를 기다리지 않고 주어진 매개변수로 준비된 와이즈 토토문을 실행하라는 요청을 보냅니다.

int PQsendQueryPrepared(PGconn *conn,
                        const char *stmt이름,
                        정수 nParams,
                        const char * const *paramValues,
                        const int *paramLengths,
                        const int *paramFormats,
                        int resultFormat);

이것은 다음과 유사합니다.PQsendQueryParams, 그러나 쿼리 문자열을 제공하는 대신, 미리 준비된 명령문의 이름을 지정하여 실행할 명령을 지정합니다. 함수의 매개변수는 다음과 동일하게 처리됩니다.PQexec준비됨. 좋아요PQexec준비됨, 2.0 프로토콜 연결에서는 작동하지 않습니다.

완료를 기다리지 않고 지정된 준비된 명령문에 대한 정보를 얻기 위한 요청을 제출합니다.

int PQsendDescribePrepared(PGconn *conn, const char *stmtName);

이것은 비동기 버전입니다.PQdescribe준비됨: 요청을 전달할 수 있으면 1을 반환하고 그렇지 않으면 0을 반환합니다. 통화가 성공한 후 전화하세요.PQgetResult결과를 얻으려면. 함수의 매개변수는 다음과 동일하게 처리됩니다.PQdescribe준비됨. 좋다PQdescribe준비됨, 2.0 프로토콜 연결에서는 작동하지 않습니다.

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

int PQsendDescribePortal(PGconn *conn, const char *portalName);

이것은 비동기 버전입니다.PQdescribePortal: 요청을 전달할 수 있으면 1을 반환하고 그렇지 않으면 0을 반환합니다. 통화가 성공한 후 전화하세요.PQgetResult결과를 얻으려면. 함수의 매개변수는 다음과 동일하게 처리됩니다.PQdescribePortal. 좋아요PQdescribePortal, 2.0 프로토콜 연결에서는 작동하지 않습니다.

이전의 다음 결과를 기다립니다.PQsendQuery, PQsendQueryParams, PQsendPrepare, PQsendQuery준비됨, PQsendDescribe준비됨, 또는PQsendDescribePortal호출하고 반환합니다. 와이즈 토토이 완료되면 null 포인터가 반환되고 더 이상 결과가 없습니다.

PGresult *PQgetResult(PGconn *conn);

PQgetResult와이즈 토토이 완료되었음을 나타내는 널 포인터를 반환할 때까지 반복적으로 호출되어야 합니다. (활성화된 와이즈 토토이 없을 때 호출되는 경우,PQgetResult한 번에 null 포인터를 반환합니다.) null이 아닌 각 결과는PQgetResult동일한 것을 사용하여 처리되어야 합니다PGresult이전에 설명한 접근자 함수입니다. 다음을 사용하여 각 결과 객체를 해제하는 것을 잊지 마세요.PQclear완료되면. 참고하세요PQgetResult와이즈 토토이 활성화되어 있고 필요한 응답 데이터가 아직 읽혀지지 않은 경우에만 차단됩니다.PQconsumeInput.

서버에서 입력이 가능하다면, 그것을 소비하세요.

int PQconsumeInput(PGconn *conn);

PQconsumeInput일반적으로 다음을 나타내는 1을 반환합니다."오류 없음", 그러나 어떤 종류의 문제가 있는 경우 0을 반환합니다(이 경우PQerrorMessage상담 가능). 결과는 입력 데이터가 실제로 수집되었는지 여부를 나타내지 않습니다. 통화 후PQconsumeInput, 애플리케이션에서 확인할 수 있습니다PQisBusy및/또는PQ알림상태가 변경되었는지 확인합니다.

PQconsumeInput애플리케이션이 아직 결과나 알림을 처리할 준비가 되지 않은 경우에도 호출할 수 있습니다. 이 함수는 사용 가능한 데이터를 읽고 이를 버퍼에 저장하므로선택()읽기 준비 표시가 사라집니다. 따라서 애플리케이션은 다음을 사용할 수 있습니다.PQconsumeInput깨끗하게선택()즉시 조건을 설정하고 여유 시간에 결과를 검토하세요.

명령이 사용 중인 경우 1을 반환합니다. 즉,PQgetResult입력 대기를 차단합니다. 0 반환은 다음을 나타냅니다.PQgetResult차단하지 않는다는 확신을 갖고 호출할 수 있습니다.

int PQisBusy(PGconn *conn);

PQisBusy자체는 서버에서 데이터를 읽으려고 시도하지 않습니다. 그러므로PQconsumeInput먼저 호출해야 합니다. 그렇지 않으면 사용 중 상태가 끝나지 않습니다.

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

int PQsetnonblocking(PGconn *conn, int arg);

다음의 경우 연결 상태를 비차단으로 설정합니다.arg은 1이거나 다음과 같은 경우 차단argis 0. 정상이면 0을 반환하고 오류이면 -1을 반환합니다.

비차단 상태에서 호출PQsendQuery, PQputline, PQputnbytes, PQputCopyData및PQendcopy차단하지 않지만 대신 다시 호출해야 하는 경우 오류를 반환합니다.

참고하세요PQexec비차단 모드를 따르지 않습니다. 호출되면 어쨌든 패션을 차단하는 역할을 합니다.

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

int PQisnonblocking(const PGconn *conn);

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

대기 중인 출력 데이터를 서버로 플러시하려고 시도합니다. 성공하면(또는 보내기 큐가 비어 있으면) 0을 반환하고, 어떤 이유로 실패하면 -1을 반환하며, 보내기 큐에 있는 모든 데이터를 아직 보낼 수 없으면 1을 반환합니다(이 경우는 연결이 비차단인 경우에만 발생할 수 있습니다).

int PQflush(PGconn *conn);