Postgresql 9.3.25 문서 | ||||
---|---|---|---|---|
토토 베이 : 문서 : 9.3 : 제어 기능 | PostgreSQL : 문서 : 9.3 : LIBPQ -C 토토 커뮤니티 | 31 장.libpq-C 라이브러리 | PostgreSQL : 문서 : 9.3 : 배트맨 토토 처리 |
항상 그렇듯이, 맞지 않는 기능이 있습니다. 어딘가에.
PQFREEMEM
|libpq.
void pqfreemem (void *ptr);
메모리가 할당 된 메모리에 의해libpq, 특히PQESCAPEBYTEACONN
, pqescapebytea
, PQUNESCAPEBYTEA
및pqnotifies
. 특히 중요합니다
이 기능은free ()
, be
Microsoft Windows에서 사용됩니다. 이것은 메모리를 할당하기 때문입니다
DLL 및 응용 프로그램에서 릴리스는 다음과 같은 경우에만 작동합니다.
멀티 스레드/단일 스레드, 릴리스/디버그 및 정적/동적
플래그는 DLL 및 응용 프로그램에 대해 동일합니다. ~에
비 마이크로 소프트 Windows 플랫폼,이 기능은
표준 라이브러리 기능free ()
.
PQCONNINFOFREE
|pqconndefaults
또는PQCONNINFOPARSE
.
void pqconninfofree (pqconninfooption *connoptions);
간단한PQFREEMEM
배열에는 자회사에 대한 참조가 포함되어 있기 때문입니다
문자열.
pqencryptpassword
암호화 된 양식의 준비PostgreSQL암호.
char *pqencryptpassword (const char *passwd, const char *user);
이 기능은 클라이언트 응용 프로그램에서 사용하기위한 것입니다.
와 같은 명령을 보내고 싶다.Alter User Joe
암호 'pwd'. 원본을 보내지 않는 것이 좋습니다
노출 될 수 있기 때문에 그러한 명령의 CLEARTEXT 비밀번호
명령 로그에서 활동이 표시됩니다. 대신, 이것을 사용하십시오
암호를 암호화 된 양식으로 변환하는 기능
전송된. 인수는 CLEARTEXT 암호이며 SQL 이름입니다.
사용자는입니다. 리턴 값은에 의해 할당 된 문자열입니다.Malloc
또는null메모리를 벗어난 경우. 발신자는
문자열에는 필요한 특수 문자가 포함되어 있지 않습니다
탈출. 사용PQFREEMEM
그것으로 끝났을 때 결과.
pqmakeemptypy토토 핫
공허한 구성토토 핫개체 주어진 상태로.
토토 핫 *pqmakeemptypypy토토 핫 (pgconn *conn, execstatustype 상태);
이것은libpq의 내부
빈을 할당하고 초기화하는 기능토토 핫개체. 이 함수는 반환null메모리를 할당 할 수없는 경우. 수출됩니다
일부 응용 프로그램은 결과 객체를 생성하는 것이 유용하다고 생각하기 때문에
(특히 오류 상태가있는 객체) 자체. 만약에connNULL이 아니고상태오류, 현재 오류를 나타냅니다
지정된 연결의 메시지가에 복사됩니다.토토 핫. 또한 ifconn는 null이 아니며 모든 이벤트 절차가 등록되었습니다
연결에서에 복사됩니다.토토 핫. (그들은 얻지 못합니다pgevt_resultcreate전화, 참조PQFIRERESULTCREATEEVENTS
.) 참고PQCLEAR
결국
객체, A와 마찬가지로토토 핫반환libpq자체.
PQFIRERESULTCREATEEVENTS
해고 apgevt_resultcreate이벤트 (참조PostgreSQL : 문서 : 9.3 : 메이저 토토 사이트 시스템13957_14004토토 핫개체. 성공을 위해 0이 아닌 반환, 이벤트 절차는 0입니다 실패.
int pqfireresultcreateevents (pgconn *conn, 토토 핫 *res);
theconn인수가 통과됩니다 이벤트 절차이지만 직접 사용되지 않습니다. 될 수 있습니다NULL이벤트 절차가 사용되지 않는 경우.
이미받은 이벤트 절차pgevt_resultcreate또는pgevt_resultcopy이 개체의 이벤트는 발사되지 않았습니다 다시.
이 함수가 분리되어 있다는 주된 이유pqmakeemptypy토토 핫
종종입니다
a 만들기에 적합토토 핫및
이벤트 절차를 호출하기 전에 데이터로 채우십시오.
pqcopyresult
a 사본 만들기토토 핫개체.
사본은 어떤 식 으로든 소스 결과에 연결되어 있지 않으며PQCLEAR
사본이있을 때 호출해야합니다
더 이상 필요하지 않습니다. 함수가 실패하면null반환되었습니다.
토토 핫 *pqcopyresult (const 토토 핫 *src, int flags);
이것은 정확한 사본을 만들기위한 것이 아닙니다. 반환 된 결과 항상pgres_tuples_ok상태, 소스의 오류 메시지를 복사하지 않습니다. (복사합니다 그러나 명령 상태 문자열.)플래그인수는 다른 항목을 결정합니다. 그것 약간 또는 여러 깃발입니다.pg_copyres_attrs소스 복사를 지정합니다 결과 속성 (열 정의).pg_copyres_tuples소스 복사를 지정합니다 결과는 튜플입니다. (이것은 속성을 복사하는 것을 의미합니다.)pg_copyres_noticehooks복사를 지정합니다 소스 결과는 후크에 알립니다.pg_copyres_events소스 복사를 지정합니다 결과의 이벤트. (그러나 소스와 관련된 인스턴스 데이터 복사되지 않았습니다.)
pqsetresultattrs
A의 속성을 설정합니다토토 핫개체.
int pqsetresultattrs (토토 핫 *res, int numattributes, pgresattdesc *attdescs);
제공attdescs결과. 인 경우attdescs포인터 ISNULL또는Numattributes는 1보다 작으며 요청은입니다 무시되고 함수가 성공합니다. 만약에RES이미 속성이 포함되어 있습니다 실패하다. 함수가 실패하면 반환 값은 0입니다. 만약 함수는 성공하고 반환 값은 0이 아닙니다.
pqsetValue
A의 튜플 필드 값 설정토토 핫Object.
int pqsetValue (토토 핫 *res, int tup_num, int field_num, char *value, int len);
함수는 결과의 내부를 자동으로 증가시킵니다
필요에 따라 튜플 어레이. 그러나tup_num인수는보다 작거나 같아야합니다.pqntuples
,이 함수는 할 수 있습니다
한 번에 하나의 튜플을 튜플 어레이 만 자랍니다. 그러나 모든 분야
모든 기존 튜플은 순서대로 수정할 수 있습니다. 값 인 경우Field_num이미 존재합니다
덮어 쓰기. 만약에Lenis -1 또는valueisNULL, 필드
값은 SQL NULL 값으로 설정됩니다. 그만큼value결과의 개인 저장소에 복사됩니다.
따라서 함수가 반환 된 후에는 더 이상 필요하지 않습니다. 만약
함수가 실패하고 반환 값은 0입니다. 함수가 성공하면
반환 값은 0이 아닙니다.
pqresultalloc
a 자회사 할당토토 핫개체.
void *pqresultalloc (토토 핫 *res, size_t nbytes);
이 함수와 함께 할당 된 메모리가 해제 될 때res지워집니다. 함수가 실패하면
반환 값은NULL. 결과는입니다
마찬가지로 모든 유형의 데이터에 대해 적절하게 정렬됩니다.
을 위한Malloc
.
pqlibversion
| 버전 반환libpq사용 중입니다.
int pqlibversion (void);
이 함수의 결과는 실행중인 결정에 사용될 수 있습니다.
시간, 특정 기능이 현재 사용할 수있는 경우
Libpq의로드 된 버전. 예를 들어, 함수는 예를 들어 TO를 사용할 수 있습니다
사용 가능한 연결 옵션을 결정하십시오pqconnectdb
또는hex BYTEA출력이 추가되었습니다
PostgreSQL 9.0이 지원됩니다.
그 숫자는 전공, 미성년자 및 수정 번호는 2- 디지털 번호로 첨가되어 추가됩니다 함께. 예를 들어, 버전 9.1은 90100으로 반환되고 버전 9.1.2는 90102로 반환됩니다 (선행 제로는 그렇지 않습니다. 참조).
참고 :이 함수는에 나타났습니다.PostgreSQL버전 9.1이므로 사용할 수 없습니다 링크 이후 이전 버전에서 필요한 기능을 감지합니다 이를 위해 버전 9.1에 링크 종속성이 생성됩니다.