서버에 배트맨 토토을 제출하고 결과.

pgresult *pqexec (pgconn *conn, const char *command);

반환 apgresult포인터 또는 아마도 널 포인터 일 수 있습니다. 널이 아닌 포인터가 있습니다 일반적으로 메모리 외 조건을 제외하고 반환됩니다 또는 배트맨 토토을 보낼 수없는 것과 같은 심각한 오류 서버에. 널 포인터가 반환되면 처럼 대우 받다pgres_fatal_error결과. 사용PQERRORMESSAGE더 많은 정보를 얻으려면 그러한 오류에 대해.

서버에 배트맨 토토을 제출하고 결과적으로 매개 변수를 별도로 전달할 수 있습니다 SQL 배트맨 토토 텍스트에서.

pgresult *pqexecparams (pgconn *conn,
                       const char *명령,
                       int nparams,
                       const oid *paramtypes,
                       const char * const * paramvalues,
                       const int *paramlengths,
                       const int *faramformats,
                       int resultformat);

pqexecparamsPQEXEC그러나 제공합니다 추가 기능 : 매개 변수 값이 될 수 있습니다 배트맨 토토 문자열에서 별도로 지정됩니다 쿼리 결과는 텍스트 또는 이진으로 요청할 수 있습니다. 체재.pqexecparamsis 프로토콜 3.0 이상 연결에서만 지원됩니다. 그것 프로토콜 2.0을 사용할 때 실패합니다.

매개 변수가 사용되면 배트맨 토토 문자열 as$ 1, $ 2등nparams는 매개 변수 수입니다 공급; 배열의 길이입니다Paramtypes [], Paramvalues ​​[], Paramlengths []및FARAMFORMATS []. (배열 포인터는 할 수 있습니다 BENULL언제nparamsis ZERO.)Paramtypes []OID에 의해 데이터를 지정합니다 매개 변수 기호에 할당 할 유형. 만약에ParamtypesisNULL또는 배열은 0이고 서버는 데이터 유형을 매개 변수 기호와 같은 방식으로 무형 문자 그대로 문자열.Paramvalues ​​[]실제를 지정합니다 매개 변수의 값. 이 배열의 널 포인터 해당 매개 변수가 null임을 의미합니다. 그렇지 않으면 포인터는 텍스트의 경우 제로 종료 된 텍스트 문자열을 가리 킵니다 형식) 또는 이진 데이터는 서버 (이진 형식).Paramlengths []실제 데이터를 지정합니다 이진 형식 매개 변수의 길이. 무시됩니다 널 매개 변수 및 텍스트 형식 매개 변수. 배열 이진 매개 변수가 없을 때 포인터가 무일하게 될 수 있습니다.FARAMFORMATS []지정 매개 변수가 텍스트인지 여부 (배열에 0을 넣음) 이진 (배열에 하나를 넣습니다). 배열 포인터 인 경우 NULL 그러면 모든 매개 변수는 텍스트로 추정됩니다.resultformat획득 할 수있는 0입니다 텍스트 형식의 결과 또는 결과를 얻기위한 결과 이진 형식. (현재 조항이 없습니다 다른 형식의 다른 결과 열을 얻고 기본에서는 가능합니다 규약.)

준비 된 문을 작성하라는 요청을 제출합니다 주어진 매개 변수 및 완료를 기다립니다.

pgresult *pqprepare (pgconn *conn,
                    const char *stmtname,
                    const char *쿼리,
                    int nparams,
                    const oid *paramtypes);

pqprepare생성 a 나중에 실행을위한 준비된 진술pqExecprepared. 이 기능은 허용합니다 반복적으로 사용되는 배트맨 토토은 구문 분석하고 마다마다 한 번만 계획되었습니다 실행.pqprepareis 프로토콜 3.0 이상 연결에서만 지원됩니다. 그것 프로토콜 2.0을 사용할 때 실패합니다.

이 배트맨 토토는 준비된 진술을 작성합니다.stmtname에서쿼리String 단일 SQL 배트맨 토토.stmtname""이름이없는 것을 만들려면 이 경우 기존의 이름이없는 명령문 명세서가 자동으로 교체됩니다. 그렇지 않으면 그것은입니다 오류 명령문 이름이 이미 정의 된 경우 현재 세션. 매개 변수를 사용하는 경우입니다 쿼리에서에 참조19899_19903, $ 2등NPARAMS는 매개 변수 수입니다 배열에서 미리 지정되는 유형Paramtypes []. (배열 포인터는NULLwhennparams는 0입니다.)Paramtypes []OID에 의해 데이터를 지정합니다 매개 변수 기호에 할당 할 유형. 만약에Paramtypesisnull또는 배열은 0이고 서버는 데이터 유형을 매개 변수 기호와 같은 방식으로 무형 문자 문자열. 또한 쿼리는 매개 변수를 사용할 수 있습니다 숫자가 높은 기호NPARAMS; 데이터 유형이 추론됩니다 이 상징들도.

PQEXEC, 결과는 일반적으로 A입니다.pgresult내용이 서버 측 성공을 나타내는 객체 또는 실패. 널 결과는 메모리 외부를 나타냅니다 배트맨 토토을 전혀 보낼 수 없습니다. 사용PQERRORMESSAGE더 많은 정보를 얻으려면 그러한 오류에 대해.

현재, 실제를 결정할 방법이 없습니다. 유형이 아닌 매개 변수에 대해 추론 된 데이터 유형 지정Paramtypes []. 이것은입니다.libpq생략 아마도 향후 릴리스에서 수정 될 것입니다.

준비한 문을 실행하라는 요청을 보냅니다 매개 변수가 주어지고 결과를 기다립니다.

pgresult *pqexecprepared (pgconn *conn,
                         const char *stmtname,
                         int nparams,
                         const char * const * paramvalues,
                         const int *paramlengths,
                         const int *faramformats,
                         int resultformat);

pqExecpreparedPQEXECPARAMS실행되는 배트맨 토토은 이름을 지정하여 지정됩니다 쿼리를 제공하는 대신 이전에 준비된 진술 끈. 이 기능을 사용하면 사용될 명령이 가능합니다 반복적으로 한 번만 구문 분석되고 계획되어야합니다 그들이 처형 될 때보다. 성명서에는 있어야합니다 현재 세션에서 이전에 준비되었습니다.pqExecprepared지원됩니다 프로토콜 3.0 이상 연결에서만; 실패합니다 프로토콜 2.0을 사용할 때.

매개 변수는 동일합니다pqexecparams준비된 명령문은 쿼리 문자열 대신에 제공됩니다. 그리고Paramtypes []매개 변수 존재하지 않습니다 (준비된 이후에는 필요하지 않습니다. 배트맨 토토문의 매개 변수 유형은시기에 결정되었습니다 생성).

배트맨 토토의 결과 상태를 반환합니다.

execstatustype pqresultstatus (const pgresult *res);

pqresultstatuscan 다음 값 중 하나를 반환합니다.

결과 상태가pgres_tuples_ok, 그런 다음 함수 아래 설명 된 행을 검색하는 데 사용될 수 있습니다. 쿼리에 의해. Aselect0 행을 검색하는 배트맨 토토은 여전히 ​​표시됩니다pgres_tuples_ok. pgres_command_ok는 할 수있는 배트맨 토토입니다 절대 줄을 반환하지 마십시오 (삽입, 업데이트등). 의 응답pgres_empty_querya를 표시 할 수 있습니다 클라이언트 소프트웨어의 버그.

상태의 결과pgres_nonfatal_error절대 반환되지 않습니다 직접PQEXEC또는 기타 쿼리 실행 기능; 이런 종류의 결과 대신 통지 프로세서로 전달되었습니다 (참조섹션 28.10).

retured에 의해 반환 된 열거 된 유형을 변환합니다pqresultstatus문자열 상수로 상태 코드를 설명합니다. 발신자는 자유롭지 않아야합니다 결과.

char *pqresstatus (execstatustype status);

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

char *pqresulterrormessage (const pgresult *res);

오류가 있으면 반환 된 문자열이 있습니다 후행 Newline을 포함하십시오. 발신자는 자유롭지 않아야합니다 결과 직접. 관련이 해방 될 것입니다pgresult핸들이 전달됩니다PQCLEAR.

바로 다음PQEXEC또는pqgetresultCall,PQERRORMESSAGE(연결 중) 와 같은 문자열을 반환합니다.PQRESULTERRORMESSAGE(결과). 그러나 Apgresult의지 파괴 될 때까지 오류 메시지를 유지하는 동안 연결 오류 메시지는 후속시 변경됩니다 작업이 완료되었습니다. 사용PQRESULTERRORMESSAGE원할 때 특정 상태를 알고 있습니다pgresult; 사용PQERRORMESSAGE알고 싶을 때 최신 작업의 상태 연결.

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

char *pqresultterrorfield (const pgresult *res, int fieldcode);

FieldCode는 오류 필드입니다 식별자; 아래에 나열된 기호를 참조하십시오.null이되면 반환됩니다.pgresult는 오류 나 경고가 아닙니다 결과 또는 지정된 필드를 포함하지 않습니다. 필드 값은 일반적으로 후행 신성을 포함하지 않습니다. 그만큼 발신자는 결과를 직접 자유롭게 해제해서는 안됩니다. 그것은 될 것입니다 연관일 때 해방pgresult핸들이 전달됩니다PQCLEAR.

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

클라이언트는 표시된 서식을 담당합니다 필요를 충족시키기위한 정보; 특히 그것은해야합니다 필요에 따라 긴 줄을 끊으십시오. Newline 캐릭터가 나타납니다 오류에서 메시지 필드는 다음과 같이 처리해야합니다 단락 브레이크, 줄이 나지 않습니다.

내부적으로 생성 된 오류libpq심각도와 기본이 있습니다 메시지이지만 일반적으로 다른 필드는 없습니다. 오류가 반환되었습니다 Pre-3.0 Protocol 서버에는 심각도가 포함됩니다 기본 메시지, 때로는 세부 메시지이지만 아니요 다른 분야.

오류 필드는에서만 사용할 수 있습니다.pgresult객체, 아님pgconn개체; 없음PQERRORFIELD기능.

a를 해제합니다pgresult. 모든 배트맨 토토 결과가 있어야합니다 를 통해 해방PQCLEAR언제 더 이상 필요하지 않습니다.

void pqclear (pgresult *res);

당신은 a를 유지할 수 있습니다.pgresult필요한 한 오랫동안 객체; 가지 않습니다 새로운 명령을 발행 할 때 또는 닫는 경우에도 연결. 제거하려면 전화해야PQCLEAR. 이 작업을 수행하지 못합니다 응용 프로그램에서 메모리 누출이 발생합니다.

빈 건설pgresult주어진 객체 상태.

pgresult *pqmakeemptypypgresult (pgconn *conn, execstatustype 상태);

이것은libpq's 공허함을 할당하고 초기화하는 내부 기능pgresult개체. 이것 메모리를 할당 할 수없는 경우 함수는 NULL을 반환합니다. 일부 응용 프로그램이 유용하다고 생각하기 때문에 내보내기입니다 결과 객체 (특히 객체 오류 상태) 자체. 만약에connNULL이 아니고상태오류, 전류를 나타냅니다 지정된 연결의 오류 메시지가 복사됩니다 그만큼pgresult. 참고PQCLEAR결국 a와 마찬가지로 물체에 호출됩니다.pgresult반환libpq자체.

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

int pqntuples (const pgresult *res);

각 행에서 열 (필드) 수를 반환합니다. 쿼리 결과.

int pqnfields (const pgresult *res);

주어진과 관련된 열 이름을 반환합니다 열 번호. 열 숫자는 0에서 시작합니다. 발신자 결과를 직접 자유롭게 해제해서는 안됩니다. 그것은 해방 될 것입니다 관련된 경우pgresult핸들이 전달됩니다PQCLEAR.

char *pqfname (const pgresult *res,
              int column_number);

NULL열이면 반환됩니다 숫자는 범위를 벗어났습니다.

주어진과 관련된 열 번호를 반환합니다 열 이름.

int pqfnumber (const pgresult *res,
              const char *column_name);

40750_40821

주어진 이름은 SQL에서 식별자처럼 취급됩니다. 배트맨 토토은 두 번 인용되지 않는 한 다운 케이스입니다. 예를 들어 SQL에서 생성 된 쿼리 결과가 주어지면 명령

1을 foo로 선택하고 2, 2 "bar";

결과가 있습니다 :

pqfname (res, 0)foopqfname (res, 1)barpqfnumber (res, "foo")0pqfnumber (res, "foo")0pqfnumber (res, "bar")-1pqfnumber (res, "\"bar \ "")1

주어진 테이블의 OID를 반환합니다. 칼럼이 가져 왔습니다. 열 번호는 0에서 시작합니다.

OID pqftable (const pgresult *res,
             int column_number);

Invalidoid열 번호는 범위를 벗어나거나 지정된 열이있는 경우 테이블 열에 대한 간단한 참조가 아닙니다. Pre-3.0 프로토콜 사용. 시스템 테이블을 쿼리 할 수 ​​있습니다pg_class정확히 결정합니다 어떤 테이블이 참조됩니다.

유형OID그리고 상수Invalidoid당신은 포함libpq헤더 파일. 둘 다 정수 유형이 될 것입니다.

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

int pqftablecol (const pgresult *res,
                int column_number);

열 번호가 범위를 벗어난 경우 0이 반환됩니다. 또는 지정된 열이 간단한 참조가 아닌 경우 테이블 열, 또는 Pre-3.0 프로토콜을 사용할 때.

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

int pqfformat (const pgresult *res,
              int column_number);

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

지정된 열과 관련된 데이터 유형을 반환합니다 숫자. 반환 된 정수는 내부 OID 번호입니다 유형의. 열 번호는 0에서 시작합니다.

OID pqftype (const pgresult *res,
            int column_number);

시스템 테이블을 쿼리 할 수 ​​있습니다PG_TYPE이름과 속성을 얻습니다 다양한 데이터 유형 중. 그만큼OID44462_44527SRC/포함/카탈로그/PG_TYPE.H소스 트리.

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

int pqfmod (const pgresult *res,
           int column_number);

수정 자 값의 해석은입니다 유형-특이 적; 그들은 일반적으로 정밀 또는 크기를 나타냅니다 제한. 값 -1은 표시하는 데 사용됩니다"정보 없음". 대부분의 데이터 유형은 수정자를 사용하지 않으며 값은 다음과 같습니다. 항상 -1.

관련 열의 바이트로 크기를 반환합니다 주어진 열 번호로. 열 번호는 시작됩니다 0.

int pqfsize (const pgresult *res,
            int column_number);

pqfsize반환합니다 데이터베이스 행 에서이 열에 할당 된 공간은 즉, 서버 내부의 크기입니다 데이터 유형의 표현. (따라서, 그렇지 않습니다 고객에게 정말 유용합니다.) 부정적인 가치 데이터 유형이 가변 길이임을 나타냅니다.

|pgresult텍스트 데이터가 포함 된 경우 이진 데이터와 0이 포함되어 있습니다.

int pqbinaryTuples (const pgresult *res);

이 배트맨 토토는 더 이상 사용되지 않습니다 (사용을 제외하고 와의 연결COPY) 단일 가능합니다.pgresult일부에는 텍스트 데이터를 포함합니다 기타의 열 및 이진 데이터.pqfformat선호됩니다.pqbinaryTuples모두가 모두 경우에만 반환합니다 결과의 열은 이진 (형식 1)입니다.

a의 단일 필드 값을 반환합니다.pgresult. 행과 열 숫자는 0에서 시작합니다. 발신자는 결과를 자유롭게하지 않아야합니다. 곧장. 관련이 해방 될 것입니다pgresult핸들이 전달됩니다PQCLEAR.

char *pqgetValue (const pgresult *res,
                 int row_number,
                 int column_number);

텍스트 형식의 데이터의 경우pqgetValueis Null-Terminated 캐릭터 문자열 표현 필드 값. 이진 형식의 데이터의 경우 값이 데이터 유형에 의해 결정된 이진 표현TypSendandtypreceive배트맨 토토. (가치는입니다 실제로이 경우에도 제로 바이트가 이어지지만 값이 가능할 가능성이 높기 때문에 일반적으로 유용하지 않습니다. 내장 널 포함.)

필드 값이 있으면 빈 문자열이 반환됩니다. 널. 보다PQGETISNULLto 널 값을 빈 스트링 값과 구별합니다.

포인터가 반환pqgetValue스토리지를 가리 킵니다 의 일부pgresult구조. 가리키는 데이터를 수정해서는 안되며 데이터를 다른 스토리지에 명시 적으로 복사해야합니다. 그것이 수명을 지나서 사용되는 경우pgresult구조 자체.

널 값에 대한 필드를 테스트합니다. 행 및 열 번호 0에서 시작합니다.

int pqgetisnull (const pgresult *res,
                int row_number,
                int column_number);

이 함수는 필드가 널이고 0 인 경우 1을 반환합니다. 널이 아닌 값이 포함되어 있습니다. (pqgetValue빈 문자열을 반환합니다. 널 필드를위한 널 포인터가 아닙니다.)

바이트의 필드 값의 실제 길이를 반환합니다. 행 및 열 숫자는 0에서 시작합니다.

int pqgetlength (const pgresult *res,
                int row_number,
                int column_number);

이것은 특정 데이터의 실제 데이터 길이입니다. 값, 즉, 객체의 크기는pqgetValue. 텍스트 데이터의 경우 형식 이것은와 동일합니다.strlen (). 이진 형식의 경우 이것은입니다 필수 정보. 하나는not의존pqfsize실제 데이터를 얻으려면 길이.

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

void pqprint (파일 *fout, / *출력 스트림 * /
             const pgresult *res,
             const pqprintopt *po);

typedef struct 
    PQBOOL 헤더;      / * 출력 필드 제목 및 행 카운트 인쇄 */
    pqbool 정렬;       / * 채우기 필드 정렬 */
    PQBOOL 표준;    / * Old Brain Dead 형식 */
    PQBOOL HTML3;       / * 출력 HTML 테이블 */
    PQBOOL 확장;    / * 테이블 확장 */
    PQBOOL 호출기;       / * 필요한 경우 출력을 위해 호출기를 사용하십시오 */
    char *fieldsep;   / * 필드 분리기 */
    char *tableopt;   / * HTML 테이블 요소의 속성 */
    char *캡션;    / * HTML 테이블 캡션 */
    char ** fieldname; / * 교체 필드 이름의 널리 터진 배열 */
 pqprintopt;

이 함수는 이전에 사용되었습니다PSQL쿼리 결과를 인쇄하려면 이것은 더 이상 그렇지 않습니다. 그것은 모든 것을 가정합니다 데이터는 텍스트 형식입니다.

SQL 명령에서 명령 상태 태그를 반환합니다 생성 한pgresult.

char *pqcmdstatus (pgresult *res);

일반적으로 이것은 명령의 이름 일뿐입니다. 행 수와 같은 추가 데이터를 포함 할 수 있습니다. 가공. 발신자는 결과를 자유롭게하지 않아야합니다 곧장. 관련이 해방 될 것입니다pgresult핸들이 전달됩니다PQCLEAR.

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

char *pqcmdtuples (pgresult *res);

이 함수는 숫자를 포함하는 문자열을 반환합니다 의 영향을받는 줄SQLpgresult. 이 기능은 할 수 있습니다 AN의 실행 후에 만 ​​사용됩니다삽입, 업데이트, 삭제, 움직임또는Fetch진술 또는 anexecuteof a A를 포함하는 준비된 쿼리삽입, 업데이트, 또는삭제진술. 만약 생성 한 배트맨 토토pgresult다른 것이 었습니다.pqcmdtuples반환합니다 빈 문자열. 발신자는 반환 값을 자유롭게하지 않아야합니다 곧장. 관련이 해방 될 것입니다pgresult핸들이 전달됩니다PQCLEAR.

OID 반환삽입 된 행의 경우SQL배트맨 토토은삽입정확히 하나의 행을 삽입했습니다 OIDS가있는 테이블 또는 Aexecutea 적합한삽입진술. 그렇지 않으면이 함수가 반환됩니다Invalidoid. 이 기능도 반환됩니다Invalidoid테이블이 영향을받는 경우 에 의해삽입명령문은 그렇지 않습니다 OIDS 포함.

OID pqoidValue (const pgresult *res);

삽입 된 행의 OID가있는 문자열을 반환합니다. 그만큼SQL배트맨 토토은삽입정확히 하나를 삽입했습니다 행 또는 Aexecute의 준비 적절한 것으로 구성된 진술삽입. (문자열은0인 경우삽입정확히 하나의 행을 삽입하지 않았거나 대상 테이블이 Oids가 없습니다.) 명령이 아닌 경우삽입, 빈 문자열을 반환합니다.

char *pqoidstatus (const pgresult *res);

이 배트맨 토토는에 찬성하여 더 이상 사용되지 않습니다.pqoidvalue. 스레드-안전이 아닙니다.

SQL 명령 내에서 사용하기 위해 이진 데이터를 Escapes 유형BYTEA. 와 마찬가지로PQESCAPESTRINGCONN, 이것은입니다 데이터를 SQL에 직접 삽입 할 때만 사용됩니다 명령 문자열.

부호없는 char *pqescapebyteaconn (pgconn *conn,
                                 서명되지 않은 char *에서,
                                 size_t from_length,
                                 size_t *to_length);

특정 바이트 값필수탈출됩니다 (그러나 모두 바이트 값can탈출) A의 일부로 사용될 때BYTEA문자 그대로SQL진술. 일반적으로 탈출 바이트, 3 자리 숫자 옥탈 번호로 변환됩니다. 옥넷 값과 같으며 1-2 분에 앞서 백 슬래시. 단일 인용문 (') 및 backslash (\) 문자는 특별한 대안이 있습니다 탈출 시퀀스. 보다섹션 8.4더 많은 경우 정보.PQESCAPEBYTEACONN이것을 수행합니다 작전, 최소한으로 요구되는 것만 탈출합니다 바이트.

theFrom매개 변수 포인트 탈출 할 문자열의 첫 바이트에 그리고from_length매개 변수 이 바이너리 스트링에서 바이트 수를 제공합니다. (에이 제로 바이트 종단은 필요하거나 계산되지 않습니다.) 그만큼to_length매개 변수 포인트 결과적인 탈출 된 문자열을 보유 할 변수로 길이. 이 결과 문자열 길이에는 다음이 포함됩니다 결과의 제로 바이트 종단.

PQESCAPEBYTEACONN탈출 한 버전의 반환From메모리에있는 매개 변수 바이너리 스트링 할당malloc (). 이 메모리는를 사용하여 해제되어야합니다.pqfreemem ()결과가 아니오 인 경우 더 오래 필요합니다. 반환 문자열에는 모두 특별합니다 캐릭터가 올바르게 될 수 있도록 캐릭터가 교체되었습니다 에 의해 처리postgresql문자열 리터럴 파서, 그리고BYTEA입력 배트맨 토토. 에이 제로 바이트 종단도 추가됩니다. 단일 따옴표 주변을 둘러싼PostgreSQL문자열 리터럴은 아닙니다 결과 문자열의 일부.

오류가 발생하면 널 포인터가 반환되고 적합합니다. 오류 메시지가에 저장됩니다.conn개체. 현재 유일한 것입니다 가능한 오류는 결과에 대한 메모리가 충분하지 않습니다 끈.

PQESCAPEBYTEAis 구형, 더 이상 사용되지 않은PQESCAPEBYTEACONN.

부호없는 char *pqescapebytea (const unsigned char *from,
                             size_t from_length,
                             size_t *to_length);

유일한 차이점PQESCAPEBYTEACONNPQESCAPEBYTEAapgconn매개 변수. 때문에 이것은에 따라 동작을 조정할 수 없습니다 연결 속성 (특히, 여부 표준 정보 문자열이 활성화 됨) 및잘못 될 수 있습니다 결과. 또한 오류를 반환 할 방법이 없습니다 실패에 관한 메시지.

PQESCAPEBYTEA할 수 있습니다 작동하는 단일 스레드 클라이언트 프로그램에서 안전하게 사용됩니다 단 하나만PostgreSQL한 번에 연결 (이 경우 무엇을 찾을 수 있습니다. 알아야"뒤에 장면 "). 다른 맥락에서 그것은 보안입니다 위험 및에 찬성하여 피해야합니다PQESCAPEBYTEACONN.

이진 데이터의 문자열 표현을 변환합니다 이진 데이터 - 반대PQESCAPEBYTEA. 이것은 때 필요합니다 검색BYTEA텍스트의 데이터 형식이지만 이진 형식으로 검색 할 때는 그렇지 않습니다.

부호없는 char *pqunescapebytea (const unsigned char *from, size_t *to_length);

theFrom매개 변수 포인트 와 같은 문자열에pqgetValueA에 적용되는 시점BYTEA열.PQUNESCAPEBYTEA이 문자열을 변환합니다 이진 표현으로의 표현. 돌아옵니다 로 할당 된 버퍼에 대한 포인터malloc ()또는 오류의 NULL을 넣고 넣습니다 버퍼의 크기to_length. 결과는 해제되어야합니다 사용PQFREEMEM언제 더 이상 필요하지 않습니다.

이 변환은 정확히 반대가 아닙니다PQESCAPEBYTEA문자열은 예상되지 않습니다"탈출"에서받은 경우pqgetValue. 특히 이것은 의미합니다 문자열 인용 고려 사항이 필요하지 않습니다 그래서 필요 없어pgconn매개 변수.

|libpq.

void pqfreemem (void *ptr);

메모리가 할당 된 메모리에 의해libpq, 특히PQescapeByteaconn, PQESCAPEBYTEA, PQUNESCAPEBYTEA및pqnotifies. Microsoft가 필요합니다 DLL을 가로 질러 메모리를 자유롭게 할 수없는 Windows 멀티 스레드 DLLS (/mdvc6) 사용됩니다. 다른 플랫폼에서는이 기능이 동일합니다 표준 라이브러리 기능free ().