31.1. 데이터베이스 윈 토토 제어 기능

데이터베이스 서버에 새로운 윈 토토을 만듭니다.

PGconn *PQconnectdbParams(const char **키워드, const char **값, int Expand_dbname);

이 함수는 다음을 사용하여 새 데이터베이스 윈 토토을 엽니다. 두 개에서 가져온 매개변수NULL-종료된 어레이. 첫 번째,키워드는 문자열 배열로 정의됩니다. 각각이 핵심 단어입니다. 두 번째,값, 각 키워드의 값을 제공합니다. 달리PQsetdb로그인아래, 매개변수 세트는 변경 없이 확장될 수 있습니다. 함수 서명이므로 이 함수(또는 그 비차단 아날로그PQconnectStartParams그리고PQconnectPoll)는 새 항목에 선호됩니다. 응용 프로그램 프로그래밍.

언제expand_dbname0이 아닙니다.db이름키워드 값은 다음과 같습니다. a로 인식되도록 허용됨콘인포문자열. 자세한 내용은 아래를 참조하세요. 세부사항.

전달된 배열은 모든 기본값을 사용하기 위해 비어 있을 수 있습니다 매개변수이거나 하나 이상의 매개변수 설정을 포함할 수 있습니다. 길이가 일치해야 합니다. 처리가 중지됩니다. 마지막 비-NULL요소키워드배열.

현재 인식되는 매개변수 키워드는 다음과 같습니다:

매개변수가 지정되지 않은 경우 해당 환경 변수(참조섹션 31.13)가 확인되었습니다. 만약 환경 변수도 설정되지 않은 경우 표시된 내장된 기본값이 사용됩니다.

만약expand_dbname0이 아닙니다. 그리고db이름포함=sign, 그것은 다음과 같이 간주됩니다.콘인포문자열과 정확히 같은 방식으로 전달된 경우PQconnectdb(아래 참조). 이전에는 처리된 키워드는의 키워드로 재정의됩니다.콘인포문자열.

일반적으로 키워드는 다음의 처음부터 처리됩니다. 이 배열은 인덱스 순서로 되어 있습니다. 이것의 효과는 다음과 같습니다 키워드가 반복되면 마지막으로 처리된 값은 유지됩니다. 따라서 신중한 배치를 통해db이름키워드, 가능합니다 a에 의해 재정의될 수 있는 항목을 결정합니다.콘인포문자열, 그리고 그렇지 않을 수도 있습니다.

데이터베이스 서버에 새로운 윈 토토을 만듭니다.

PGconn *PQconnectdb(const char *conninfo);

이 함수는 다음을 사용하여 새 데이터베이스 윈 토토을 엽니다. 문자열에서 가져온 매개변수콘인포.

전달된 문자열은 모든 기본값을 사용하기 위해 비어 있을 수 있습니다 매개변수 또는 하나 이상의 매개변수를 포함할 수 있습니다. 공백으로 구분된 설정입니다. 각 매개변수 설정은 형식으로키워드 = 값. 등호 주위의 공백은 선택 사항입니다. 작성하려면 빈 값 또는 공백이 포함된 값은 다음으로 묶습니다. 작은따옴표(예:키워드 = 'a 값'. 값 내의 작은따옴표 및 백슬래시 백슬래시로 이스케이프해야 합니다. 즉,\'그리고\\.

현재 인식되는 매개변수 키워드는 위와 같습니다.

데이터베이스 서버에 새로운 윈 토토을 만듭니다.

PGconn *PQsetdbLogin(const char *pghost,
                     const char *pgport,
                     const char *pgoptions,
                     const char *pgtty,
                     const char *db이름,
                     const char *로그인,
                     const char *pwd);

이것은 다음의 전신입니다.PQconnectdb고정 세트 포함 매개변수. 제외하고는 동일한 기능을 가지고 있습니다. 누락된 매개변수는 항상 기본값을 사용합니다. 쓰기NULL또는 다음에 대한 빈 문자열 고정 매개변수 중 하나 기본값입니다.

만약에db이름포함=sign, 그것은 다음과 같이 간주됩니다.콘인포문자열과 정확히 같은 방식으로 전달된 경우PQconnectdb및 나머지 매개변수 그러면 위와 같이 적용됩니다.

데이터베이스 서버에 새로운 윈 토토을 만듭니다.

PGconn *PQsetdb(char *pghost,
                char *pgport,
                char *pgoptions,
                문자 *pgtty,
                char *dbName);

이것은 호출하는 매크로입니다PQsetdb로그인에 대한 널 포인터 포함로그인그리고비밀번호매개변수. 다음을 위해 제공됩니다. 아주 오래된 프로그램과의 하위 호환성.

다음에서 데이터베이스 서버에 윈 토토하십시오. 비차단 방식.

PGconn *PQconnectStartParams(const char **키워드,
                             const char **값,
                             int 확장_db이름);

PGconn *PQconnectStart(const char *conninfo);

PostgresPollingStatusType PQconnectPoll(PGconn *conn);

이 세 가지 기능은 윈 토토을 여는 데 사용됩니다. 애플리케이션의 스레드가 그렇게 하는 동안 원격 I/O에서는 실행이 차단되지 않습니다. 는 이 접근 방식의 요점은 I/O가 완료될 때까지 기다린다는 것입니다. 완료는 애플리케이션의 메인 루프에서 발생할 수 있습니다. 안쪽보다PQconnectdbParams또는PQconnectdb이므로 애플리케이션은 이 작업을 다른 작업과 병행하여 관리 활동.

함께PQconnectStartParams, 데이터베이스 윈 토토은 가져온 매개변수를 사용하여 이루어집니다. 에서키워드그리고값배열 및 제어expand_dbname, 위에서 설명한 대로PQconnectdbParams.

함께PQconnectStart, 데이터베이스 윈 토토은 다음에서 가져온 매개변수를 사용하여 이루어집니다. 문자열콘인포설명대로 위에 대한PQconnectdb.

둘 다 아님PQconnectStartParams아니요PQconnectStart아니요PQconnectPoll차단됩니다. 제한 사항 수가 충족되었습니다:

• 그호스트주소그리고호스트매개변수가 적절하게 사용되었습니다. 이름 및 역방향 이름 쿼리가 발생하지 않도록 하기 위해 만들어졌습니다. 다음 매개변수에 대한 문서를 참조하세요.PQconnectdbParams위 자세한 내용은.

• 부르신다면PQtrace, 추적하는 스트림 객체가 차단하지 마세요.

• 소켓이 적절한 위치에 있는지 확인하세요 전화하기 전 상태PQconnectPoll, 설명대로 아래.

참고: 다음의 사용PQconnectStartParams유사함PQconnectStart표시됨 아래.

비차단 윈 토토 요청을 시작하려면 다음을 호출하세요.conn = PQconnectStart("connection_info_stri윈 토토"). 만일콘null이면libpq할당할 수 없습니다. 새로운PGconn구조. 그렇지 않으면 유효한PGconn포인터가 반환됩니다(아직 유효한 값을 나타내지는 않지만). 데이터베이스에 윈 토토). 돌아오는 길에PQconnectStart, 전화상태 = PQ상태(conn). 만일상태같음CONNECTION_BAD, PQconnectStart실패했습니다.

만약PQconnectStart성공, 다음 단계는 설문 조사입니다.libpq그래서 다음 작업을 진행할 수 있습니다. 윈 토토 순서. 사용PQsocket(콘)설명자를 얻으려면 데이터베이스 윈 토토의 기본 소켓입니다. 루프 따라서: 만약PQconnectPoll(conn)마지막 반환PGRES_POLLI윈 토토_READI윈 토토, 소켓이 나올 때까지 기다리세요 읽을 준비가 되었습니다(다음으로 표시됨).선택(), 설문조사()또는 유사한 시스템 기능). 그런 다음 전화PQconnectPoll(콘)다시. 반대로 만약에PQconnectPoll(conn)마지막 반환PGRES_POLLI윈 토토_WRITI윈 토토, 까지 기다리세요 소켓이 쓸 준비가 된 다음 호출합니다.PQconnectPoll(conn)다시. 만약 당신이 아직 전화 안함PQconnectPoll, 즉, 호출 직후에PQconnectStart, 마지막인 것처럼 행동하세요 반환됨PGRES_POLLI윈 토토_WRITI윈 토토. 다음까지 이 루프를 계속하세요.PQconnectPoll(conn)반환PGRES_POLLI윈 토토_FAILED, 이는 다음을 나타냅니다. 윈 토토 절차가 실패했거나PGRES_POLLI윈 토토_OK, 윈 토토을 나타냄 성공적으로 만들어졌습니다.

윈 토토 중 언제든지 상태는 전화로 윈 토토을 확인할 수 있습니다PQ상태. 이 호출이 반환되는 경우CONNECTION_BAD다음 윈 토토 절차 실패했습니다. 전화가 돌아오면CONNECTION_OK그러면 윈 토토은 다음과 같습니다. 준비. 이 두 상태 모두에서 동일하게 감지할 수 있습니다. 반환 값PQconnectPoll, 위에 설명되어 있습니다. 기타 상태는 실행 중에(및 실행 중에만) 발생할 수도 있습니다. 비동기 윈 토토 절차. 이는 다음을 나타냅니다. 윈 토토 절차의 현재 단계이며 예를 들어 사용자에게 피드백을 제공하는 데 유용합니다. 이것들 상태는 다음과 같습니다:

이 상수는 그대로 유지되지만( 호환성을 유지하기 위해) 애플리케이션은 다음과 같이 해야 합니다. 이러한 일이 특정 순서로 발생한다고 절대 의존하지 마십시오. 전혀, 또는 항상 다음 중 하나인 상태 문서화된 값. 애플리케이션은 다음과 같은 작업을 수행할 수 있습니다. 이:

스위치(PQstatus(conn))

        사례 CONNECTION_STARTED:
            Feedback = "윈 토토 중...";
            부서지다;

        사례 CONNECTION_MADE:
            Feedback = "서버에 윈 토토되었습니다...";
            부서지다;
.
.
.
        기본값:
            Feedback = "윈 토토 중...";

그connect_timeout윈 토토 사용 시 매개변수가 무시됩니다.PQconnectPoll; 그것은 응용 프로그램의 과도한 금액인지 여부를 결정하는 책임 시간이 지났습니다. 그렇지 않으면,PQconnectStart다음에 aPQconnectPoll루프는와 동일합니다.PQconnectdb.

만약에 주의하세요PQconnectStartnull이 아닌 값을 반환합니다. 포인터를 호출해야 합니다.PQfinish작업이 끝나면, 구조물과 관련된 모든 것을 처분하기 위해 메모리 블록. 윈 토토이 되더라도 이 작업을 수행해야 합니다. 시도가 실패하거나 중단되었습니다.

기본 윈 토토 옵션을 반환합니다.

PQconninfoOption *PQconndefaults(void);

typedef 구조체

    char *키워드;   /* 옵션의 키워드 */
    char *envvar;    /* 대체 환경 변수 이름 */
    char *컴파일됨;  /* 기본값으로 컴파일된 폴백 */
    char *발;       /* 옵션의 현재 값, 또는 NULL */
    char *레이블;     /* 윈 토토 대화 상자의 필드 레이블 */
    char *dispchar;  /* 이 필드를 표시하는 방법을 나타냅니다.
                          윈 토토 대화 상자에서. 값은 다음과 같습니다.
                          "" 입력된 값을 그대로 표시
                          "*" 비밀번호 필드 - 값 숨기기
                          "D" 디버그 옵션 - 기본적으로 표시되지 않음 */
    int dispsize;  /* 대화상자의 필드 크기(문자) */
 PQconninfoOption;

윈 토토 옵션 배열을 반환합니다. 이것은 다음에 사용될 수 있습니다 가능한 모든 것을 결정PQconnectdb옵션 및 현재 기본값. 반환 값은의 배열을 가리킵니다.PQconninfo옵션구조, null이 있는 항목으로 끝납니다.키워드포인터. 널 포인터는 메모리를 할당할 수 없는 경우 반환됩니다. 참고 현재 기본값(발필드)는 환경 변수 및 기타 사항에 따라 달라집니다. 맥락. 호출자는 윈 토토 옵션 데이터를 다음과 같이 처리해야 합니다. 읽기 전용입니다.

옵션 배열을 처리한 후 다음을 전달하여 해제하십시오. 그것을PQconninfoFree. 만약 이 완료되지 않으면 각각에 대해 소량의 메모리가 누출됩니다. 전화하세요PQconndefaults.

제공된 윈 토토 옵션에서 구문 분석된 윈 토토 옵션을 반환합니다. 윈 토토 문자열.

PQconninfoOption *PQconninfoParse(const char *conninfo, char **errmsg);

윈 토토 문자열을 구문 분석하고 결과를 반환합니다. 옵션을 배열로; 또는 반품NULL에 문제가 있는 경우 윈 토토 문자열. 이 함수는를 추출하는 데 사용할 수 있습니다.PQconnectdb옵션 제공된 윈 토토 문자열. 반환 값은 다음을 가리킵니다. 배열PQconninfo옵션null이 있는 항목으로 끝나는 구조키워드포인터.

다음에 명시적으로 지정된 옵션만 참고하세요. 문자열은 결과 배열에 설정된 값을 갖습니다. 아니 기본값이 삽입됩니다.

만약errmsg아닙니다NULL그러면*errmsg다음으로 설정됨NULL성공 시, 그렇지 않으면 에malloc' 오류 문자열 문제를 설명합니다. (또한 가능합니다.*errmsg다음으로 설정됨NULL및 반환할 함수NULL; 이는 메모리 부족을 나타냅니다. 조건.)

옵션 배열을 처리한 후 다음을 전달하여 해제하십시오. 그것을PQconninfoFree. 만약 이 완료되지 않으면 호출할 때마다 일부 메모리가 누수됩니다.PQconninfoParse. 반대로, 오류가 발생하는 경우 및errmsg이다 아님NULL, 오류를 해제했는지 확인하세요. 문자열을 사용하여PQfreemem.

서버에 대한 윈 토토을 닫습니다. 또한 메모리를 해제합니다. 에서 사용함PGconn객체.

void PQfinish(PGconn *conn);

서버 윈 토토 시도가 실패하더라도 주의하세요 (표시된 대로PQ상태), 애플리케이션이 호출해야 합니다.PQfinish다음에서 사용하는 메모리를 해제합니다.PGconn개체.PGconn포인터는 다시 사용되어서는 안 됩니다 이후PQfinish이되었습니다 전화했어요.

서버와의 통신 채널을 재설정합니다.

void PQreset(PGconn *conn);

이 함수는 서버와의 윈 토토을 종료합니다 그리고 동일한 윈 토토에 대한 새로운 윈 토토을 다시 시도합니다. 서버에서는 이전에 사용한 것과 동일한 매개변수를 모두 사용합니다. 이 윈 토토이 작동하는 경우 오류 복구에 유용할 수 있습니다. 분실되었습니다.

서버에 대한 통신 채널을 재설정합니다. 비차단 방식.

int PQresetStart(PGconn *conn);

PostgresPollingStatusType PQresetPoll(PGconn *conn);

이 기능은 서버와의 윈 토토을 종료합니다 그리고 동일한 윈 토토에 대한 새로운 윈 토토을 다시 시도합니다. 서버에서는 이전에 사용한 것과 동일한 매개변수를 모두 사용합니다. 이 윈 토토이 작동 중인 경우 오류 복구에 유용할 수 있습니다. 길을 잃었다. 그들은 다음과 다릅니다.PQreset(위) 그들은 다음과 같이 행동한다는 점에서 비차단 방식. 이러한 기능은 동일한 문제를 겪습니다. 다음과 같은 제한 사항PQconnectStartParams, PQconnectStart그리고PQconnectPoll.

윈 토토 재설정을 시작하려면 다음을 호출하세요.PQresetStart. 0을 반환하면 재설정됩니다. 실패했습니다. 1이 반환되면 다음을 사용하여 재설정을 폴링합니다.PQresetPoll정확히는 다음을 사용하여 윈 토토을 생성하는 것과 같은 방식으로PQconnectPoll.

PQpi윈 토토Params보고합니다 서버의 상태. 윈 토토 매개변수를 허용합니다. 와 동일PQconnectdbParams, 위에 설명되어 있습니다. 그것은 그러나 올바른 사용자 이름을 제공하는 데 반드시 필요한 것은 아닙니다. 서버를 얻기 위한 비밀번호 또는 데이터베이스 이름 값 상태.

PGPing PQpi윈 토토Params(const char **키워드, const char **값, int Expand_dbname);

함수는 다음 값 중 하나를 반환합니다:

PQpi윈 토토상태를 보고합니다. 서버의. 동일한 윈 토토 매개변수를 허용합니다. 그들에게PQconnectdb, 위에서 설명한. 그러나 공급할 필요는 없습니다. 사용자 이름, 비밀번호 또는 데이터베이스 이름 값을 수정하여 서버 상태를 가져옵니다.

PGPing PQpi윈 토토(const char *conninfo);

반환 값은 다음과 동일합니다.PQpi윈 토토Params.