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

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

이 함수는 두 매개변수에서 가져온 매개변수를 사용하여 새 데이터베이스 토토 꽁 머니을 엽니다.NULL-종료된 어레이. 첫 번째,키워드은 문자열 배열로 정의되며 각 문자열은 키워드입니다. 두 번째,값, 각 키워드의 값을 제공합니다. 같지 않은PQsetdb로그인아래에서 매개변수 세트는 함수 서명을 변경하지 않고 확장될 수 있으므로 이 함수(또는 비차단 아날로그)를 사용합니다.PQconnectStartParams그리고PQconnectPoll)은 새로운 애플리케이션 프로그래밍에 선호됩니다.

현재 인식된 매개변수 키워드는 다음에 나열되어 있습니다.섹션 33.1.2.

전달된 배열은 모든 기본 매개변수를 사용하기 위해 비어 있거나 하나 이상의 매개변수 설정을 포함할 수 있습니다. 길이가 일치해야 합니다. 처리가 처음부터 중지됩니다.NULL항목키워드배열. 또한 만약에값비-와 연관된 항목NULL 키워드항목은NULL또는 빈 문자열인 경우 해당 항목은 무시되고 다음 배열 항목 쌍으로 처리가 계속됩니다.

언제expand_dbname0이 아닌 경우 첫 번째 값db이름키워드가 다음과 같은지 확인합니다.토토 꽁 머니 문자열. 그렇다면 그렇군요“확장”문자열에서 추출된 개별 토토 꽁 머니 매개변수에 포함됩니다. 값에 등호()가 포함된 경우 데이터베이스 이름이 아닌 토토 꽁 머니 문자열로 간주됩니다.=) 또는 URI 체계 지정자로 시작됩니다. (토토 꽁 머니 문자열 형식에 대한 자세한 내용은 다음에 나와 있습니다.섹션 33.1.1.) 첫 번째 발생만db이름이런 식으로 처리됩니다. 모든 후속db이름매개변수는 일반 데이터베이스 이름으로 처리됩니다.

일반적으로 매개변수 배열은 처음부터 끝까지 처리됩니다. 키워드가 반복되면 마지막 값(즉,NULL또는 비어 있음)이 사용됩니다. 이 규칙은 특히 토토 꽁 머니 문자열에서 발견된 키워드가에 나타나는 키워드와 충돌할 때 적용됩니다.키워드배열. 따라서 프로그래머는 배열 항목을 토토 꽁 머니 문자열에서 가져온 값으로 재정의하거나 재정의할 수 있는지 여부를 결정할 수 있습니다. 확장 앞에 나타나는 배열 항목db이름항목은 토토 꽁 머니 문자열의 필드로 재정의될 수 있으며, 해당 필드는 뒤에 나타나는 배열 항목으로 재정의됩니다.db이름(그러나 해당 항목이 비어 있지 않은 값을 제공하는 경우에만 해당).

모든 배열 항목과 확장된 토토 꽁 머니 문자열을 처리한 후 설정되지 않은 상태로 남아 있는 모든 토토 꽁 머니 매개변수는 기본값으로 채워집니다. 설정되지 않은 매개변수의 해당 환경 변수(참조PostgreSQL : 문서 : 12 : 33.14. 환경 토토 핫)이 설정되면 해당 값이 사용됩니다. 환경 변수도 설정되지 않은 경우 매개변수에 내장된 기본값이 사용됩니다.

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

PGconn *PQconnectdb(const char *conninfo);

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

전달된 문자열은 모든 기본 매개변수를 사용하기 위해 비어 있을 수 있습니다. 또는 공백으로 구분된 하나 이상의 매개변수 설정을 포함할 수 있습니다. 또는 다음을 포함할 수 있습니다.URI. 보다섹션 33.1.1자세한 내용은.

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

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이름포함=서명하거나 유효한 토토 꽁 머니이 있음URI접두사, 다음과 같이 간주됩니다.콘인포문자열은 전달된 것과 똑같은 방식으로PQconnectdb, 나머지 매개변수는 지정된 대로 적용됩니다.PQconnectdbParams.

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

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

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

비차단 방식으로 데이터베이스 서버에 토토 꽁 머니하십시오.

PGconn *PQconnectStartParams(const char * const *키워드,
                             const char * const *값,
                             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다양한 제한 사항이 충족되는 한 차단됩니다.

비차단 토토 꽁 머니 요청을 시작하려면 다음을 호출하세요.PQconnectStart또는PQconnectStartParams. 결과가 null이면, 다음은libpq새 항목을 할당할 수 없습니다.PGconn구조. 그렇지 않으면 유효한PGconn포인터가 반환됩니다(아직 데이터베이스에 대한 유효한 토토 꽁 머니을 나타내지는 않지만). 다음 통화PQ상태(conn). 결과가 다음과 같다면CONNECTION_BAD, 토토 꽁 머니 시도가 이미 실패했습니다. 일반적으로 잘못된 토토 꽁 머니 매개변수로 인해 발생합니다.

만약PQconnectStart또는PQconnectStartParams성공, 다음 단계는 설문 조사입니다.libpq그래서 토토 꽁 머니 순서를 진행할 수 있습니다. 사용PQsocket(콘)데이터베이스 토토 꽁 머니의 기본 소켓 설명자를 가져옵니다. (주의: 소켓이 동일하게 유지된다고 가정하지 마십시오.PQconnectPoll호출.) 다음과 같이 반복하세요: IfPQconnectPoll(conn)마지막 반환PGRES_POLLING_READING, 소켓이 읽을 준비가 될 때까지 기다립니다(다음으로 표시됨).선택(), 설문조사()또는 유사한 시스템 기능). 그럼 전화하세요PQconnectPoll(conn)다시. 반대로 만약에PQconnectPoll(conn)마지막 반환PGRES_POLLING_WRITING, 소켓이 쓸 준비가 될 때까지 기다린 후 호출PQconnectPoll(conn)다시. 첫 번째 반복에서, 즉 아직 전화하지 않은 경우PQconnectPoll, 마지막으로 반환된 것처럼 동작PGRES_POLLING_WRITING. 다음까지 이 루프를 계속하세요.PQconnectPoll(conn)반환PGRES_POLLING_FAILED, 토토 꽁 머니 절차가 실패했음을 나타냄, 또는PGRES_POLLING_OK, 토토 꽁 머니이 성공적으로 이루어졌음을 나타냅니다.

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

이러한 상수는 (호환성을 유지하기 위해) 유지되지만 응용 프로그램은 이러한 상수가 특정 순서로 발생하거나 전혀 의존해서는 안 되며 항상 문서화된 값 중 하나인 상태에 의존해서는 안 됩니다. 애플리케이션은 다음과 같은 작업을 수행할 수 있습니다.

스위치(PQstatus(conn))

        사례 CONNECTION_STARTED:
            Feedback = "토토 꽁 머니 중...";
            부서지다;

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

그connect_timeout사용 시 토토 꽁 머니 매개변수가 무시됩니다.PQconnectPoll; 과도한 시간이 경과했는지 여부를 결정하는 것은 애플리케이션의 책임입니다. 그렇지 않으면,PQconnectStart다음에 aPQconnectPoll루프는 다음과 같습니다.PQconnectdb.

언제든지 주의하세요PQconnectStart또는PQconnectStartParams널이 아닌 포인터를 반환합니다. 호출해야 합니다.PQfinish작업이 끝나면 구조 및 관련 메모리 블록을 폐기하기 위해. 토토 꽁 머니 시도가 실패하거나 중단된 경우에도 이 작업을 수행해야 합니다.

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

PQconninfoOption *PQconndefaults(void);

typedef 구조체

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

토토 꽁 머니 옵션 배열을 반환합니다. 이는 가능한 모든 것을 결정하는 데 사용될 수 있습니다.PQconnectdb옵션 및 현재 기본값. 반환 값은의 배열을 가리킵니다.PQconninfo옵션null이 있는 항목으로 끝나는 구조키워드포인터. 메모리를 할당할 수 없으면 널 포인터가 반환됩니다. 현재 기본값(발필드)는 환경 변수 및 기타 컨텍스트에 따라 달라집니다. 누락되거나 유효하지 않은 서비스 파일은 자동으로 무시됩니다. 호출자는 토토 꽁 머니 옵션 데이터를 읽기 전용으로 처리해야 합니다.

옵션 배열을 처리한 후 다음으로 전달하여 해제하십시오.PQconninfoFree. 그렇지 않으면 호출할 때마다 소량의 메모리가 누출됩니다.PQconndefaults.

실시간 토토 꽁 머니에 사용되는 토토 꽁 머니 옵션을 반환합니다.

PQconninfo옵션 *PQconninfo(PGconn *conn);

토토 꽁 머니 옵션 배열을 반환합니다. 이는 가능한 모든 것을 결정하는 데 사용될 수 있습니다.PQconnectdb옵션 및 서버에 토토 꽁 머니하는 데 사용된 값. 반환 값은의 배열을 가리킵니다.PQconninfo옵션null이 있는 항목으로 끝나는 구조키워드포인터. 위의 모든 참고사항은PQconndefaults다음 결과에도 적용PQconninfo.

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

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

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

모든 적법한 옵션이 결과 배열에 표시되지만PQconninfo옵션토토 꽁 머니 문자열에 없는 옵션의 경우발다음으로 설정됨NULL; 기본값은 삽입되지 않습니다.

만약errmsg아닙니다NULL그러면*errmsg다음으로 설정됨NULL성공 시, 그렇지 않으면 amalloc34408_34475*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.

PQpingParams서버의 상태를 보고합니다. 다음과 동일한 토토 꽁 머니 매개변수를 허용합니다.PQconnectdbParams, 위에 설명되어 있습니다. 서버 상태를 얻기 위해 올바른 사용자 이름, 비밀번호 또는 데이터베이스 이름 값을 제공할 필요는 없습니다. 그러나 잘못된 값이 제공되면 서버는 실패한 토토 꽁 머니 시도를 기록합니다.

PGPing PQpingParams(const char * const *keywords,
                    const char * const *값,
                    int 확장_db이름);

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

PQ핑서버의 상태를 보고합니다. 다음과 동일한 토토 꽁 머니 매개변수를 허용합니다.PQconnectdb, 위에 설명되어 있습니다. 서버 상태를 얻기 위해 올바른 사용자 이름, 비밀번호 또는 데이터베이스 이름 값을 제공할 필요는 없습니다. 그러나 잘못된 값이 제공되면 서버는 실패한 토토 꽁 머니 시도를 기록합니다.

PGPing PQping(const char *conninfo);

반환 값은 다음과 동일합니다.PQpingParams.