PostgreSQL 8.3.3문서
Prev Fast Backward Chapter 31. ECPG - C언어에 의한 매입SQL Fast Forward Next

31.9. Informix호환 모드

ecpg를 Informix 호환 모드라는 모드로 동작시킬 수 있습니다. 이 모드가 유효하면, Informix E/SQL의 Informix프리프로세서처럼 동작합니다. 일반적으로 말하면, 이것에 의해 매입 SQL 명령을 도입할 때에 EXEC SQL프리밋티브 대신에 달러표시를 사용할 수 있습니다. 

   $int j = 3;
   $CONNECT TO :dbname;
   $CREATE TABLE test(i INT PRIMARY KEY, j INT);
   $INSERT INTO test(i, j) VALUES (7, :j);
   $COMMIT;

INFORMIX, INFORMIX_SE라는 2개의 호환 모드가 있습니다.

호환 모드를 사용하는 프로그램을 링크할 때, ecpg와 함께 보내지는 libcompat와 링크하는 것을 잊지 말아 주세요.

이전에 설명한 구문상의 장식 외에도, Informix호환 모드에서는, 입력, 출력, 데이터 변환 함수, E/SQL로부터 ecpg로 기존의 매입 SQL문 변환 함수도 이식하고 있습니다.

Informix호환 모드는 ecpg의 pgtypeslib 라이브러리와 밀접하게 관계하고 있습니다. pgtypeslib는 SQL 데이터형과 C호스트 프로그램내의 데이터형을 대응시키고, 대부분의 Informix호환 모드로 추가된 함수를 사용해 이러한 C호스트 프로그램형을 조작할 수 있습니다. 그러나, 호환 범위는 제한되고 있습니다 이것은 Informix의 동작을 복사하려고 하지 않습니다. 이것을 사용해, 다소 같은 이름으로 같은 기본 동작을 실시하는 함수를 조작, 제공할 수 있습니다만, Informix를 사용하고 있다면, 완전하게 치환되지 않습니다. 뿐만 아니라, 일부의 데이터형이 다릅니다. 예를 들면, PostgreSQL's의 일자 시각이나 시간 간격형에서는 YEAR TO MINUTE와 같은 범위를 가지지 않으므로, 이것들을 ecpg에서는 지원할 수 없는 것을 알 수 있습니다.

31.9.1. 추가의 매입 SQL문

CLOSE DATABASE

이 명령문은 현재의 연결을 닫습니다. 실제, 이것은 ecpg의 DISCONNECT CURRENT와 동의어입니다. 

    $CLOSE DATABASE;                /* close the current connection */
    EXEC SQL CLOSE DATABASE;

31.9.2. 추가 함수

decadd

2개의 10 진수형 변수를 가산합니다. 

int decadd(decimal *arg1, decimal *arg2, decimal *sum);

이 함수는, 10 진수형의 최초의 연산 항목(arg1)의 포인터, 10 진수형의 2번째의 연산 항목(arg2)의 포인터, 가산 결과를 저장하는 10 진수형값(sum)의 포인터를 받아들입니다. 성공하면, 이 함수는 0을 돌려줍니다. 오버플로우가 발생했을 경우는 ECPG_INFORMIX_NUM_OVERFLOW가, 언더 플로우(underflow)의 경우는 ECPG_INFORMIX_NUM_UNDERFLOW가 돌아옵니다. 이 다른 실패가 발생했을 경우는 ―1이 돌아오고, errno에는 pgtypeslib에 대응하는 errno 번호가 설정됩니다.

deccmp

2개의 10 진수형 변수를 비교합니다. 

int deccmp(decimal *arg1, decimal *arg2);

이 함수는, 첫 번째 10 진수값(arg1)의 포인터, 두 번째 10 진수값(arg2)의 포인터를 받아들여 어느 쪽이 큰지 나타내는 정수값을 돌려줍니다.

  • arg1가 지시하는 값이 arg2가 지시하는 값보다 크면 1.

  • arg1가 지시하는 값이 arg2가 지시하는 값보다 작으면 ―1.

  • arg1가 지시하는 값과 arg2가 지시하는 값이 같으면 0.

deccopy

10 진수값을 복사합니다. 

void deccopy(decimal *src, decimal *target);

이 함수는, 첫 번째 인자로서 복사된 10 진수값(src)의 포인터, 두 번째 인자로서 10 진수형의 대상 구조(target)의 포인터를 받아들입니다.

deccvasc

ASCII 표현으로부터 10 진수형에 값을 변환합니다. 

int deccvasc(char *cp, int len, decimal *np);

이 함수는, 변환 대상의 문자열 표현을 가지는 캐릭터 라인(cp)의 포인터와 그 문자열의 길이len를 받아들입니다. np는 이 조작 결과를 저장하는 10 진수형의 값의 포인터입니다.

유효한 서식의 예는 이하와 같습니다. -2, . 794, +3. 44, 592.49E07, -32. 84e-4.

이 함수는 성공시 0을 돌려줍니다. 오버플로우나 언더 플로우(underflow)가 발생했을 경우는 ECPG_INFORMIX_NUM_OVERFLOW나 ECPG_INFORMIX_NUM_UNDERFLOW가 돌려주어집니다. ASCII 표현의 해석을 할 수 없었던 경우는 ECPG_INFORMIX_BAD_NUMERIC가, 지수 부분의 해석에 문제가 있는 경우는 ECPG_INFORMIX_BAD_EXPONENT가 돌려주어집니다.

deccvdbl

double형의 값을 10 진수형의 값으로 변환합니다. 

int deccvdbl(double dbl, decimal *np);

이 함수는, 첫 번째 인자로서 변환 대상의 double형의 변수(dbl)를 받아들입니다. 두 번째 인자(np)로서 이 함수는 조작 결과를 저장하는 10 진수형 변수에의 포인터를 받아들입니다.

이 함수는 성공시에 0을 돌려줍니다. 변환이 실패했을 경우는 부의 값이 돌아갑니다.

deccvint

int형의 값을 10 진수형의 값으로 변환합니다. 

int deccvint(int in, decimal *np);

이 함수는 첫 번째 인자로서 변환 대상의 int형 변수(in)를 받아들입니다. 두 번째의 인자(np)로서 이 함수는 변환 결과를 저장하는 10 진수형 변수에의 포인터를 받아들입니다.

이 함수는 성공시에 0을 돌려줍니다. 변환이 실패했을 경우는 부의 값이 돌아갑니다.

deccvlong

long형의 값을 10 진수형의 값으로 변환합니다. 

int deccvlong(long lng, decimal *np);

이 함수는 첫번째 인자로서 변환 대상의 long형 변수(lng)를 받아들입니다. 두 번째 인자(np)로서 이 함수는 변환 결과를 저장하는 10 진수형 변수에의 포인터를 받아들입니다.

이 함수는 성공시에 0을 돌려줍니다. 변환이 실패했을 경우는 부의 값이 돌아갑니다.

decdiv

2개의 10 진수형 변수의 나눗셈을 실시합니다. 

int decdiv(decimal *n1, decimal *n2, decimal *result);

이 함수는, 1번째의 연산 항목(n1)과 2번째의 연산 항목(n2)이 되는 변수의 포인터를 받아들여 n1/n2를 계산합니다. result는, 조작 결과를 저장하는 변수에의 포인터입니다.

성공시 0이 돌려주어져 나눗셈의 실패시에는 부의 값이 돌려주어집니다. 오버플로우나 언더 플로우(underflow)가 발생했을 경우, 이 함수는 각각 ECPG_INFORMIX_NUM_OVERFLOW, ECPG_INFORMIX_NUM_UNDERFLOW를 돌려줍니다. 0 나누기가 발생했을 경우는, ECPG_INFORMIX_DIVIDE_ZERO가 돌려주어집니다.

decmul

2개의 10 진수형 변수를 곱셈합니다. 

int decmul(decimal *n1, decimal *n2, decimal *result);

이 함수는, 1번째의 연산 항목(n1)과 2번째의 연산 항목(n2)이 되는 변수의 포인터를 받아들여 n1*n2를 계산합니다. result는, 조작 결과를 저장하는 변수에의 포인터입니다.

성공시 0이 돌려주어져 나눗셈의 실패시에는 부의 값이 돌려주어집니다. 오버플로우나 언더 플로우(underflow)가 발생했을 경우, 이 함수는 각각 ECPG_INFORMIX_NUM_OVERFLOW, ECPG_INFORMIX_NUM_UNDERFLOW를 돌려줍니다.

decsub

10 진수형값끼리의 감산을 실시합니다. 

int decsub(decimal *n1, decimal *n2, decimal *result);

이 함수는, 1번째의 연산 항목(n1)과 2번째의 연산 항목(n2)이 되는 변수의 포인터를 받아들여 n1-n2를 계산합니다. result는, 조작 결과를 저장하는 변수에의 포인터입니다.

성공시 0이 돌려주어져 제산의 실패시에는 부의 값이 돌려주어집니다. 오버플로우나 언더 플로우(underflow)가 발생했을 경우, 이 함수는 각각 ECPG_INFORMIX_NUM_OVERFLOW, ECPG_INFORMIX_NUM_UNDERFLOW를 돌려줍니다.

dectoasc

10 진수형 변수를 C char* 문자열의 ASCII 표현으로 변환합니다. 

int dectoasc(decimal *np, char *cp, int len, int right)

이 함수는 10 진수형 변수(np)의 포인터를 받아들여 텍스트 표현으로 변환합니다. cp 는 변환 결과를 저장하기 위한 버퍼입니다. right매개변수는, 10 진수 소수점의 우측의 몇 자리수를 출력하는지를 지정합니다. 결과는 이 10진자리수로 할 수 있습니다. right를 ―1으로 하는 것으로, 모든 유효한 자리수가 출력되게 됩니다. len로 가리키는 출력 버퍼장이, 마지막 NUL 문자를 포함한 텍스트 표현을 저장하는데는 불충분할 경우, 결과에는 *이라는 1 문자가 저장되어 -1가 돌려주어집니다.

이 함수는, cp버퍼가 너무 작은 경우에 ―1을 돌려줍니다. 메모리 부족의 경우는 ECPG_INFORMIX_OUT_OF_MEMORY를 돌려줍니다.

dectodbl

10 진수형 변수를 double로 변환합니다. 

int dectodbl(decimal *np, double *dblp);

이 함수는 변환 대상의 10 진수형 변수(np)의 포인터와 처리 결과를 저장하는 double 변수(dblp)에의 포인터를 받아들입니다.

성공시 0이, 변환 실패시 부의 값이 돌려주어집니다.

dectoint

10 진수형 변수를 정수형으로 변환합니다. 

int dectoint(decimal *np, int *ip);

이 함수는 변환 대상의 10 진수형 변수(np)의 포인터와 처리 결과를 저장하는 정수형 변수(lp)에의 포인터를 받아들입니다.

성공시 0이, 변환 실패시 부의 값이 돌려주어집니다. 오버플로우가 발생했을 경우는 ECPG_INFORMIX_NUM_OVERFLOW가 돌려주어집니다.

이 ecpg의 구현은 Informix의 구현과 다른 것에 주의해 주세요. Informix에서는, 정수 범위에 ―32767에서 32767까지라는 제한을 하고 있습니다만, ecpg에서의 제한은 아키텍쳐에 의존(-INT_MAX .. INT_MAX)합니다.

dectolong

10 진수형 변수를 long형으로 변환합니다. 

int dectolong(decimal *np, long *lngp);

이 함수는 변환 대상의 10 진수형 변수(np)의 포인터와 처리 결과를 저장하는 long 변수(lngp)에의 포인터를 받아들입니다.

성공시 0이, 변환 실패시 부의 값이 돌려주어집니다. 오버플로우가 발생했을 경우는 ECPG_INFORMIX_NUM_OVERFLOW가 돌려주어집니다.

이 ecpg의 구현은 Informix의 구현과 다른 것에 주의해 주세요. Informix에서는, 정수 범위에 ―2,147,483,647에서 2,147,483,647까지라는 제한을 하고 있습니다만, ecpg에서의 제한은 아키텍쳐에 의존(-LONG_MAX .. LONG_MAX)합니다.

rdatestr

일자를 C char*문자열로 변환합니다. 

int rdatestr(date d, char *str);

이 함수는 2개의 인자를 받아들입니다. 첫 번째 인자는 변환 대상의 일자 (d), 두 번째는 변환 후의 문자열의 포인터입니다. 출력 서식은 항상 yyyy-mm-dd이므로, 적어도 11 문자(눌 종단을 포함한다)를 결과 문자열에 할당하지 않으면 안됩니다.

이 함수는 성공시 0을, 에러시 부의 값을 돌려줍니다.

이 ecpg의 구현은 Informix의 구현과 다른 것에 주의해 주세요. Informix에서는, 환경 변수에 의해 서식을 변경할 수 있습니다만, ecpg에서는 출력 서식을 변경할 수 없습니다.

rstrdate

일자의 텍스트 표현을 해석합니다. 

int rstrdate(char *str, date *d);

이 함수는, 변환 대상의 일자의 텍스트 표현(str)과 일자형 변수의 포인터(d)를 받아들입니다. 이 함수에서는 서식 마스크를 지정할 수 없습니다. Informix의 기본값의 서식 마스크인 mm/dd/yyyy를 사용합니다. 내부적으로는, 이 함수는 rdefmtdate를 사용해 구현하고 있습니다. 따라서, rstrdate는 빠르지는 않습니다. 만약 선택사항이 있다면, 서식 마스크를 명시적으로 지정할 수 있는 rdefmtdate를 선택해야 합니다.

이 함수는rdefmtdate와 같은 값을 돌려줍니다.

rtoday

현재의 일자를 입수합니다. 

void rtoday(date *d);

이 함수는 일자형 변수d)에의 포인터를 받아들여 그 곳에 현재의 일자를 저장합니다.

내부적으로는, 이 함수는 PGTYPESdate_today 함수를 사용합니다.

rjulmdy

일자형 변수로부터, 일, 월, 년의 값을 꺼냅니다. 

int rjulmdy(date d, short mdy[3]);

이 함수는 일자d, 3개의 short integer형 값이 되는 배열mdy을 받아들입니다. 이 변수명은 그 순차적 순서을 나타내, mdy[0]에는 월수, mdy[1]에는 날짜가, mdy[2]에는 년이 설정됩니다.

현재 이 함수는 항상 0을 돌려줍니다.

내부적으로는 이 함수는 PGTYPESdate_julmdy 함수를 사용합니다.

rdefmtdate

서식 마스크를 사용해, 문자열을 일자형의 값으로 변환합니다. 

int rdefmtdate(date *d, char *fmt, char *str);

이 함수는, 처리 결과를 저장하기 위한 일자형에의 포인터(d), 일자를 해석하기 위한 서식 마스크(fmt), 일자의 텍스트 표현을 포함한 C의 char*문자열(str)을 받아들입니다. 텍스트 표현은 서식 마스크에 맞은 표현인 것이 가정되고 있습니다. 그러나, 문자열과 서식 마스크를 1:1에 대응시킬 필요는 없습니다. 이 함수는 순차적 차례로 해석해, 년의 위치를 나타내는 yy 또는 yyyy를, 월의 위치를 나타내는 mm를, 날의 위치를 나타내는 dd를 검색합니다.

이 함수는 이하의 값을 돌려줍니다.

  • 0 - 함수가 정상적으로 애통 했습니다.

  • ECPG_INFORMIX_ENOSHORTDATE - 일자에, 일, 월, 년을 단락짓는 문자가 없었습니다. 이 경우, 입력 문자열은 6바이트, 8바이트의 하나여야 하지만, 그렇지 않았습니다.

  • ECPG_INFORMIX_ENOTDMY - 서식 문자열이 올바르고, 연월일의 차례를 나타내고 있지 않습니다.

  • ECPG_INFORMIX_BAD_DAY - 입력 문자열에 유효한 날이 포함되어 있지 않습니다.

  • ECPG_INFORMIX_BAD_MONTH - 입력 문자열에 유효한 달이 포함되어 있지 않습니다.

  • ECPG_INFORMIX_BAD_YEAR - 입력 문자열에 유효한 년이 포함되어 있지 않습니다.

내부적으로는, 이 함수는 xref linkend="PGTYPESdatedefmtasc">함수를 사용해 구현하고 있습니다. 이 함수의 설명에는, 입력 예의 표가 있기 때문에, 이쪽도 참조해 주세요.

rfmtdate

서식 마스크를 사용해 일자형 변수를 텍스트 표현으로 변환합니다. 

int rfmtdate(date d, char *fmt, char *str);

이 함수는 변환 대상의 일자(d), 서식 마스크(fmt), 일자의 텍스트 표현을 저장하는 문자열(str)을 받아들입니다.

성공시 0, 에러가 발생했을 경우는 부의 값이 돌려주어집니다.

내부적으로는 이 함수는 PGTYPESdate_fmt_asc 함수를 사용합니다. 예가 기재되어 있기 때문에, 이쪽도 참조해 주세요.

rmdyjul

일자의 일, 월, 년을 나타내는 3개의 short integers형의 배열로부터 일자형의 값을 작성합니다. 

int rmdyjul(short mdy[3], date *d);

이 함수는 3개의 short integers형으로부터 되는 배열(mdy)과 처리 결과를 저장하는 일자형 변수에의 포인터를 받아들입니다.

현재 이 함수는 항상 0을 돌려줍니다.

내부적으로는 이 함수는 PGTYPESdate_mdyjul 함수를 사용해 구현하고 있습니다.

rdayofweek

일자형의 값의 주내 날짜를 나타내는 값을 돌려줍니다. 

int rdayofweek(date d);

이 함수는 일자형 변수d를 그 유일한 인자로서 받아들여, 그 일자의 주내 날짜를 나타내는 정수를 돌려줍니다. this date.

  • 0 - 일요일

  • 1 - 월요일

  • 2 - 화요일

  • 3 - 수요일

  • 4 - 목요일

  • 5 - 금요일

  • 6 - 토요일

내부적으로는 이 함수는 PGTYPESdate_dayofweek 함수를 사용해 구현하고 있습니다.

dtcurrent

현재의 타임스템프를 불러옵니다. 

void dtcurrent(timestamp *ts);

이 함수는 현재의 타임스템프를 받아, ts가 지시하는 타임스템프형 변수에 저장합니다.

dtcvasc

ANSI 표준으로 기재된 텍스트 표현을 타임스템프형 변수로 변환합니다. 

int dtcvasc(char *str, timestamp *ts);

이 함수는 대상의 문자열(str)과 처리 결과를 저장하는 타임스템프형 변수(ts)에의 포인터를 받아들입니다.

이 함수는 성공시 0을 돌려주어, 에러시 부의 값을 돌려줍니다.

내부적으로는 이 함수는 PGTYPEStimestamp_from_asc 함수를 사용합니다. 입력 예의 표가 있기 때문에, 이쪽도 참조해 주세요.

dtcvfmtasc

서식 마스크를 사용해 ANSI 표준으로 기재된 텍스트 표현을 타임스템프형 변수로 변환합니다. 

dtcvfmtasc(char *inbuf, char *fmtstr, timestamp *dtvalue)

이 함수는, 대상으로 하는 문자열(inbuf), 사용하는 서식 마스크(fmtstr), 처리 결과를 저장하는 타임스템프 변수(ts)에의 포인터를 받아들입니다.

이 함수는 PGTYPEStimestamp_defmt_asc 을 사용해 구현되고 있습니다. 사용 가능한 서식 지정의 리스트가 있기 때문에, 이쪽도 참조해 주세요.

이 함수는 성공시에 0을, 에러시 부의 값을 돌려줍니다.

dtsub

타임스템프형끼리 감산을 실시해, 시간 간격형 변수(interval)를 돌려줍니다. 

int dtsub(timestamp *ts1, timestamp *ts2, interval *iv);

타임템프형끼리 감산을 실시해, 시간 간격형 변수를 돌려줍니다.

성공시 이 함수는 0을 돌려주어, 에러시 부의 값을 돌려줍니다.

dttoasc

타임 스탬프형 변수를 C char*문자열로 변환합니다. 

int dttoasc(timestamp *ts, char *output);

이 함수는 대상의 타임 스탬프형 변수(ts)에의 포인터, 처리 결과를 저장하는 문자열(output)을 받아들입니다. 이것은 ts를 ANSI 표준 SQL에 따르는 텍스트 표현(YYYY-MM-DD HH:MM:SS로서 정의)으로 변환합니다.

성공시 이 함수는 0을 돌려주어, 에러시 부의 값을 돌려줍니다.

dttofmtasc

서식 마스크를 사용해 타임스템프형 변수를 C char*로 변환합니다. 

int dttofmtasc(timestamp *ts, char *output, int str_len, char *fmtstr);

이 함수는, 첫 번째 인자로서 변환 대상의 타임스템프(ts)를, 출력 버퍼의 포인터(output), 출력 버퍼로 할당 가능한 최대길이 (str_len), 변환에 사용하는 서식 마스크(fmtstr)를 받아들입니다.

성공시 이 함수는 0을 돌려줍니다. 에러가 발생했을 경우는 부의 값을 돌려줍니다.

내부적으로, 이 함수는 PGTYPEStimestamp_fmt_asc 함수를 사용합니다. 사용할 수 있는 서식 마스크에 관한 정보가 있기 때문에, 이쪽도 참조해 주세요.

intoasc

시간 간격형 변수를 C char*문자열로 변환합니다. 

int intoasc(interval *i, char *str);

이 함수는, 변환 대상의 시간 간격형 변수(i)에의 포인터, 처리 결과를 저장하는 문자열(str)을 받아들입니다. 이것은 i를 ANSI 표준 SQL에서의 텍스트 표현(YYYY-MM-DD HH:MM:SS로서 정의)으로 변환합니다.

성공시, 이 함수는 0을 돌려줍니다. 에러가 발생했을 경우는 부의 값을 돌려줍니다.

rfmtlong

long integer값을 서식 마스크를 사용해 텍스트 표현으로 변환합니다. 

int rfmtlong(long lng_val, char *fmt, char *outbuf);

이 함수는, long형의 값 lng_val, 서식 마스크fmt, 출력 버퍼outbuf에의 포인터를 받아들입니다. 이것은 long형의 값을 서식 마스크에 따라 텍스트 표현으로 변환합니다.

서식 마스크는 이하의 서식 지정 문자를 조합할 수 있습니다.

  • * (asterisk) - 이 정도의 값이 공백이라면 asterisk로 묻습니다.

  • & (ampersand(&)) - 이 정도의 값이 공백이라면 0으로 묻습니다.

  • # - 선두의 0를 공백으로 변환합니다.

  • < - 문자열 내에서 수치를 왼쪽으로 맞춥니다.

  • , (콤마) - 4자리수 이상의 수치를 콤마로 단락지은 3자리수에 그룹화 합니다.

  • . (마침표) - 이 문자는 수치로부터 소수 부분을 구별합니다.

  • - (마이너스) - 수치가 부의 경우, 마이너스 기호를 붙입니다.

  • + (플러스) - 수치가 정의 경우 플러스 기호를 붙입니다.

  • ( - 이것은 부의 값의 선두의 마이너스 기호를 옮겨놓습니다. 마이너스 기호는 나타나지 않습니다.

  • ) - 이 문자는 마이너스 기호를 옮겨놓고 부의 값의 마지막에 출력합니다.

  • $ - 통화 기호

rupshift

문자열을 대문자로 변환합니다. 

void rupshift(char *str);

이 함수는 문자열에의 포인터를 받아들여 모든 소문자를 대문자로 변환합니다.

byleng

문자열 내의 문자수를 돌려줍니다. 다만, 말미의 공백은 세지 않습니다. 

int byleng(char *str, int len);

이 함수는 첫 번째 인자로서 고정 길이의 문자열(str)을, 두 번째 인자로서 그 문자열 길이 (len)를 상정하고 있습니다. 이것은, 문자열로부터 말미의 공백을 없앤, 유효 문자의 수를 돌려줍니다.

ldchar

고정 길이의 문자열을 NULL 종단의 문자열에 복사합니다. 

void ldchar(char *src, int len, char *dest);

이 함수는 복사 대상의 고정 길이의 문자열(src), 문자열 길이(len), 저장소 메모리(dest)에의 포인터를 받아들입니다. dest가 지시하는 문자열에는 적어도 len+1바이트를 할당하지 않으면 안 되는 점에 주의해 주세요. 이 함수는 많게는 len바이트를 새로운 장소에 복사합니다. (소스 문자열이 말미에 공백 문자를 가지는 경우는 적어집니다다.) 그리고, NULL 종단을 부여합니다.

rgetmsg 

int rgetmsg(int msgnum, char *s, int maxsize);

이 함수는 존재합니다만, 현재 구현되고 있지 않습니다.

rtypalign 

int rtypalign(int offset, int type);

이 함수는 존재합니다만, 현재 구현되고 있지 않습니다.

rtypmsize 

int rtypmsize(int type, int len);

이 함수는 존재합니다만, 현재 구현되고 있지 않습니다.

rtypwidth 

int rtypwidth(int sqltype, int sqllen);

이 함수는 존재합니다만, 현재 구현되고 있지 않습니다.

rsetnull

변수에 NULL를 설정합니다. 

int rsetnull(int t, char *ptr);

이 함수는, 변수의 종류를 나타내는 정수와 C char*에 캐스트 한 변수 자체에의 포인터를 받아들입니다.

이하의 종류가 존재합니다.

  • CCHARTYPE - char 또는 char*형의 변수용

  • CSHORTTYPE - short int형의 변수용

  • CINTTYPE - int형의 변수용

  • CBOOLTYPE - boolean형의 변수용

  • CFLOATTYPE - float형의 변수용

  • CLONGTYPE - long형의 변수용

  • CDOUBLETYPE - double형의 변수용

  • CDECIMALTYPE - decimal형의 변수용

  • CDATETYPE - date형의 변수용

  • CDTIMETYPE - timestamp형의 변수용

이하에 이 함수의 호출 예를 나타냅니다. 

$char c[] = "abc       ";
$short s = 17;
$int i = -74874;

rsetnull(CCHARTYPE, (char *) c);
rsetnull(CSHORTTYPE, (char *) &s);
rsetnull(CINTTYPE, (char *) &i);

risnull

변수가 NULL인지 검사합니다. 

int risnull(int t, char *ptr);

이 함수는 검사하는 변수의 종류(t), 변수(ptr)에의 포인터를 접수합니다. 후자는 char*에 캐스트 할 필요가 있는 것에 주의해 주세요. 취할 수 있는 변수 종류에 대해서는 rsetnull 함수를 참조해 주세요.

이 함수의 사용 방법의 예를 나타냅니다. 

$char c[] = "abc       ";
$short s = 17;
$int i = -74874;

risnull(CCHARTYPE, (char *) c);
risnull(CSHORTTYPE, (char *) &s);
risnull(CINTTYPE, (char *) &i);

31.9.3. 추가의 정수

여기서 가리키는 정수는 모두 에러를 나타내는 것이어, 부의 값을 나타내도록 정의되고 있는 것에 주의해 주세요. 또, 다른 정수의 설명에서는, 현재의 구현으로 정수가 나타내는 수치를 알 수 있습니다. 그러나, 이 수치에 의존하지 않습니다. 그러나, 이러한 모든 것이 부의 값인 것에 의존하는 것은 가능합니다.

ECPG_INFORMIX_NUM_OVERFLOW

계산시에 오버플로우가 발생했을 경우, 함수는 이 값을 돌려줍니다. 내부적으로는 ―1200(Informix의 정의)으로 정의되고 있습니다.

ECPG_INFORMIX_NUM_UNDERFLOW

계산시에 언더 플로우(underflow)가 발생했을 경우, 함수는 이 값을 돌려줍니다. 내부적으로는 ―1201(Informix의 정의)으로 정의되고 있습니다.

ECPG_INFORMIX_DIVIDE_ZERO

계산시에 0 나누기가 발생했을 경우, 함수는 이 값을 돌려줍니다. 내부적으로는 ―1202(Informix의 정의)로 정의되고 있습니다.

ECPG_INFORMIX_BAD_YEAR

일자의 해석시에 년의 값이 부정할 경우, 함수는 이 값을 돌려줍니다. 내부적으로는 ―1204(Informix의 정의)로 정의되고 있습니다.

ECPG_INFORMIX_BAD_MONTH

일자의 해석시에 월의 값이 부정할 경우, 함수는 이 값을 돌려줍니다. 내부적으로는 ―1205(Informix의 정의)로 정의되고 있습니다.

ECPG_INFORMIX_BAD_DAY

일자의 해석시에 날의 값이 부정할 경우, 함수는 이 값을 돌려줍니다. 내부적으로는 ―1206(Informix의 정의)으로 정의되고 있습니다.

ECPG_INFORMIX_ENOSHORTDATE

해석 처리가 단축 일자 표현을 필요하게 하고 있지만, 올바른 길이의 일자 문자열을 얻을 수 없었던 경우, 함수는 이 값을 돌려줍니다. 내부적으로는 ―1209(Informix의 정의)로 정의되고 있습니다.

ECPG_INFORMIX_DATE_CONVERT

함수는 이 값을 돌려줍니다. 내부적으로는 ―1210(Informix의 정의)으로 정의되고 있습니다.

ECPG_INFORMIX_OUT_OF_MEMORY

함수는 이 값을 돌려줍니다. 내부적으로는 ―1211(Informix의 정의)으로 정의되고 있습니다.

ECPG_INFORMIX_ENOTDMY

해석 처리는 서식 마스크(mmddyy와 같은)가 존재하는 것을 전제로 하고 있지만, 모든 필드가 올바르게 열거되어 있지 않은 경우, 함수는 이 값을 돌려줍니다. 내부적으로는 ―1212(Informix의 정의)로 정의되고 있습니다.

ECPG_INFORMIX_BAD_NUMERIC

해석 처리가 에러이기 때문에, 수치의 텍스트 표현을 해석할 수 없었던 경우나, 수치 변수의 적어도 1개가 무효이기 때문에 수치 변수를 사용한 계산을 완료할 수 없었던 경우, 함수는 이 값을 돌려줍니다. 내부적으로는 ―1213(Informix의 정의)으로 정의되고 있습니다.

ECPG_INFORMIX_BAD_EXPONENT

함수는 이 값을 돌려줍니다. 내부적으로는 ―1216(Informix의 정의)으로 정의되고 있습니다.

ECPG_INFORMIX_BAD_DATE

함수는 이 값을 돌려줍니다. 내부적으로는 ―1218(Informix의 정의)으로 정의되고 있습니다.

ECPG_INFORMIX_EXTRA_CHARS

함수는 이 값을 돌려줍니다. 내부적으로는 ―1264(Informix의 정의)로 정의되고 있습니다.

Prev Home Next
pgtypes 라이브러리 Up SQL 기술어 영역의 사용