30.3. 명령 실행 스포츠 토토 베트맨

서버에 명령을 제출하고 결과.

스포츠 토토 베트맨 *pqexec (pgconn *conn, const char *command);

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

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

스포츠 토토 베트맨 *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을 사용할 때 실패합니다.

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

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

스포츠 토토 베트맨 *pqprepare (pgconn *conn,
                    const char *stmtname,
                    const char *쿼리,
                    int nparams,
                    const oid *paramtypes);

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

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

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

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

스포츠 토토 베트맨 *pqexecprepared (pgconn *conn,
                         const char *stmtname,
                         int nparams,
                         const char * const * paramvalues,
                         const int *paramlengths,
                         const int *faramformats,
                         int resultformat);

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

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

에 대한 정보를 얻기위한 요청을 제출합니다 지정된 준비된 진술 및 기다립니다 완성.

스포츠 토토 베트맨 *pqdescribeprepared (pgconn *conn, const char *stmtname);

PQDESCREPREPARED응용 프로그램에서 a에 대한 정보를 얻을 수 있습니다 이전에 준비된 진술.pqdescribeprepared만 지원됩니다 프로토콜 3.0 이상 연결; 때는 실패합니다 프로토콜 사용 2.0.

stmtnamecan be""또는 null을 참조하기 위해 null 진술, 그렇지 않으면 기존의 이름이어야합니다. 준비된 진술. 성공에, A스포츠 토토 베트맨상태pgres_command_ok반환됩니다. 그만큼 기능PQNPARAMSandPQPARAMTYPE적용 할 수 있습니다 이것에스포츠 토토 베트맨얻기 위해 준비된 매개 변수에 대한 정보 진술 및 기능pqnfields, pqfname, pqftype등에 대한 정보를 제공합니다 진술의 결과 열 (있는 경우).

에 대한 정보를 얻기위한 요청을 제출합니다 지정된 포털 및 완료를 기다립니다.

스포츠 토토 베트맨 *pqdescribePortal (pgconn *conn, const char *portalname);

pqdescribePortal허용 이전에 대한 정보를 얻기위한 응용 프로그램 포털이 생성되었습니다. (libpq포털에 직접 액세스 할 수는 없지만 이 기능을 사용하여 커서로 생성 된 커서선언 커서SQL 명령.)pqdescribePortal만 지원됩니다 프로토콜 3.0 이상 연결; 때는 실패합니다 프로토콜 사용 2.0.

PortalName할 수 있습니다""또는 널 참조 이름이없는 포털, 그렇지 않으면 이름이어야합니다. 기존 포털. 성공에, A스포츠 토토 베트맨상태pgres_command_ok반환됩니다. 그만큼 기능pqnfields, pqfname, pqftype등을에 적용 할 수 있습니다스포츠 토토 베트맨얻기 위해 결과 열 (있는 경우)에 대한 정보 문.

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

execstatustype pqresultstatus (const 스포츠 토토 베트맨 *res);

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

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

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

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

char *pqresstatus (execstatustype status);

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

char *pqresulterrormessage (const 스포츠 토토 베트맨 *res);

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

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

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

char *pqresultterrorfield (const 스포츠 토토 베트맨 *res, int fieldcode);

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

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

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

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

오류 필드는에서만 사용할 수 있습니다.스포츠 토토 베트맨객체, 아님pgconn개체; 없음PQERRORFIELD기능.

a와 관련된 스토리지를 해제합니다.스포츠 토토 베트맨. 모든 명령 결과가 있어야합니다 를 통해 해방PQCLEAR언제 더 이상 필요하지 않습니다.

void pqclear (스포츠 토토 베트맨 *res);

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

쿼리의 행 수 (튜플)를 반환합니다 결과. 정수 결과를 반환하기 때문에 크기가 크기 때문입니다 결과 세트는 32 비트에서 리턴 값을 넘칠 수 있습니다 운영 체제.

int pqntuples (const 스포츠 토토 베트맨 *res);

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

int pqnfields (const 스포츠 토토 베트맨 *res);

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

char *pqfname (const 스포츠 토토 베트맨 *res,
                      int column_number);

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

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

int pqfnumber (const 스포츠 토토 베트맨 *res,
                      const char *column_name);

47810_47881

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

FOO로 1, 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 스포츠 토토 베트맨 *res,
                     int column_number);

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

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

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

int pqftablecol (const 스포츠 토토 베트맨 *res,
                       int column_number);

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

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

int pqfformat (const 스포츠 토토 베트맨 *res,
                      int column_number);

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

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

OID pqftype (const 스포츠 토토 베트맨 *res,
                    int column_number);

시스템 테이블을 쿼리 할 수 있습니다pg_type이름과 속성을 얻습니다 다양한 데이터 유형 중. 그만큼OIDs of the built-in data types are defined in the fileSRC/포함/카탈로그/PG_TYPE.Hin 소스 트리.

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

int pqfmod (const 스포츠 토토 베트맨 *res,
                   int column_number);

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

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

int pqfsize (const 스포츠 토토 베트맨 *res,
                    int column_number);

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

반환 1 인 경우 1스포츠 토토 베트맨텍스트 데이터가 포함 된 경우 이진 데이터와 0이 포함되어 있습니다.

int pqbinaryTuples (const 스포츠 토토 베트맨 *res);

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

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

char *pqgetValue (const 스포츠 토토 베트맨 *res,
                         int row_number,
                         int column_number);

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

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

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

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

int pqgetisnull (const 스포츠 토토 베트맨 *res,
                        int row_number,
                        int column_number);

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

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

int pqgetlength (const 스포츠 토토 베트맨 *res,
                        int row_number,
                        int column_number);

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

준비된 매개 변수 수를 반환합니다 성명.

int pqnparams (const 스포츠 토토 베트맨 *res);

이 기능은 검사 할 때만 유용합니다 의 결과PQDESCREPREPARED. 다른 유형의 경우 쿼리는 0을 반환합니다.

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

OID PQPARAMTYPE (const 스포츠 토토 베트맨 *res, int param_number);

이 기능은 검사 할 때만 유용합니다 의 결과PQDESCREPREPARED. 다른 유형의 경우 쿼리는 0을 반환합니다.

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

void pqprint (파일 *fout, / *출력 스트림 * /
             const 스포츠 토토 베트맨 *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 명령에서 명령 상태 태그를 반환합니다 생성 한스포츠 토토 베트맨.

char *pqcmdstatus (스포츠 토토 베트맨 *res);

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

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

char *pqcmdtuples (스포츠 토토 베트맨 *res);

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

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

OID pqoidValue (const 스포츠 토토 베트맨 *res);

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

char *pqoidstatus (const 스포츠 토토 베트맨 *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 자리 숫자 옥탈 번호로 변환됩니다. 옥셋 값과 같으며 일반적으로 2가 앞서 백 슬래시. 단일 인용문 (') 및 백 슬래시 (\) 문자는 특별한 대안이 있습니다 탈출 시퀀스. 보다섹션 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매개 변수.