31.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호출하고 반환합니다. 널 명령이 완료되면 포인터가 반환되고 더 이상 결과가 없습니다.

PGresult *PQgetResult(PGconn *conn);

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

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

int PQconsumeInput(PGconn *conn);

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

PQconsumeInput심지어 호출 가능 애플리케이션이 결과를 처리할 준비가 되어 있지 않거나 아직 알림이 없습니다. 이 함수는 사용 가능한 데이터를 읽고 버퍼에 저장하면 다음과 같은 오류가 발생합니다.선택()읽기 준비 표시가 사라집니다. 는 따라서 애플리케이션은 다음을 사용할 수 있습니다.PQconsumeInput깨끗하게선택()즉시 조건을 설정하고 검사하세요. 결과는 여유롭게.

명령이 사용 중인 경우 1을 반환합니다. 즉,PQgetResult입력 대기를 차단합니다. 0 return은 다음을 나타냅니다.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);