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

기다리지 않고 서버에 명령을 제출합니다. 결과. 명령이 성공적으로 수행되면 1이 반환됩니다. 전달되고 그렇지 않은 경우 0(이 경우 다음을 사용)PQerrorMessage더 많은 정보를 얻으려면 실패에 대해).

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

성공적으로 호출한 후PQsendQuery, 전화PQgetResult1회 이상 획득 결과입니다.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준비됨, PQsendDescribePrepared, 또는PQsendDescribePortal호출하고 반환 그것. 무지개 토토이 완료되면 널 포인터가 반환됩니다. 그러면 더 이상 결과가 나오지 않습니다.

PGresult *PQgetResult(PGconn *conn);

PQgetResult호출되어야 합니다 null 포인터를 반환할 때까지 반복적으로 다음을 나타냅니다. 명령이 완료되었습니다. (활성화된 명령이 없을 때 호출되는 경우,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및PQendcopy차단하지 않고 대신 다시 호출해야 하면 오류를 반환합니다.

참고하세요PQexec하지 않습니다 비차단 모드를 존중합니다. 호출되면 다음에서 작동합니다. 어쨌든 패션을 막는다.

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

int PQisnonblocking(const PGconn *conn);

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

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

int PQflush(PGconn *conn);