| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 29. libpq - C 라이브러리 | Fast Forward | Next |
Postgres는 서버로의 간단한 함수 호출을 전송하는 빠른 경로 (fast-path) 인터페이스를 제공합니다.
Tip: 이 함수는 다소 쓸모없습니다. 비슷한 성능이나 그 이상의 성능은, 준비된 문장에서 함수 호출을 정의를 설정하여 달성할 수 있기 때문입니다. 그리고 그 문장은 파라미터와 결과를 바이너리 전송 하도록 실행하면, 빠른 경로 함수 호출됩니다.
PQfn함수는 빠른 경로 인터페이스를 사용해 서버 함수의 실행을 요구합니다.
PGresult *PQfn(PGconn *conn,
int fnid,
int *result_buf,
int *result_len,
int result_is_int,
const PQArgBlock *args,
int nargs);
typedef struct {
int len;
int isint;
union {
int *ptr;
int integer;
} u;
} PQArgBlock;
fnid인자는 실행하는 함수의 OID입니다. args와 nargs는 함수에 건네주는 파라미터를 정의합니다. 이것들은 함수 선언의 인자 리스트에 일치해야 합니다. 파라미터 구조의isint가 true인 경우, u.integer의 값은 서버로 지정된 길이의 정수로서 전송됩니다. (이것은 1, 2혹은 4바이트가 아니면 안됩니다. ) 이 때, 적절한 바이트 교환이 행해집니다. isint가 false인 경우, *u.ptr로 지정된 바이트 수가 처리되지 않고 전송됩니다. 함수의 파라미터 데이터형을 바이너리 전송으로 실시하기 위해서, 이 데이터는 서버가 예상하는 서식일 필요가 있습니다. result_buf 는 반환 값을 저장하는 버퍼입니다. 호출측은 반환 값을 저장하는데 충분한 영역을 확보해 두지 않으면 안됩니다 (라이브러리측에서는 이 검사를 하고 있지 않습니다! ). 실제 결과 길이는 result_len가 가리키는 정수로 반환됩니다. 결과가 1, 2, 4바이트 정수로 예상됩니다면result_is_int를 1에, 그렇지 않으면 0을 설정합니다. result_is_int를 1으로 하면, 필요에 따라서 값의 바이트순서를 바꿔 넣도록libpq에 지시하게 됩니다. 그리고 클라이언트 머신상에서 올바른int 값이 되도록 전송 합니다. result_is_int가 0일 경우는 서버가 보낸 바이너리 서식의 바이트열을 아무것도 수정하지 않고 반환합니다.
PQfn는 항상 유효한 PGresult* 를 반환합니다.
결과가 사용하기 전에는 우선, 결과 상태를 조사해야 합니다.
결과가 필요없게 된 시점에서, PQclear에 의해, PGresult 를 해제하는 것은 호출측의 책임입니다.
이 인터페이스를 사용했을 경우, NULL 인자 리스트나 NULL 결과, 세트 값 결과를 취급하지 못하는 것에 주의하십시요.