서버에 명령을 제출하고 다음을 기다립니다. 토토 결과.

PGresult *PQexec(PGconn *conn, const char *command);

a를 반환합니다.PGresult포인터 또는 널 포인터일 수도 있습니다. 널이 아닌 포인터는 일반적으로 메모리 부족 조건을 제외하고는 반환됩니다. 또는 명령을 보낼 수 없는 등의 심각한 오류 서버에. 널 포인터가 반환되면, 같은 취급을 받다PGRES_FATAL_ERROR토토 결과. 사용PQerrorMessage더 많은 정보를 얻으려면 그러한 오류에 대해.

서버에 명령을 제출하고 다음을 기다립니다. 결과적으로 매개변수를 별도로 전달할 수 있는 기능이 제공됩니다. SQL 명령 텍스트에서.

PGresult *PQexecParams(PGconn *conn,
                       const char *명령,
                       정수 nParams,
                       const Oid *paramTypes,
                       const char * const *paramValues,
                       const int *paramLengths,
                       const int *paramFormats,
                       int resultFormat);

PQexecParams다음과 같습니다PQexec, 하지만 제안 추가 기능: 매개변수 값은 다음과 같습니다. 적절한 명령 문자열과 별도로 지정되며, 쿼리 결과는 텍스트 또는 바이너리로 요청할 수 있습니다. 형식.PQexecParams이다 프로토콜 3.0 이상 연결에서만 지원됩니다. 그것 프로토콜 2.0을 사용하면 실패합니다.

함수 인수는 다음과 같습니다:

다음을 사용하여 준비된 명령문을 작성하라는 요청을 제출합니다. 주어진 매개변수를 사용하고 완료될 때까지 기다립니다.

PGresult *PQprepare(PGconn *conn,
                    const char *stmt이름,
                    const char *쿼리,
                    정수 nParams,
                    const Oid *paramTypes);

PQprepare을 생성합니다 나중에 실행하기 위해 준비된 명령문PQexec준비됨. 이 기능을 사용하면 구문 분석을 위해 반복적으로 사용되는 명령 매번 계획하는 것이 아니라 한 번만 계획합니다. 실행되었습니다.PQprepare이다 프로토콜 3.0 이상 연결에서만 지원됩니다. 그것 프로토콜 2.0을 사용하면 실패합니다.

함수는 다음과 같은 준비된 명령문을 생성합니다.stmt이름에서질의문자열, 다음을 포함해야 함 단일 SQL 명령.stmt이름아마도""이름 없는 생성 진술, 이 경우 기존의 이름이 지정되지 않은 명령문은 자동으로 대체됩니다. 그렇지 않으면 그것은 명령문 이름이 이미 정의되어 있으면 오류가 발생합니다. 현재 세션. 매개변수를 사용하는 경우 해당 매개변수는 다음과 같습니다. 쿼리에서 다음과 같이 언급됩니다.$1, $2등nParams은 다음에 대한 매개변수의 수입니다. 배열에 미리 지정된 유형paramTypes[]. (배열 포인터는 다음과 같을 수 있습니다.NULL언제nParams0입니다.)paramTypes[]OID로 데이터를 지정합니다. 매개변수 기호에 할당할 유형입니다. 만일paramTypesisNULL또는 배열이 0이면 서버는 데이터 유형을 매개변수 기호는 유형이 지정되지 않은 리터럴 문자열. 또한 쿼리에서 매개변수를 사용할 수도 있습니다. 다음보다 큰 숫자가 포함된 기호nParams; 데이터 유형은 다음에 대해 추론됩니다. 이 기호들도 마찬가지입니다. (참조PQdescribe준비됨찾는 수단을 위해 어떤 데이터 유형이 유추되었는지 알아보세요.)

와 마찬가지로PQexec, 토토 결과는 일반적으로 aPGresult내용이 서버 측 성공을 나타내는 개체 또는 실패. null 결과는 메모리가 부족하거나 명령을 전혀 보낼 수 없습니다. 사용PQerrorMessage더 많은 정보를 얻으려면 그러한 오류에 대해.

다음과 함께 준비된 명령문을 실행하라는 요청을 보냅니다 매개변수를 지정하고 결과를 기다립니다.

PGresult *PQexecPrepared(PGconn *conn,
                         const char *stmt이름,
                         정수 nParams,
                         const char * const *paramValues,
                         const int *paramLengths,
                         const int *paramFormats,
                         int resultFormat);

PQexec준비됨다음과 같습니다PQexecParams하지만 실행할 명령은 이름을 지정하여 지정됩니다. 쿼리를 제공하는 대신 이전에 준비된 명령문 문자열. 이 기능을 사용하면 사용할 명령이 허용됩니다. 한 번만 반복적으로 구문 분석하고 계획하는 것이 아니라 실행될 때마다. 진술에는 다음이 있어야합니다. 현재 세션에서 이전에 준비되었습니다.PQexec준비됨지원됩니다 프로토콜 3.0 이상 연결에서만 가능합니다. 그것은 실패할 것이다 프로토콜 2.0을 사용하는 경우.

매개변수는 다음과 동일합니다.PQexecParams, 단, 쿼리 문자열 대신 준비된 문이 제공됩니다. 그리고paramTypes[]매개변수 존재하지 않습니다 (준비되었으므로 필요하지 않습니다) 명령문의 매개변수 유형은 명령문이 실행될 때 결정되었습니다. 생성됨).

다음에 관한 정보를 얻기 위해 요청을 제출합니다. 준비된 명령문을 지정하고 기다립니다. 완료.

PGresult *PQdescribePrepared(PGconn *conn, const char *stmtName);

PQdescribe준비됨응용 프로그램이 다음에 대한 정보를 얻을 수 있도록 허용합니다. 이전에 준비된 진술.PQdescribe준비됨다음에서만 지원됩니다. 프로토콜 3.0 이상 연결; 다음과 같은 경우에는 실패할 것입니다. 프로토콜 2.0을 사용합니다.

stmt이름아마도""또는 이름 없는 참조를 위한 NULL 명령문이 아니면 기존 명령문의 이름이어야 합니다. 준비된 진술. 성공하면, aPGresult상태 있음PGRES_COMMAND_OK반환됩니다. 는 기능PQnparams그리고PQparamtype적용될 수 있음 이것에PGresult얻다 준비된 매개변수에 대한 정보 명령문 및 함수PQn필드, PQfname, PQftype등은 다음에 대한 정보를 제공합니다. 명령문의 결과 열(있는 경우).

에 관한 정보를 얻기 위해 요청을 제출합니다. 포털을 지정하고 완료될 때까지 기다립니다.

PGresult *PQdescribePortal(PGconn *conn, const char *portalName);

PQdescribePortal허용 이전에 관한 정보를 얻기 위한 신청서 포털을 만들었습니다. (libpq포털에 대한 직접적인 액세스를 제공하지 않지만 이 기능을 사용하여 속성을 검사할 수 있습니다. 커서는로 생성되었습니다.선언하다 커서SQL 명령.)PQdescribePortal다음에서만 지원됩니다. 프로토콜 3.0 이상 연결; 다음과 같은 경우에는 실패할 것입니다. 프로토콜 2.0을 사용합니다.

포털이름아마도""또는 참조하려면 NULL 이름이 지정되지 않은 포털, 그렇지 않으면 포털의 이름이어야 합니다. 기존 포털. 성공하면, aPGresult상태 있음PGRES_COMMAND_OK반환되었습니다. 는 기능PQn필드, PQfname, PQftype등이 다음에 적용될 수 있습니다.PGresult얻다 결과 열(있는 경우)에 대한 정보 포털.

명령의 결과 상태를 반환합니다.

ExecStatusType PQresultStatus(const PGresult *res);

PQresultStatus할 수 있다 다음 값 중 하나를 반환합니다.

결과 상태가 다음과 같은 경우PGRES_TUPLES_OK, 그 다음에는 함수 아래 설명된 내용을 사용하여 반환된 행을 검색할 수 있습니다. 쿼리로. 참고하세요선택0개의 행을 검색하는 명령이 계속 표시됩니다.PGRES_TUPLES_OK. PGRES_COMMAND_OK다음을 수행할 수 있는 명령용입니다. 행을 반환하지 않음(삽입, 업데이트등). 의 응답PGRES_EMPTY_QUERY다음을 나타낼 수 있습니다. 클라이언트 소프트웨어의 버그입니다.

상태의 토토 결과PGRES_NONFATAL_ERROR절대로 반환되지 않습니다. 직접적으로PQexec또는 기타 쿼리 실행 기능; 이런 종류의 결과는 대신 알림 프로세서에 전달됩니다(참조섹션 29.11).

다음에서 반환된 열거 유형을 변환합니다.PQresultStatus문자열 상수로 상태 코드를 설명합니다. 발신자는 통화를 해제해서는 안 됩니다. 결과입니다.

char *PQresStatus(ExecStatusType 상태);

명령과 관련된 오류 메시지를 반환합니다. 또는 오류가 없으면 빈 문자열입니다.

char *PQresultErrorMessage(const PGresult *res);

오류가 있는 경우 반환된 문자열은 후행 개행 문자를 포함합니다. 발신자는 통화를 해제해서는 안 됩니다. 결과는 직접적으로. 연결된 경우 해제됩니다.PGresult핸들이 다음으로 전달됨PQclear.

a 즉시 따르기PQexec또는PQgetResult전화,PQerrorMessage(연결 시)는 와 동일한 문자열을 반환합니다.PQresultErrorMessage(결과에 대해). 그러나 aPGresult할 것이다 파괴될 때까지 오류 메시지를 유지하는 반면, 연결 오류 메시지는 이후에 변경됩니다. 작업이 완료되었습니다. 사용PQresultErrorMessage당신이 원할 때 특정과 관련된 상태를 알 수 있습니다.PGresult; 사용PQerrorMessage당신이 알고 싶을 때 최근 작업의 상태 연결.

오류 보고서의 개별 필드를 반환합니다.

char *PQresultErrorField(const PGresult *res, int fieldcode);

필드코드오류 필드입니다. 식별자; 아래에 나열된 기호를 참조하세요.NULL다음의 경우 반환됩니다.PGresult오류나 경고가 아닙니다. 결과이거나 지정된 필드를 포함하지 않습니다. 필드 값에는 일반적으로 후행 개행 문자가 포함되지 않습니다. 는 호출자는 결과를 직접 해제해서는 안 됩니다. 그것은 될 것이다 연결된 경우 해제됨PGresult핸들이 다음으로 전달됨PQclear.

다음 필드 코드를 사용할 수 있습니다:

클라이언트는 표시된 형식을 담당합니다. 필요에 맞는 정보; 특히 그래야 한다 필요에 따라 긴 줄을 끊습니다. 줄 바꿈 문자가 나타납니다. 오류 메시지 필드에서는 다음과 같이 처리되어야 합니다. 줄바꿈이 아닌 단락 나누기입니다.

내부적으로 생성된 오류libpq심각도와 기본이 있습니다. 메시지가 있지만 일반적으로 다른 필드는 없습니다. 반환된 오류 3.0 이전 프로토콜 서버에서는 심각도와 기본 메시지, 때로는 세부 메시지이지만 다른 분야.

오류 필드는 다음에서만 사용할 수 있습니다.PGresult객체, 아님PGconn객체; 없어요PQerrorField함수.

a와 관련된 저장 공간을 비웁니다.PGresult. 모든 명령 결과는 다음을 통해 해제됩니다.PQclear언제 더 이상 필요하지 않습니다.

void PQclear(PGresult *res);

당신은 다음을 유지할 수 있습니다.PGresult당신이 필요로 하는 한 주변에 있는 동안 반대하십시오; 그것은 가지 않는다 새로운 명령을 내릴 때나 닫을 때에도 연결. 이를 제거하려면 전화해야 합니다.PQclear. 이를 수행하지 않음 애플리케이션에서 메모리 누수가 발생합니다.

빈 공간을 구성합니다PGresult주어진 객체를 가진 객체 상태.

PGresult *PQmakeEmptyPGresult(PGconn *conn, ExecStatusType 상태);

이것은libpq의 빈 공간을 할당하고 초기화하는 내부 함수PGresult개체. 이 메모리를 할당할 수 없으면 함수는 NULL을 반환합니다. 일부 응용 프로그램에서 유용하다고 판단하여 내보냈습니다. 결과 개체(특히 다음을 포함하는 개체)를 생성합니다. 오류 상태) 자체. 만일콘null이 아니며상태오류를 나타냅니다. 현재 지정된 연결의 오류 메시지가 복사됩니다.PGresult. 참고하세요PQclear결국에는 그래야만 합니다 a와 마찬가지로 객체에 대해 호출됩니다.PGresult반환자libpq그 자체.

질의의 행(튜플) 수를 반환합니다. 토토 결과.

int PQntuples(const PGresult *res);

각 행의 열(필드) 수를 반환합니다. 쿼리 토토 결과입니다.

int PQnfields(const PGresult *res);

주어진 항목과 연관된 열 이름을 반환합니다. 열 번호. 열 번호는 0부터 시작합니다. 호출자 결과를 직접적으로 해제해서는 안 됩니다. 해방될 것이다 연결된 경우PGresult핸들이 다음으로 전달됨PQclear.

char *PQfname(const PGresult *res,
              int 열_번호);

NULL열이 다음인 경우 반환됩니다. 번호가 범위를 벗어났습니다.

주어진 항목과 연관된 열 번호를 반환합니다. 열 이름입니다.

int PQfnumber(const PGresult *res,
              const char *column_name);

-1은 주어진 이름이 일치하지 않는 경우 반환됩니다. 열.

주어진 이름은 SQL의 식별자처럼 처리됩니다. 즉, 큰따옴표가 없으면 대문자로 표시됩니다. 예를 들어, SQL에서 생성된 쿼리 결과가 주어지면 명령

1을 FOO로, 2를 "BAR"로 선택;

우리는 토토 결과를 얻을 것입니다:

PQfname(res, 0)fooPQfname(res, 1)바PQf번호(res, "FOO")0PQfnumber(res, "foo")0PQfnumber(res, "BAR")-1PQfnumber(res, "\"BAR\"")1

주어진 테이블의 OID를 반환합니다. 열을 가져왔습니다. 열 번호는 0부터 시작합니다.

Oid PQftable(const PGresult *res,
             int 열_번호);

InvalidOid다음과 같은 경우 반환됩니다. 열 번호가 범위를 벗어났거나 지정된 열이 테이블 열에 대한 간단한 참조가 아니거나 3.0 이전 프로토콜을 사용합니다. 시스템 테이블을 쿼리할 수 있습니다.pg_class정확하게 결정하려면 어떤 테이블이 참조되는지.

유형오이드및 상수InvalidOid다음 경우에 정의됩니다. 당신은 다음을 포함합니다.libpq헤더 파일. 둘 다 정수 유형입니다.

테이블 내에서 열 번호를 반환합니다. 지정된 쿼리 결과 열을 구성하는 열입니다. 쿼리 결과 열 번호는 0부터 시작하지만 테이블 열은 0부터 시작합니다. 0이 아닌 숫자가 있습니다.

int PQftablecol(const PGresult *res,
                int 열_번호);

열 번호가 범위를 벗어나면 0이 반환됩니다. 또는 지정된 열이 테이블 열 또는 3.0 이전 프로토콜을 사용하는 경우.

형식을 나타내는 형식 코드를 반환합니다. 주어진 열. 열 번호는 0부터 시작합니다.

int PQfformat(const PGresult *res,
              int 열_번호);

형식 코드 0은 텍스트 데이터를 나타냅니다. 형식 코드 1은 이진수를 나타냅니다. 표현. (다른 코드는 향후를 위해 예약되어 있습니다. 정의.)

주어진 열과 연관된 데이터 유형을 반환합니다. 번호. 반환된 정수는 내부 OID 번호입니다. 유형의. 열 번호는 0부터 시작합니다.

Oid PQftype(const PGresult *res,
            int 열_번호);

시스템 테이블을 쿼리할 수 있습니다.pg_type이름과 속성을 얻으려면 다양한 데이터 유형 중.OID48947_49012src/include/catalog/pg_type.h안에 소스 트리.

연관된 열의 유형 수정자를 반환합니다. 주어진 열 번호로. 열 번호는 다음에서 시작합니다. 0.

int PQfmod(const PGresult *res,
           int 열_번호);

수정자 값의 해석은 다음과 같습니다. 유형별; 일반적으로 정밀도나 크기를 나타냅니다. 한계. 값 -1은 다음을 나타내는 데 사용됩니다."사용 가능한 정보가 없습니다". 대부분의 데이터 유형은 수정자를 사용하지 않습니다. 이 경우 값은 다음과 같습니다. 항상 -1.

연관된 열의 크기를 바이트 단위로 반환합니다. 주어진 열 번호로. 열 번호는 다음에서 시작합니다. 0.

int PQfsize(const PGresult *res,
            int 열_번호);

PQfsize반환 데이터베이스 행에서 이 열에 할당된 공간 즉, 서버 내부의 크기 데이터 유형의 표현. (따라서 그렇지 않다. 클라이언트에게 정말 매우 유용합니다.) 음수 값 데이터 유형이 가변 길이임을 나타냅니다.

다음인 경우 1을 반환합니다.PGresult바이너리 데이터를 포함하고 텍스트 데이터를 포함하는 경우 0입니다.

int PQbinaryTuples(const PGresult *res);

이 기능은 더 이상 사용되지 않습니다(다음에서의 사용 제외). 와 연결됨복사) 왜냐하면 싱글이면 가능해요PGresult일부 텍스트 데이터를 포함하기 위해 다른 열 및 이진 데이터.PQfformat선호됩니다.PQbinaryTuples모두인 경우에만 1을 반환합니다. 결과 열은 바이너리입니다(형식 1).

a의 한 행에 대한 단일 필드 값을 반환합니다.PGresult. 행과 열 숫자는 0부터 시작합니다. 호출자는 결과를 해제해서는 안 됩니다. 직접. 연결된 경우 해제됩니다.PGresult핸들이 다음으로 전달됨PQclear.

char *PQgetvalue(const PGresult *res,
                 정수 행_번호,
                 int 열_번호);

텍스트 형식의 데이터에 대해 반환된 값은PQgetvalue은 null로 끝나는 문자열 표현 필드 값. 이진 형식 데이터의 경우 값은 다음과 같습니다. 데이터 유형에 의해 결정되는 이진 표현typsend그리고typreceive함수. (값은 실제로 이 경우에도 0바이트가 따라오지만 이는 일반적으로 유용하지 않습니다. 왜냐하면 그 가치는 아마도 포함된 null을 포함합니다.)

필드 값이 다음과 같은 경우 빈 문자열이 반환됩니다. 널. 참조PQgetisnull에 null 값과 빈 문자열 값을 구별합니다.

포인터가 반환됨PQgetvalue저장소를 가리킵니다. 의 일부PGresult구조. 그것이 가리키는 데이터를 수정해서는 안 됩니다. 데이터를 다른 저장소에 명시적으로 복사해야 합니다. 수명이 다한 후에 사용하려는 경우PGresult구조 자체.

필드에서 null 값을 테스트합니다. 행 및 열 번호 0부터 시작하세요.

int PQgetisnull(const PGresult *res,
                정수 행_번호,
                int 열_번호);

이 함수는 필드가 null인 경우 1을 반환하고 다음인 경우 0을 반환합니다. null이 아닌 값이 포함되어 있습니다. (참고하세요PQgetvalue빈 문자열을 반환합니다. null 필드의 경우 null 포인터가 아닙니다.)

필드 값의 실제 길이를 바이트 단위로 반환합니다. 행과 열 번호는 0부터 시작합니다.

int PQgetlength(const PGresult *res,
                정수 행_번호,
                int 열_번호);

이것은 특정 데이터에 대한 실제 데이터 길이입니다 값, 즉 가리키는 객체의 크기PQgetvalue. 텍스트 데이터의 경우 형식은 다음과 같습니다.strlen(). 바이너리 형식의 경우 이는 다음과 같습니다. 필수 정보. 주의해야 할 점은 다음과 같습니다.아님의존하다PQfsize실제 데이터를 얻기 위해 길이.

준비된 매개변수의 수를 반환합니다. 진술.

int PQnparams(const PGresult *res);

이 기능은 다음을 검사할 때만 유용합니다. 결과PQdescribe준비됨. 다른 유형의 경우 쿼리하면 0이 반환됩니다.

표시된 문의 데이터 유형을 반환합니다. 매개변수. 매개변수 번호는 0부터 시작합니다.

Oid PQparamtype(const PGresult *res, int param_number);

이 기능은 다음을 검사할 때만 유용합니다. 결과PQdescribe준비됨. 다른 유형의 경우 쿼리하면 0이 반환됩니다.

모든 행과 선택적으로 열을 인쇄합니다. 지정된 출력 스트림에 이름을 붙입니다.

void PQprint(FILE *fout, /* 출력 스트림 */
             const PGresult *res,
             const PQprintOpt *po);

형식 정의 구조체 
    pqbool 헤더;      /* 출력 필드 제목과 행 개수를 인쇄합니다 */
    pqbool 정렬;       /* 필드 채우기 채우기 */
    pqbool 표준;    /* 오래된 뇌사 형식 */
    pqbool html3;       /* HTML 테이블 출력 */
    pqbool 확장;    /* 테이블 확장 */
    pqbool 호출기;       /* 필요한 경우 출력을 위해 호출기를 사용합니다 */
    char *fieldSep;   /* 필드 구분자 */
    char *tableOpt;   /* HTML 테이블 요소의 속성 */
    문자 *캡션;    /* HTML 테이블 캡션 */
    char **필드명; /* null로 끝나는 대체 필드 이름 배열 */
 PQprintOpt;

이 기능은 이전에 다음에서 사용되었습니다.psql질의 결과를 인쇄하지만 이것은 더 이상 사실이 아닙니다. 이는 모든 것을 가정한다는 점에 유의하십시오. 데이터는 텍스트 형식입니다.

SQL 명령에서 명령 상태 태그를 반환합니다. 생성된 것은PGresult.

char *PQcmdStatus(PGresult *res);

일반적으로 이는 단지 명령의 이름이지만 행 수와 같은 추가 데이터가 포함될 수 있습니다. 처리됨. 호출자는 결과를 해제해서는 안 됩니다. 직접. 연결된 경우 해제됩니다.PGresult핸들이 다음으로 전달됨PQclear.

SQL의 영향을 받은 행 수를 반환합니다. 명령.

char *PQcmdTuples(PGresult *res);

이 함수는 숫자를 포함하는 문자열을 반환합니다 의 영향을 받은 행 수SQL다음을 생성한 문PGresult. 이 기능은 an 실행 후에만 사용됩니다.삽입, 업데이트, 삭제, 이동, 가져오기, 또는복사문장 또는실행59191_59241삽입, 업데이트또는삭제문장. 다음을 생성한 명령인 경우PGresult그 외 다른 것들은 없었습니다.PQcmdTuples반환 빈 문자열. 호출자는 반환 값을 해제해서는 안 됩니다. 직접. 연결된 경우 해제됩니다.PGresult핸들이 다음으로 전달됨PQclear.

OID를 반환합니다.삽입된 행의 경우,SQL명령은삽입정확히 한 행을 삽입했습니다. OID가 있는 테이블 또는 a실행다음을 포함하는 준비된 쿼리의 적합삽입문장. 그렇지 않으면 이 함수는 다음을 반환합니다.InvalidOid. 이 함수는 또한 반환됩니다.InvalidOid테이블이 영향을 받은 경우 에 의해삽입문은 그렇지 않습니다 OID를 포함합니다.

Oid PQoidValue(const PGresult *res);

다음의 경우 삽입된 행의 OID가 포함된 문자열을 반환합니다.SQL명령은삽입정확히 하나를 삽입했습니다. 행 또는 a실행준비된 적절한으로 구성된 명령문삽입. (문자열은 다음과 같습니다.0만일삽입정확히 하나의 행을 삽입하지 않았거나 대상 테이블이 OID가 없습니다.) 명령이 다음이 아닌 경우삽입, 빈 문자열을 반환합니다.

char *PQoidStatus(const PGresult *res);

이 기능은 다음을 위해 더 이상 사용되지 않습니다.PQoid값. 스레드로부터 안전하지 않습니다.

다음을 사용하여 SQL 명령 내에서 사용하기 위해 바이너리 데이터를 이스케이프합니다. 유형바이테아. 마찬가지로PQescapeStringConn이건 SQL에 데이터를 직접 삽입할 때만 사용됩니다. 명령 문자열.

부호 없는 문자 *PQescapeByteaConn(PGconn *conn,
                                 const unsigned char *from,
                                 size_t from_length,
                                 size_t *to_length);

특정 바이트 값반드시탈출됨(그러나 모두 바이트 값할 수 있다이스케이프됨) a의 일부로 사용되는 경우바이테아문자 그대로SQL문장. 일반적으로 탈출하려면 바이트는 세 자리 8진수로 변환됩니다. 옥텟 값과 동일하며 일반적으로 두 개가 앞에 옵니다. 백슬래시. 작은따옴표(') 및 백슬래시(\) 문자에는 특별한 대안이 있습니다. 이스케이프 시퀀스. 참조섹션 8.4더 보기 정보.PQescapeByteaConn이것을 수행합니다 최소한으로 필요한 것만 이스케이프하는 작업 바이트.

그에서매개변수 포인트 이스케이프할 문자열의 첫 번째 바이트까지, 그리고from_length매개변수 이 이진 문자열의 바이트 수를 제공합니다. (A 0바이트 종료는 필요하지도 않고 계산되지도 않습니다.)to_length매개변수 포인트 결과 이스케이프 문자열을 보유할 변수 길이. 이 결과 문자열 길이에는 다음이 포함됩니다. 결과의 0바이트를 종료합니다.

PQescapeByteaConn이스케이프된 버전을 반환합니다.from메모리의 매개변수 바이너리 문자열 로 할당됨malloc(). 이 메모리는 다음을 사용하여 해제되어야 합니다.PQfreemem()결과가 no인 경우 더 이상 필요합니다. 반환 문자열에는 모든 특수 문자가 있습니다. 문자가 제대로 표시될 수 있도록 교체됨 에 의해 처리됨포스트그레SQL문자열 리터럴 파서, 그리고바이테아입력 함수. 에이 0바이트 종료도 추가됩니다. 작은따옴표 둘러싸야 함PostgreSQL문자열 리터럴은 그렇지 않습니다. 토토 결과 문자열의 일부입니다.

오류 발생 시 NULL 포인터가 반환되며 적절한 오류 메시지는에 저장됩니다.콘개체. 현재 유일한 가능한 오류는 결과를 저장할 메모리가 부족하다는 것입니다. 문자열.

PQescapeBytea은 이전 버전, 더 이상 사용되지 않는 버전PQescapeByteaConn.

unsigned char *PQescapeBytea(const unsigned char *from,
                             size_t from_length,
                             size_t *to_length);

유일한 차이점은PQescapeByteaConn그렇군요PQescapeBytea다음을 취하지 않습니다PGconn매개변수. 때문에 따라서 상황에 따라 동작을 조정할 수 없습니다. 연결 속성(특히 표준 준수 문자열이 활성화됨) 따라서그것은 잘못된 토토 결과를 가져올 수도 있습니다 토토 결과. 또한 오류를 반환할 방법이 없습니다. 실패 시 메시지.

PQescapeBytea될 수 있습니다 작동하는 단일 스레드 클라이언트 프로그램에서 안전하게 사용됩니다. 하나만으로포스트그레SQL한 번에 연결(이 경우 무엇인지 알아낼 수 있음) 알아야 해."뒤에 장면"). 다른 맥락에서는 보안입니다. 위험하므로 피해야 합니다.PQescapeByteaConn.

바이너리 데이터의 문자열 표현을 다음으로 변환합니다. 이진 데이터 — 반대PQescapeBytea. 이는 다음과 같은 경우에 필요합니다. 검색 중바이테아텍스트의 데이터 형식이지만 바이너리 형식으로 검색할 때는 그렇지 않습니다.

unsigned char *PQunescapeBytea(const unsigned char *from, size_t *to_length);

그에서매개변수 포인트 다음과 같은 문자열로 반환될 수 있습니다.PQgetvaluea에 적용할 때바이테아열.PQunescapeBytea이 문자열을 변환합니다 표현을 이진 표현으로 변환합니다. 그것은 반환 로 할당된 버퍼에 대한 포인터malloc(), 오류 시 null, 그리고 버퍼의 크기to_length. 결과는 해제되어야 합니다. 사용 중PQfreemem그때 더 이상 필요하지 않습니다.

이 변환은 정확히 반대가 아닙니다.PQescapeBytea, 왜냐하면 문자열은 그렇지 않을 것으로 예상됩니다."탈출"다음에서 수신할 때PQgetvalue. 특히 이것은 의미합니다 문자열 인용을 고려할 필요가 없습니다. 그러니 a가 필요없어요PGconn매개변수.

다음에 의해 할당된 메모리 해제libpq.

void PQfreemem(void *ptr);

다음에 의해 할당된 메모리 해제libpq특히PQescapeByteaConn, PQescapeBytea, PQunescapeBytea및PQ알림. 특히 이 기능이 중요합니다.무료(), Microsoft Windows에서 사용됩니다. DLL에 메모리를 할당하고 해제하기 때문입니다. 응용 프로그램에서는 다음과 같은 경우에만 작동합니다. 멀티스레드/단일 스레드, 릴리스/디버그 및 정적/동적 플래그는 DLL과 신청. Microsoft Windows 이외의 플랫폼에서는 이 함수는 표준 라이브러리 함수와 동일합니다.무료().