| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 31. ECPG - C언어에 의한 매입SQL | Fast Forward | Next |
pgtypes 라이브러리는 PostgreSQL데이터베이스의 형태를 C프로그램으로 사용할 수 있도록 C언어에 대응시킵니다 또, 이러한 형태를 사용한 C의 기본적인 계산을 실시하는 함수도 제공합니다. 이 계산에서는, PostgreSQL 서버를 사용하지 않습니다. 이하의 예를 참조해 주세요.
EXEC SQL BEGIN DECLARE SECTION;
date date1;
timestamp ts1, tsout;
interval iv1;
char *out;
EXEC SQL END DECLARE SECTION;
PGTYPESdate_today(&date1);
EXEC SQL SELECT started, duration INTO :ts1, :iv1 FROM datetbl WHERE d=:date1;
PGTYPEStimestamp_add_interval(&ts1, &iv1, &tsout);
out = PGTYPEStimestamp_to_asc(&tsout);
printf("Started + duration: %s\n", out);
free(out);
수치형에서는, 임의의 정밀도를 가진 계산 기능을 제공합니다.
PostgreSQL서버에 대응하는 형태에 대해서는 Section 8.1을 참조해 주세요.
임의 정밀도를 가지기 때문에, 이 변수는 동적으로 확장, 축소할 수 있어야 합니다.
이것이, PGTYPESnumeric_new 나 PGTYPESnumeric_free함수에서는, heap 영역상에서만 변수를 작성할 수 있는 이유입니다.
비슷하지만 정밀도가 한정된 10진수 형태는 heap 영역 이외에 스택 영역상에서도 작성 가능합니다.
이하의 함수는 수치형으로 작동시킬 수가 있습니다.
PGTYPESnumeric_new
새롭게 할당된 수치형에 포인터를 요청합니다.
numeric *PGTYPESnumeric_new(void);
PGTYPESnumeric_free
수치형을 풀어주어, 그 메모리를 모두 해방합니다.
void PGTYPESnumeric_free(numeric *var);
PGTYPESnumeric_from_asc
문자열 표기에서 수치형으로 변환합니다.
numeric *PGTYPESnumeric_from_asc(char *str, char **endptr);
유효한 형식의 예를 나타냅니다. -2, .794, +3.44, 592.49E07, -32.84e-4. 값의 변환에 성공했을 경우, 유효한 포인터가 돌려주어집니다. 실패했을 경우는 NULL포인터가 돌려주어집니다. 현재 ecpg는 문자열 전체를 해석하기 때문에, 아직 *endptr의 첫 번째 무효 문자의 주소의 저장을 지원하지 않습니다. 이 때문에 endptr를 안전하게 NULL로 할 수 있습니다.
PGTYPESnumeric_to_asc
수치형num의 문자열 표현을 가지는, malloc로 할당할 수 있었던 문자열에 포인터를 돌려줍니다.
char *PGTYPESnumeric_to_asc(numeric *num, int dscale);
수치는, 필요에 따라서 사사오입 되어 dscale10진수로 출력됩니다.
PGTYPESnumeric_add
2개의 수치 변수를 가산해, 3번째 수치 변수에 저장합니다.
int PGTYPESnumeric_add(numeric *var1, numeric *var2, numeric *result);
이 함수는 변수 var1와 변수var2에 가산해, 그 결과를 result에 저장합니다. 성공시 0을, 에러시-1을 돌려줍니다.
PGTYPESnumeric_sub
2개의 수치형 변수를 감산해, 3번째 수치형 변수에 결과를 저장합니다.
int PGTYPESnumeric_sub(numeric *var1, numeric *var2, numeric *result);
이 함수는 변수var1로부터 변수var2를 제합니다. 연산 결과는 변수var3에 저장합니다. 성공시 0을, 에러시-1을 돌려줍니다.
PGTYPESnumeric_mul
2개의 수치형 변수를 곱셈해, 3번째 수치형 변수에 결과를 저장합니다.
int PGTYPESnumeric_mul(numeric *var1, numeric *var2, numeric *result);
이 함수는 변수var1와 변수var2를 곱합니다. 연산 결과는 변수var3에 저장합니다. 성공시 0을, 에러시-1을 돌려줍니다.
PGTYPESnumeric_div
2개의 수치형 변수로 나눗셈해, 3번째 수치형 변수에 결과를 저장합니다.
int PGTYPESnumeric_div(numeric *var1, numeric *var2, numeric *result);
이 함수는 변수var1를 변수var2로 나눕니다. 연산 결과는 변수var3에 저장합니다. 성공시 0을, 에러시-1을 돌려줍니다.
PGTYPESnumeric_cmp
2개의 수치형 변수를 비교합니다.
int PGTYPESnumeric_cmp(numeric *var1, numeric *var2)
이 함수는 2개의 수치형 변수를 비교합니다. 에러의 경우 INT_MAX가 돌아갑니다. 성공시, 이 함수는 이하의 세가지 중 하나를 돌려줍니다.
var1가 var2보다 크면 1.
var1가 var2보다 작으면―1.
var1가 var2와 동일하면 0.
PGTYPESnumeric_from_int
int형 변수를 수치형으로 변환합니다.
int PGTYPESnumeric_from_int(signed int int_val, numeric *var);
이 함수는 부호부 정수형의 변수를 받아들여 수치형 변수var에 저장합니다. 성공시 0, 실패시 -1이 돌아갑니다.
PGTYPESnumeric_from_long
long int형 변수를 수치형 변수로 변환합니다.
int PGTYPESnumeric_from_long(signed long int long_val, numeric *var);
이 함수는 부호부 long int형의 변수를 받아들여 수치형 변수var내에 저장합니다. 성공시 0, 실패시-1이 돌아갑니다.
PGTYPESnumeric_copy
수치형 변수를 다른 수치형 변수에 복사합니다.
int PGTYPESnumeric_copy(numeric *src, numeric *dst);
이 함수는, src가 지시하는 변수의 값을 dst가 지시하는 변수에 복사합니다. 성공시 0, 실패시-1이 돌아갑니다.
PGTYPESnumeric_from_double
double형의 변수를 수치형 변수로 변환합니다.
int PGTYPESnumeric_from_double(double d, numeric *dst);
이 함수는 double형의 변수를 받아들여 변환 결과를 dst가 지시하는 변수내에 저장합니다. 성공시 0, 실패시-1이 돌아갑니다.
PGTYPESnumeric_to_double
수치형 변수를 double형으로 변환합니다.
int PGTYPESnumeric_to_double(numeric *nv, double *dp)
이 함수는 nv가 지시하는 수치형 변수의 값을 dp가 지시하는 double형 변수로 변환합니다. 성공시 0, 오버플로우를 포함한 에러가 발생했을 때 -1이 돌아갑니다. 오버플로우가 발생했을 경우는, 추가적으로 광역 변수errno는 PGTYPES_NUM_OVERFLOW로 설정됩니다.
PGTYPESnumeric_to_int
수치형 변수를 int형으로 변환합니다.
int PGTYPESnumeric_to_int(numeric *nv, int *ip);
이 함수는 nv가 지시하는 수치형 변수의 값을 ip가 지시하는 정수형 변수로 변환합니다. 성공시 0, 오버플로우를 포함한 에러가 발생했을 때 -1이 돌아갑니다. 오버플로우가 발생했을 경우는, 추가적으로 광역 변수errno는 PGTYPES_NUM_OVERFLOW로 설정됩니다.
PGTYPESnumeric_to_long
수치형 변수를 long형으로 변환합니다.
int PGTYPESnumeric_to_long(numeric *nv, long *lp);
이 함수는 nv가 지시하는 수치형 변수의 값을 lp가 지시하는 long 변수로 변환합니다. 성공시 0, 오버플로우를 포함한 에러가 발생했을 때 -1이 돌아갑니다. 오버플로우가 발생했을 경우는, 추가적으로 광역 변수errno는 PGTYPES_NUM_OVERFLOW로 설정됩니다.
PGTYPESnumeric_to_decimal
수치형 변수를 10 진수형으로 변환합니다.
int PGTYPESnumeric_to_decimal(numeric *src, decimal *dst);
이 함수는 src가 지시하는 수치형 변수의 값을 dst가 지시하는 long 변수로 변환합니다. 성공시 0, 오버플로우를 포함한 에러가 발생했을 때 -1이 돌아갑니다. 오버플로우가 발생했을 경우는, 추가적으로 광역 변수errno는 PGTYPES_NUM_OVERFLOW로 설정됩니다.
PGTYPESnumeric_from_decimal
10 진수형 변수를 수치형으로 변환합니다.
int PGTYPESnumeric_from_decimal(decimal *src, numeric *dst);
이 함수는 src가 지시하는 10 진수형 변수의 값을 dst가 지시하는 수치형 변수로 변환합니다. 성공시 0, 에러가 발생했을 때 -1이 돌아갑니다. 10 진수형은 제한부의 수치형으로서 구현되고 있기 때문에, 이 변환에서는 오버플로우가 일어나지 않습니다.
C의 데이터형을 사용해, 프로그램으로부터 SQL형의 데이터를 취급할 수가 있습니다. PostgreSQL서버의 동일한 형태는 Section 8.5을 참조해 주세요.
데이터형을 조작하기 위해서 이하의 함수를 사용할 수 있습니다.
PGTYPESdate_from_timestamp
타임스템프에서 일자를 꺼냅니다.
date PGTYPESdate_from_timestamp(timestamp dt);
이 함수는 유일한 인자로 타임스템프를 받아들이고 이로부터 일자 부분을 꺼냅니다.
PGTYPESdate_from_asc
텍스트 표현에서 일자형으로 변환합니다.
date PGTYPESdate_from_asc(char *str, char **endptr);
이 함수는 C의 char*형태 문자열 str와 C의 char*형태 문자열 endptr에 포인터를 받아들입니다. 현재 ecpg는 문자열 전체를 해석하기 때문에, 아직 *endptr에 첫 번째 무효 문자의 주소를 저장하지 않습니다. 이 때문에 endptr를 안전하게 NULL로 할 수 있습니다.
이 함수가 항상 MDY 서식의 일자를 전제로 하고 있는 점에 주의해 주세요. 현재 ecpg에는 이것을 변경하기 위한 변수가 없습니다.
이하의 입력 서식이 가능합니다.
Table 31-1. Valid input formats for PGTYPESdate_from_asc
| Input | Result |
|---|---|
| January 8, 1999 | January 8, 1999 |
| 1999-01-08 | January 8, 1999 |
| 1/8/1999 | January 8, 1999 |
| 1/18/1999 | January 18, 1999 |
| 01/02/03 | February 1, 2003 |
| 1999-Jan-08 | January 8, 1999 |
| Jan-08-1999 | January 8, 1999 |
| 08-Jan-1999 | January 8, 1999 |
| 99-Jan-08 | January 8, 1999 |
| 08-Jan-99 | January 8, 1999 |
| 08-Jan-06 | January 8, 2006 |
| Jan-08-99 | January 8, 1999 |
| 19990108 | ISO 8601; January 8, 1999 |
| 990108 | ISO 8601; January 8, 1999 |
| 1999.008 | year and day of year |
| J2451187 | Julian day |
| January 8, 99 BC | year 99 before the Common Era |
PGTYPESdate_to_asc
일자 변수의 텍스트 표현을 돌려줍니다.
char *PGTYPESdate_to_asc(date dDate);
이 함수는 유일한 인자로서 일자형dDate를 접수합니다. 이 함수는 1999-01-18, 즉 YYYY-MM-DD서식에서 일자를 출력합니다.
PGTYPESdate_julmdy
일자형의 변수로부터, 일, 월, 년의 값을 꺼냅니다.
void PGTYPESdate_julmdy(date d, int *mdy);
이 함수는 일자형의 d와 3개의 정수값을 가지는 배열mdy에 포인터를 받아들입니다. 이 변수명은 그 순차적 순서를 나타내고, mdy[0]에는 월수, mdy[1]에는 날짜가, mdy[2]에는 년이 포함됩니다.
PGTYPESdate_mdyjul
일자의 일, 월, 년을 지정한 3개의 정수의 배열로 일자 값을 작성합니다.
void PGTYPESdate_mdyjul(int *mdy, date *jdate);
이 함수는, 첫 번째 인자로서 3개의 정수의 배열(mdy)와 두 번째 인자로서 처리 결과를 저장하는 일자형의 변수에 포인터를 받아들입니다.
PGTYPESdate_dayofweek
일자값에 주간 날짜를 나타내는 수를 돌려줍니다.
int PGTYPESdate_dayofweek(date d);
이 함수는 일자형 변수d를 유일한 인자로 받아들여, 그 일자의 주간 날짜를 나타내는 정수를 돌려줍니다.
0 - 일요일
1 - 월요일
2 - 화요일
3 - 수요일
4 - 목요일
5 - 금요일
6 - 토요일
PGTYPESdate_today
현재의 일자를 돌려줍니다.
void PGTYPESdate_today(date *d);
이 함수는 현재의 일자를 설정하는 일자형 변수(d)를 지시하는 포인터를 받아들입다.
PGTYPESdate_fmt_asc
일자형 변수를 서식 마스크를 사용한 텍스트 표현으로 변환합니다.
int PGTYPESdate_fmt_asc(date dDate, char *fmtstring, char *outbuf);
이 함수는 변환 대상의 일자(dDate), 서식 마스크(fmtstring), 일자의 텍스트 표현을 저장하기 위한 문자열(outbuf)을 받아들입니다.
성공시에 0, 에러가 발생했을 경우는 부의 값이 돌아옵니다.
이하의 리터럴을 사용해, 필드를 지정할 수 있습니다.
dd - 월간 날짜.
mm - 연간 월수.
yy - 2자리수 표기의 연수
yyyy - 4자리수 표기의 연수
ddd - 일의 이름(생략형)
mmm - 월의 이름(생략형)
다른 문자는 모두 출력 문자열에 그대로 복사됩니다.
이하의 표에 몇 개의 서식의 예를 나타냅니다. 이 함수의 사용법에 관한 개념을 제공하고 있습니다. 출력행은 모두 1959년 11월 23의에 근거하고 있습니다.
Table 31-2. 유효한PGTYPESdate_fmt_asc의 입력 서식
| 서식 | 결과 |
|---|---|
| mmddyy | 112359 |
| ddmmyy | 231159 |
| yymmdd | 591123 |
| yy/mm/dd | 59/11/23 |
| yy mm dd | 59 11 23 |
| yy.mm.dd | 59.11.23 |
| .mm.yyyy.dd. | .11.1959.23. |
| mmm. dd, yyyy | Nov. 23, 1959 |
| mmm dd yyyy | Nov 23 1959 |
| yyyy dd mm | 1959 23 11 |
| ddd, mmm. dd, yyyy | Mon, Nov. 23, 1959 |
| (ddd) mmm. dd, yyyy | (Mon) Nov. 23, 1959 |
PGTYPESdate_defmt_asc
서식 마스크를 사용해 C의 char* 문자열을 일자형의 값으로 변환합니다.
int PGTYPESdate_defmt_asc(date *d, char *fmt, char *str);
이 함수는, 처리 결과를 저장하기 위한 일자형에 포인터(d), 일자를 해석하기 위한 서식 마스크(fmt), 일자의 텍스트 표현을 포함한 C의 char*캐릭터 라인(str)을 받아들입니다. 텍스트 표현이 서식 마스크에 맞는 표현인 것을 가정하고 있습니다. 그러나, 문자열과 서식 마스크를 1:1 대응시킬 필요는 없습니다. 이 함수는 순차적 순서로 해석해, 년의 위치를 나타내는 yy 또는 yyyy를, 월의 위치를 나타내는 mm를, 일의 위치를 나타내는 dd를 검색합니다.
이하의 표에 서식의 예를 몇 개 가리킵니다. 이 함수의 사용 방법에 관한 개념을 제공합니다.
Table 31-3. 유효한rdefmtdate의 입력 서식
| fmt | str | 결과 |
|---|---|---|
| ddmmyy | 21-2-54 | 1954-02-21 |
| ddmmyy | 2-12-54 | 1954-12-02 |
| ddmmyy | 20111954 | 1954-11-20 |
| ddmmyy | 130464 | 1964-04-13 |
| mmm.dd.yyyy | MAR-12-1967 | 1967-03-12 |
| yy/mm/dd | 1954, February 3rd | 1954-02-03 |
| mmm.dd.yyyy | 041269 | 1969-04-12 |
| yy/mm/dd | In the year 2525, in the month of July, mankind will be alive on the 28th day | 2525-07-28 |
| dd-mm-yy | I said on the 28th of July in the year 2525 | 2525-07-28 |
| mmm.dd.yyyy | 9/14/58 | 1958-09-14 |
| yy/mm/dd | 47/03/29 | 1947-03-29 |
| mmm.dd.yyyy | oct 28 1975 | 1975-10-28 |
| mmddyy | Nov 14th, 1985 | 1985-11-14 |
C의 타임스템프형을 사용해 프로그램에서 SQL의 타임스템프형 데이터를 취급할 수 있습니다. PostgreSQL에 대응하는 형태에 대해서는 Section 8.5을 참조해 주세요.
이하의 함수를 사용해 타임스템프형을 취급할 수 있습니다.
PGTYPEStimestamp_from_asc
텍스트 표현의 타임 스탬프를 타임 스탬프형 변수로 변환합니다.
timestamp PGTYPEStimestamp_from_asc(char *str, char **endptr);
이 함수는 변환 대상의 캐릭터 라인(str)과 C char*에의 포인터(endptr)를 받아들입니다. 현재 ecpg는 문자열 전체를 해석하기 때문에, 아직 *endptr에 첫 번째 무효 문자의 주소를 저장을 하는 것을 지원하지 않습니다. 이 때문에 endptr를 안전하게 NULL로 할 수 있습니다.
이 함수는 성공 시 변환 후 타임스템프를 돌려줍니다. 에러 시, PGTYPESInvalidTimestamp가 돌아와 errno가 PGTYPES_TS_BAD_TIMESTAMP로 설정됩니다. 이 값에 대한 중요한 설명에 대한 것은 PGTYPESInvalidTimestamp 를 참조해 주세요.
통상, 입력 문자열은 허용되는 일자 설성, 공백 문자, 허용되는 시간 설정을 포함할 수 있습니다. 타임스템프는 ecpg로 지원되지 않은 점에 주의해 주세요. 변환할 수 있습니다만, 예를 들어, PostgreSQL서버가 실시하는 계산과 같은 것을 실시할 수 없습니다. 시간대 설정은 경고 없이 무시됩니다.
이하의 표에 입력 문자열의 예를 몇 개 가리킵니다.
PGTYPEStimestamp_to_asc
일자를 C char*문자열로 변환합니다.
char *PGTYPEStimestamp_to_asc(timestamp tstamp);
이 함수는 타임스템프tstamp를 유일한 인자로 받아들이고, 타임스템프의 텍스트 표현을 포함한 할당된 문자열을 돌려줍니다.
PGTYPEStimestamp_current
현재의 타임스템프를 꺼냅니다.
void PGTYPEStimestamp_current(timestamp *ts);
이 함수는 현재의 타임스템프를 꺼내, ts가 지시하는 타임스템프형 변수에 저장합니다.
PGTYPEStimestamp_fmt_asc
서식 마스크를 사용해 타임스템프형 변수를 C char*로 변환합니다.
int PGTYPEStimestamp_fmt_asc(timestamp *ts, char *output, int str_len, char *fmtstr);
이 함수는, 첫 번째 인자로 변환 대상의 타임스템프(ts), 출력 버퍼의 포인터(output), 출력 버퍼로 할당 가능한 가장 긴 (str_len), 변환에 사용하는 서식 마스크(fmtstr)를 받아들입다.
성공 시, 함수는 0을 돌려줍니다. 에러가 발생했을 경우는 부의 값이 돌아갑니다.
서식 마스크에는 이하의 서식 설정을 사용할 수 있습니다. 서식 설정은
libc의 strftime함수에서 사용되는 것과 같습니다.
서식 설정 이외에는 출력 버퍼에 복사됩니다.
%A - 각 언어의 요일 명칭에 치환됩니다.
%a - 각 언어의 요일 약칭에 치환됩니다.
%B - 각 언어의 월 명칭에 치환됩니다.
%b - 각 언어의 월 약칭에 치환됩니다.
%C - 년을 100으로 나눈 10 진수에 치환됩니다. 1자리수의 경우는 선두에 0이 부여됩니다.
%c - 각 언어의 일자와 시간으로 치환됩니다.
%D - %m/%d/%y과 같습니다.
%d - 월의 10진날짜(01-31)에 치환됩니다.
%E* %O* - POSIX 로케일 확장입니다. %Ec %EC %Ex %EX %Ey %EY %Od %Oe %OH %OI %Om %OM %OS %Ou %OU %OV %Ow %OW %Oy 다른 표현을 제공하는 것이 가정되고 있습니다.
또한, %OB는, (날에 관한 언급없이 단독적으로 사용된다) 다른 월 명을 나타내는 것으로서 구현되고 있습니다.
%e - 월의 10진날짜(1-31)에 치환됩니다. 1자리수의 경우는 앞에 공백을 붙일 수 있습니다.
%F - %Y-%m-%d과 같습니다.
%G - 세기부의 10 진수로서 년에 치환됩니다. 이 연은 주부분이 보다 많이 포함됩니다. (월요일이 주의 첫 번째 날입니다. )
%g -%G같이 해에 치환됩니다만, 세기부가 없는 10 진수(00-99)입니다.
%H - 10진의 시간(24시간 단위)에 치환됩니다(00-23).
%h - %b과 같습니다.
%I - 10진의 시간(12시간 단위)에 치환됩니다(01-12).
%j - 10진의 연내 날짜에 치환됩니다(001-366).
%k - 10진의 시간(24시간 단위)에 치환됩니다(0-23). 1자리수의 경우는 선두에 공백을 붙일 수 있습니다.
%l - 10진의 시간(12시간 단위)에 치환됩니다(1-12). 1자리수의 경우는 선두에 공백을 붙일 수 있습니다.
%M - 10진의 분수에 치환됩니다(00-59).
%m -10진의 월수에 치환됩니다(01-12).
%n - 새로운 행에 치환됩니다.
%O* - %E*과 같습니다.
%p - 각 언어의 "오전" 또는 "오후"에 적절히 치환됩니다.
%R - %H:%M과 같습니다.
%r - %I:%M:%S %p과 같습니다.
%S - 10진의 초수에 치환됩니다(00-60).
%s - 신기원, UTC로부터의 초수에 치환됩니다.
%T - %H:%M:%S과 같습니다.
%t - 탭에 치환됩니다.
%U - 10진의 주번호(일요일이 주의 선두입니다)에 치환됩니다.
%u - 10진의 주번호(월요일이 주의 선두입니다)에 치환됩니다.
%V - 10진의 연내의 주번호(월요일이 주의 선두입니다)에 치환됩니다(01-53). 새로운 해로, 1월 1일을 포함한 주가 4일 이상 존재하는 경우, 그 주가 1이 됩니다. 아니면, 이 주는 전 년의 주가 되어, 다음의 주가 1이 됩니다.
%v - %e-%b-%Y과 같습니다.
%W - 10진의 연내의 주번호(월요일이 주의 선두입니다)에 치환됩니다(00-53).
%w - 10진의 주내 날짜(일요일이 주의 선두입니다)에 치환됩니다(0-6).
%X - 각 언어의 시간으로 치환됩니다.
%x - 각 언어의 일자 표현에 치환됩니다.
%Y - 10진의 세기부 년에 치환됩니다.
%y - 10진의 세기 없이 년에 치환됩니다(00-99).
%Z - 시간대 명칭에 치환됩니다.
%z - UTC로부터의 시간대 오프셋(offset)에 치환됩니다. UTC보다 동쪽에서는 정부호가 뒤따르고, 서쪽에서는 부부호가 붙습니다. 각각 2자리수의 시간과 분이 그 후에 계속됩니다만, 단락은 없습니다. (이 형식은 RFC 822의 일자 헤더로 자주 사용됩니다. )
%+ - 각 언어의 일자와 시각에 치환됩니다.
%-* - GNU libc 확장입니다. 수치 출력을 실시할 때에 아무 문자를 채우지 않습니다.
$_* - GNU libc의 확장입니다. 명시적으로 공백 문자를 사용해 문자를 채웁니다.
%0* - GNU libc의 확장입니다. 명시적으로 0을 사용해 문자를 채웁니다.
%% - %에 치환됩니다.
PGTYPEStimestamp_sub
타임스템프의 감산을 실시해, 그 결과를 시간 간격(분)의 변수에 저장합니다.
int PGTYPEStimestamp_sub(timestamp *ts1, timestamp *ts2, interval *iv);
이 함수는 ts1가 지시하는 타임 스탬프형 변수에서 ts2가 지시하는 타임스템프형 변수를 가감해, iv가 지시하는 시간 간격형 변수에 결과를 저장합니다.
이 함수는 성공하면 0을 돌려주고, 에러가 발생했을 경우는 부의 값을 돌려줍니다.
PGTYPEStimestamp_defmt_asc
서식 마스크를 사용해, 텍스트 표현으로부터 타임스템프 값을 변환합니다.
int PGTYPEStimestamp_defmt_asc(char *str, char *fmt, timestamp *d);
이 함수는 str변수내에 저장된 타임스템프의 텍스트 표현, fmt변수에서 사용하는 서식 마스크를 받아들입니다. 결과는 d가 지시하는 변수내에 저장됩니다.
서식 마스크fmt가 NULL이라면, 이 함수는 기본값의 서식 마스크%Y-%m-%d %H:%M:%S를 사용하게 됩니다.
이것은
PGTYPEStimestamp_fmt_asc
의 역함수입니다.
사용할 수 있는 서식 마스크 항목에 대해서는 그 문서를 참조해 주세요.
PGTYPEStimestamp_add_interval
타임스템프형 변수에 시간 간격형 변수를 가산합니다.
int PGTYPEStimestamp_add_interval(timestamp *tin, interval *span, timestamp *tout);
이 함수는, 타임스템프형 변수tin의 포인터와 시간 간격형 변수span의 포인터를 받아들입니다. 이것은, 시간 간격 값을 타임스템프 값에 가산해, 그 결과 타임스템프 값을 tout가 지시하는 변수에 저장합니다.
이 함수는 성공하면 0을 돌려줍니다. 에러가 발생했을 경우는 부의 값을 돌려줍니다.
PGTYPEStimestamp_sub_interval
타임스템프형 변수에서 시간 간격형 변수를 뺍니다.
int PGTYPEStimestamp_sub_interval(timestamp *tin, interval *span, timestamp *tout);
이 함수는 tin가 지시하는 타임스템프형 변수로부터 span가 지시하는 시간 간격형 변수를 가감합니다. 결과는 tout가 지시하는 변수에 보존됩니다.
함수는 성공하면 0을, 에러가 발생했을 경우는 부의 값을 돌려줍니다.
C에서의 시간 간격형은 프로그램에서 SQL의 시간 간격형의 데이터를 취급할 수 있습니다. PostgreSQL서버에 대응하는 형태에 대해서는 Section 8.5을 참조해 주세요.
이하의 함수를 사용해, 시간 간격형을 취급할 수가 있습니다.
PGTYPESinterval_new
새롭게 할당한 시간 간격형 변수에 포인터를 돌려줍니다.
interval *PGTYPESinterval_new(void);
PGTYPESinterval_free
이전에 할당된 시간 간격형 변수의 메모리를 풀어줍니다.
void PGTYPESinterval_new(interval *intvl);
PGTYPESinterval_from_asc
텍스트 표현으로부터 시간 간격형으로 변환합니다.
interval *PGTYPESinterval_from_asc(char *str, char **endptr);
이 함수는 입력 문자열str를 변환해, 할당된 시간 간격형에 포인터를 돌려줍니다. 현재 ecpg는 문자열 전체를 해석하기 때문에, 아직 *endptr에 첫 번째 무효 문자의 장소를 저장하지 않습니다. 이 때문에 endptr를 안전하게 NULL로 할 수 있습니다.
PGTYPESinterval_to_asc
시간 간격형 변수를 텍스트 표현으로 변환합니다.
char *PGTYPESinterval_to_asc(interval *span);
이 함수는 span가 지시하는 시간 간격형 변수를 C char*로 변환합니다. 출력은 @ 1 day 12 hours 59 mins 10 secs와 같이 됩니다.
PGTYPESinterval_copy
시간 간격형 변수를 복사합니다.
int PGTYPESinterval_copy(interval *intvlsrc, interval *intvldest);
이 함수는, intvlsrc가 지시하는 시간 간격형 변수를 intvldest가 지시하는 변수에 복사합니다. 사전에 변수용의 메모리를 할당할 필요가 있는 것에 주의해 주세요.
10 진수형은 수치형과 비슷합니다. 그러나, 그 최대 정밀도는 30 유효자리수로 제한되고 있습니다. heap상에서만 작성되는 수치형과 비교해 10 진수형은 스택 또는 heap상에 작성될 수 있습니다. (이 때문에는 PGTYPESdecimal_new() 및 PGTYPESdecimal_free() 함수를 사용합니다. ) Section 31.9에서 설명되는 Informix호환 모드에서는 10 진수형을 취급하는 함수가 보다 많이 존재합니다.
이하의 함수를 사용해, 10 진수형을 취급할 수 있습니다. 이것들은 libcompat라이브러리에 포함되는 뿐만이 아닙니다.
PGTYPESdecimal_new
새롭게 할당된 10 진수형 변수에 포인터를 요구합니다.
decimal *PGTYPESdecimal_new(void);
PGTYPESdecimal_free
10 진수형을 풀고, 그 메모리를 모두 해제합니다.
void PGTYPESdecimal_free(decimal *var);
인자는 수치형 변수(또는 수치형 변수의 포인터)를 포함해야 합니다. 그러나 실제의 메모리상의 표현은 무효입니다.
오버플로우가 발생했습니다. 수치형은 임의의 정밀도를 취급할 수 있기 때문에, 수치형 변수에서 다른 형태로의 변환에서 오버플로우가 발생할 가능성이 있습니다.
언더 플로우(underflow)가 발생했습니다. 수치형은 임의의 정밀도를 취급할 수 있기 때문에, 수치형 변수에서 다른 형태로의 변환에서는 언더플로우가 발생할 가능성이 있습니다.
0 나눗셈이 시행되었습니다.
무효인 타임스템프를 나타내는 타임스템프형의 값입니다.
이것은 PGTYPEStimestamp_from_asc함수에 대해 해석 에러가 발생했을 경우에 돌려주어집니다.
타임스템프 데이터형의 내부 표현과, 동시에 PGTYPESInvalidTimestamp는 유효한 타임스템프이기도 합니다.
이것은 1899-12-31 23:59:59과 설정되어 있습니다.
에러를 검출하기 위해서, 어플리케이션으로 PGTYPESInvalidTimestamp를 검사할 뿐만 아니라,
각 PGTYPEStimestamp_from_asc호출 후에errno ! = 0도 검사해 주세요.