30.1. 데이터베이스 스포츠 토토 베트맨 제어 기능

데이터베이스 서버에 새로 스포츠 토토 베트맨됩니다.

pgconn *pqconnectdb (const char *conninfo);

이 기능은 The를 사용하여 새 데이터베이스 스포츠 토토 베트맨을 엽니 다 문자열에서 가져온 매개 변수Conninfo. 같지 않은pqsetdblogin아래에서 매개 변수 세트가 할 수 있습니다 기능 서명을 변경하지 않고 확장하십시오 이 기능 중 (또는 비 차단 아날로그)PQConnectStartandPQConnectPoll)는 새로 선호됩니다 응용 프로그램 프로그래밍.

전달 된 문자열은 모든 기본값을 사용하기 위해 비어있을 수 있습니다. 매개 변수 또는 하나 이상의 매개 변수를 포함 할 수 있습니다 중학교로 분리 된 설정. 각 매개 변수 설정입니다 형식으로키워드 = value. 동일한 부호 주변의 공간은 선택 사항입니다. 글을 쓰기 위해 빈 값 또는 공간이 포함 된 값으로 단일 따옴표, 예 :키워드 = 'a 값'. 값 내의 단일 따옴표 및 백 슬래시 백 슬래시로 탈출해야합니다.\ 'and\\.

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

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

데이터베이스 서버에 새로 스포츠 토토 베트맨됩니다.

pgconn *pqsetdblogin (const char *pghost,
                     const char *pgport,
                     const char *pgoptions,
                     const char *pgtty,
                     const char *dbname,
                     const char *로그인,
                     const char *pwd);

이것은의 전임자입니다.PQCONNECTDB고정 세트가 있습니다 매개 변수. 그 기능을 제외하고는 동일한 기능이 있습니다 누락 된 매개 변수는 항상 기본값을 사용합니다. 쓰다null또는 빈 문자열 고정 된 매개 변수 중 하나 기본값.

dbname포함=사인, A로 간주됩니다.Conninfo정확히 같은 방식으로 문자열 통과 된 경우PQCONNECTDB및 나머지 매개 변수 그런 다음 위와 같이 적용됩니다.

데이터베이스 서버에 새로 스포츠 토토 베트맨됩니다.

pgconn *pqsetdb (char *pghost,
                char *pgport,
                char *pgoptions,
                char *pgtty,
                char *dbname);

이것은 호출하는 매크로입니다pqsetdblogin로그인및PWD매개 변수. 그것은 제공됩니다 아주 오래된 프로그램과의 역 호환성.

스포츠 토토 베트맨하십시오 비 차단 방식으로 데이터베이스 서버에.

PGCONN *PQCONNECTSTART (const char *conninfo);

PostGrespollingStatUstype PQConnectPoll (PgConn *Conn);

이 두 기능은 응용 프로그램의 스레드가되도록 데이터베이스 서버 그렇게하는 동안 원격 I/O에서 실행이 차단되지 않습니다. 그만큼 이 접근법의 요점은 I/O가 대기하는 것입니다. 오히려 애플리케이션의 기본 루프에서 완료가 발생할 수 있습니다 내부 아래에서PQCONNECTDB, 따라서 응용 프로그램은이 작업을 관리 할 수 ​​있습니다 다른 활동과 평행.

데이터베이스 연결은 매개 변수를 사용하여 이루어집니다 문자열에서 가져온Conninfo, 전달PQConnectStart. 이 문자열은 위에서 설명한 것과 동일한 형식입니다.PQCONNECTDB.

아니PQConnectStartNORPQConnectPoll많은 제한이 충족되는 한 :

• thehostaddr및host매개 변수는 적절하게 사용됩니다 해당 이름과 반대 이름 쿼리가 만들어진. 아래 에서이 매개 변수의 문서를 참조하십시오PQCONNECTDB위 세부.

• 전화하면pqtrace, 추적하는 스트림 객체가 차단하지 않습니다.

• 소켓이 적절한 지 확인하십시오 전화 전 상태pqconnectpoll34235_34270

블로킹되지 않은 스포츠 토토 베트맨 요청을 시작하려면 전화conn = pqConnectStart ( "Connection_info_string"). 만약에Connlibpq할당 할 수 없었습니다 새로운pgconn구조. 그렇지 않으면 유효한pgconn포인터가 반환되었습니다 (아직 유효한 것을 나타내지는 않지만 데이터베이스 연결). 에서 돌아온시PQConnectStart, Call상태 = pqstatus (conn). 만약에상태equalsConnection_Bad, PQConnectStart실패했습니다.

ifPQConnectStart성공, 다음 단계는 투표하는 것입니다libpq연결 순서. 사용pqsocket (conn)설명자를 얻으려면 데이터베이스 연결의 기본 소켓 고리 따라서 : ifPQCONNECTPOLL (CONN)마지막 반품pgres_polling_reading, 소켓까지 기다리십시오 읽을 준비가되었습니다 (select (), poll ()또는 유사한 시스템 기능). 그 다음에 부르다PQConnectPoll (Conn)다시. 반대로, ifPQConnectPoll (Conn)마지막 반품pgres_polling_writing, 기다릴 때까지 기다리십시오 소켓이 쓸 준비가되었고 전화pqconnectpoll (conn)다시. 당신이 있다면 아직 전화 할 것PQConnectPoll, 즉, 호출 직후PQConnectStart, 마치 마치 마치 마치 행동합니다 반품pgres_polling_writing. 이 루프를 계속할 때까지PQConnectPoll (Conn)반환pgres_polling_failed, 스포츠 토토 베트맨 절차가 실패했거나pgres_polling_ok, 스포츠 토토 베트맨을 나타냅니다 성공적으로 만들어졌습니다.

연결하는 동안 언제든지의 상태 연결을 호출하여 확인할 수 있습니다PQSTATUS. 이것이주는 경우Connection_Bad, 그런 다음 연결 절차 실패했다. 주는 경우Connection_ok, 연결은입니다 준비가 된. 이 두 상태는 모두에서 똑같이 감지 할 수 있습니다 반환 값PQConnectPoll, 위에서 설명합니다. 다른 상태는 또한 (그리고 중에 만 발생할 수 있습니다 비동기 연결 절차. 이것들은 연결 절차의 현재 단계 예를 들어 사용자에게 피드백을 제공하는 데 유용합니다. 이것들 상태는 :

이 상수는 여전히 남아 있지만 (in 호환성을 유지하기 위해), 응용 프로그램이어야합니다 특정 순서로 발생하지 않거나 전혀, 또는 상태가 항상 이들 중 하나입니다. 문서화 된 값. 응용 프로그램은 같은 일을 할 수 있습니다 이것:

스위치 (pqstatus (conn))

        Case Connection_Started :
            피드백 = "연결 ...";
            부서지다;

        Case Connection_Made :
            피드백 = "서버에 연결되어 ...";
            부서지다;
.
.
.
        기본:
            피드백 = "연결 ...";

theConnect_Timeout연결 를 사용할 때 매개 변수는 무시됩니다PQConnectPoll; 응용 프로그램입니다 과도한 양의 양을 결정해야 할 책임 시간이 경과했습니다. 그렇지 않으면,PQConnectStart뒤 따르는pqconnectpoll루프는와 같습니다.PQCONNECTDB.

ifPQConnectStart널을 반환합니다 포인터, 전화해야pqfinish당신이 그것을 끝내면, 구조와 관련된 구조를 폐기하기 위해 메모리 블록. 스포츠 토토 베트맨하더라도 수행해야합니다 시도는 실패하거나 포기됩니다.

기본 연결 옵션을 반환합니다.

pqconninfooption *pqconndefaults (void);

typedef struct

    char *키워드;   / * 옵션 키워드 */
    char *envvar;    / * 폴백 환경 변수 이름 */
    char *편집;  / * 기본값으로 컴파일 된 폴백 */
    char *val;       / * 옵션의 현재 값 또는 null */
    숯 *레이블;     / * 연결 대화 상자에서 필드에 대한 레이블 */
    char *dispchar;  /*이 필드를 표시하는 방법을 나타냅니다
                          연결 대화 상자에서. 값은 다음과 같습니다.
                          ""디스플레이가 그대로 입력되었습니다
                          "*"비밀번호 필드 - 값 숨기기
                          "D"디버그 옵션 - 기본적으로 표시하지 마십시오 */
    int dispsize;  / * 대화 상자의 문자의 필드 크기 */
 pqconninfooption;

연결 옵션 배열을 반환합니다. 이것은 사용될 수 있습니다 가능한 모든 결정PQCONNECTDB옵션 및 현재 기본값. 반환 값은 배열을 가리 킵니다pqconninfooption구조, 널이있는 항목으로 끝납니다키워드포인터. 널 포인터는입니다 메모리를 할당 할 수없는 경우 반환되었습니다. 주목하십시오 현재 기본값 값 (val필드)는 환경 변수 및 기타에 따라 다릅니다 문맥. 발신자는 연결 옵션 데이터를 처리해야합니다 읽기 전용.

옵션 배열을 처리 한 후 전달하여 자유롭게 해방하십시오PQCONNINFOFREE. 이 경우 완료되지 않으면, 소량의 메모리가 각각에 유출됩니다. 전화pqconndefaults.

제공된 연결 옵션을 반환합니다 연결 문자열.

pqconninfooption *pqconninfoparse (const char *conninfo, char ** errmsg);

연결 문자열을 구문 분석하고 결과를 반환합니다 배열로서의 옵션; 또는 문제가있는 경우 NULL을 반환합니다 연결 문자열로. 이것은 결정에 사용될 수 있습니다 그만큼PQCONNECTDB옵션 제공된 연결 문자열. 반환 값은 배열pqconninfooption구조.키워드포인터.

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

iferrmsgnull이 아닙니다.*errmsg성공시 Null로 설정되었습니다. 다른 문제를 설명하는 malloc'd 오류 문자열에. (그것 또한 가능합니다*errmsgNULL이 반환 되더라도 NULL로 설정하십시오. 이것은 an을 나타냅니다 메모리 외 상황.)

옵션 배열을 처리 한 후 전달하여 자유롭게 해방하십시오PQCONNINFOFREE. 이 경우 완료되지 않고, 각 호출마다 일부 메모리가 유출됩니다PQCONNINFOPARSE. 거꾸로, 오류가 발생하면errmsgIS null이 아닌 경우 사용 오류 문자열을 제거하십시오.PQFREEMEM.

서버 연결을 닫습니다. 또한 메모리를 해방시킵니다 에 의해 사용pgconn개체.

void pqfinish (pgconn *conn);

서버 스포츠 토토 베트맨 시도가 실패하더라도 (에 표시된대로pqstatus), 신청서는 전화해야pqfinishpgconn개체. 그만큼pgconn포인터를 다시 사용해서는 안됩니다 후에pqfinish라고 불리는.

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

void pqreset (pgconn *conn);

이 함수는 서버에 대한 연결을 닫습니다 그리고 같은 새로운 연결을 다시 설정하려고 이전에 사용한 동일한 매개 변수를 모두 사용하는 서버. 이것 작업 연결이 있으면 오류 복구에 유용 할 수 있습니다. 손실되었습니다.

통신 채널을 서버로 재설정하십시오 비 차단 방식.

int pqresetstart (pgconn *conn);

PostGrespollingStatUstype PQRESETPOLL (PGCONN *CONN);

이 기능은 서버에 대한 연결을 닫습니다 그리고 같은 새로운 연결을 다시 설정하려고 이전에 사용한 동일한 매개 변수를 모두 사용하는 서버. 이것 작업 연결이있는 경우 오류 복구에 유용 할 수 있습니다. 잃어버린. 그들은 다릅니다pqreset(위) a 비 차단 방식. 이러한 기능은 동일하게 고통받습니다 제한PQConnectStartandPQConnectPoll.

스포츠 토토 베트맨 재설정을 시작하려면 CallPQRESETSTART. 0을 반환하면 재설정 실패했습니다. 1을 반환하면를 사용하여 재설정을 폴링합니다PQRESETPOLL정확히 를 사용하여 연결을 생성하는 것과 마찬가지로PQCONNECTPOLL.