Запросите указатель на новую выделенную числовую переменную.

numeric *PGTYPESnumeric_new(void);

Освобождает числовой тип, освобождая всю его память.

void PGTYPESnumeric_free(numeric *var);

Разбор числового типа из его строковой нотации.

numeric *PGTYPESnumeric_from_asc(char *str, char **endptr);

Допустимыми форматами являются, например: -2, .794, +3.44, 592.49E07 или -32.84e-4. Если значение может быть успешно разобрано, возвращается действительный указатель, в противном случае - указатель NULL. В настоящее время ECPG всегда разбирает полную строку, поэтому в настоящее время не поддерживается возможность сохранения адреса первого недопустимого символа в *endptr. Вы можете безопасно установить endptr в NULL.

Возвращает указатель на строку, выделенную с помощью функции malloc, которая содержит строковое представление числового типа num.

char *PGTYPESnumeric_to_asc(numeric *num, int dscale);

Числовое значение будет выведено с dscale десятичными цифрами, с применением округления при необходимости. Результат должен быть освобожден с помощью PGTYPESchar_free().

Добавьте две числовые переменные в третью.

int PGTYPESnumeric_add(numeric *var1, numeric *var2, numeric *result);

Функция добавляет переменные var1 и var2 в переменную результата result. Функция возвращает 0 в случае успеха и -1 в случае ошибки.

Вычтите две числовые переменные и верните результат в третьей переменной.

int PGTYPESnumeric_sub(numeric *var1, numeric *var2, numeric *result);

Функция вычитает переменную var2 из переменной var1. Результат операции сохраняется в переменной result. Функция возвращает 0 в случае успеха и -1 в случае ошибки.

Умножьте две числовые переменные и верните результат в третьей переменной.

int PGTYPESnumeric_mul(numeric *var1, numeric *var2, numeric *result);

Функция умножает переменные var1 и var2. Результат операции сохраняется в переменной result. Функция возвращает 0 в случае успеха и -1 в случае ошибки.

Разделите две числовые переменные и верните результат в третью переменную.

int PGTYPESnumeric_div(numeric *var1, numeric *var2, numeric *result);

Функция делит переменные var1 на var2. Результат операции сохраняется в переменной result. Функция возвращает 0 в случае успеха и -1 в случае ошибки.

Сравните две числовые переменные.

int PGTYPESnumeric_cmp(numeric *var1, numeric *var2)

Эта функция сравнивает две числовые переменные. В случае ошибки возвращается значение INT_MAX. В случае успеха функция возвращает один из трех возможных результатов:

Преобразование переменной типа int в переменную типа numeric.

int PGTYPESnumeric_from_int(signed int int_val, numeric *var);

Эта функция принимает переменную типа signed int и сохраняет ее в числовой переменной var. В случае успешного выполнения возвращается 0, а в случае ошибки -1.

Преобразование переменной типа long int в переменную типа numeric.

int PGTYPESnumeric_from_long(signed long int long_val, numeric *var);

Эта функция принимает переменную типа signed long int и сохраняет ее в числовой переменной var. В случае успешного выполнения возвращается 0, а в случае ошибки -1.

Скопировать одну числовую переменную в другую.

int PGTYPESnumeric_copy(numeric *src, numeric *dst);

Эта функция копирует значение переменной, на которую указывает src, в переменную, на которую указывает dst. Она возвращает 0 в случае успеха и -1, если произошла ошибка.

Преобразование переменной типа double в числовой тип.

int  PGTYPESnumeric_from_double(double d, numeric *dst);

Эта функция принимает переменную типа double и сохраняет результат в переменной, на которую указывает dst. Она возвращает 0 в случае успеха и -1, если произошла ошибка.

Преобразование переменной типа numeric в double.

int PGTYPESnumeric_to_double(numeric *nv, double *dp)

Функция преобразует числовое значение из переменной, на которую указывает nv, в переменную типа double, на которую указывает dp. Она возвращает 0 в случае успеха и -1, если произошла ошибка, включая переполнение. При переполнении значение глобальнаой переменной errno будет дополнительно установлено как PGTYPES_NUM_OVERFLOW.

Преобразование переменной типа numeric в int.

int PGTYPESnumeric_to_int(numeric *nv, int *ip);

Функция преобразует числовое значение из переменной, на которую указывает nv, в целочисленную переменную, на которую указывает ip. Она возвращает 0 в случае успеха и -1, если произошла ошибка, включая переполнение. При переполнении глобальная переменная errno будет установлена в значение PGTYPES_NUM_OVERFLOW дополнительно.

Преобразование переменной типа numeric в long.

int PGTYPESnumeric_to_long(numeric *nv, long *lp);

Функция преобразует числовое значение из переменной, на которую указывает nv, в переменную длинного целого числа, на которую указывает lp. Она возвращает 0 в случае успеха и -1, если произошла ошибка, включая переполнение. При переполнении глобальная переменная errno будет установлена в значение PGTYPES_NUM_OVERFLOW дополнительно.

Преобразование переменной типа numeric в decimal.

int PGTYPESnumeric_to_decimal(numeric *src, decimal *dst);

Функция преобразует числовое значение из переменной, на которую указывает src, в десятичную переменную, на которую указывает dst. Она возвращает 0 в случае успеха и -1, если произошла ошибка, включая переполнение. При переполнении глобальная переменная errno будет установлена в значение PGTYPES_NUM_OVERFLOW.

Преобразование переменной типа decimal в numeric.

int PGTYPESnumeric_from_decimal(decimal *src, numeric *dst);

Функция преобразует десятичное значение из переменной, на которую указывает src, в числовую переменную, на которую указывает dst. Она возвращает 0 в случае успеха и -1, если произошла ошибка. Поскольку тип decimal реализован как ограниченная версия типа numeric, переполнение при этом преобразовании невозможно.

Извлечение даты из временной метки.

date PGTYPESdate_from_timestamp(timestamp dt);

Функция принимает временную метку в качестве единственного аргумента и возвращает извлеченную дату из этой временной метки.

Разбор даты из ее текстового представления.

date PGTYPESdate_from_asc(char *str, char **endptr);

Функция принимает строку C char* str и указатель на строку C char* endptr. В настоящее время ECPG всегда разбирает полную строку, поэтому в настоящее время не поддерживается возможность сохранения адреса первого недопустимого символа в *endptr. Вы можете безопасно установить endptr в NULL.

Обратите внимание, что функция всегда предполагает даты в формате MDY, и в настоящее время нет переменной, чтобы изменить это в ECPG.

Таблица 33.2 показывает допустимые форматы ввода.

Вернуть текстовое представление переменной даты.

char *PGTYPESdate_to_asc(date dDate);

Функция принимает дату dDate в качестве единственного параметра. Она будет выводить дату в формате 1999-01-18, то есть в формате YYYY-MM-DD. Результат должен быть освобожден с помощью PGTYPESchar_free().

Извлеките значения для дня, месяца и года из переменной типа date.

void PGTYPESdate_julmdy(date d, int *mdy);

Функция получает дату d и указатель на массив из 3 целочисленных значений mdy. Имя переменной указывает на последовательный порядок: mdy[0] будет содержать номер месяца, mdy[1] будет содержать значение дня, а mdy[2] будет содержать год.

Создайте значение даты из массива из 3 целых чисел, которые указывают день, месяц и год даты.

void PGTYPESdate_mdyjul(int *mdy, date *jdate);

Функция принимает массив из 3 целых чисел (mdy) в качестве первого аргумента и указатель на переменную типа date в качестве второго аргумента, которая должна содержать результат операции.

Возвращает число, представляющее день недели для значения даты.

int PGTYPESdate_dayofweek(date d);

Функция принимает переменную даты d в качестве единственного аргумента и возвращает целое число, указывающее день недели для этой даты.

Получить текущую дату.

void PGTYPESdate_today(date *d);

Функция получает указатель на переменную типа дата (d), которую она устанавливает в текущую дату.

Преобразование переменной типа date в ее текстовое представление с использованием маски формата.

int PGTYPESdate_fmt_asc(date dDate, char *fmtstring, char *outbuf);

Функция получает дату для преобразования (dDate), маску формата (fmtstring) и строку, которая будет содержать текстовое представление даты (outbuf).

При успешном выполнении возвращается 0, а в случае ошибки - отрицательное значение.

Следующие литералы являются спецификаторами полей, которые вы можете использовать:

Все остальные символы копируются 1:1 в выходную строку.

Таблица 33.3 указывает на несколько возможных форматов. Это даст вам представление о том, как использовать эту функцию. Все строки вывода основаны на одной и той же дате: 23 ноября 1959 года.

Используйте маску формата для преобразования строки C char* в значение типа date.

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

Функция получает указатель на значение даты, которое должно содержать результат операции (d), маску формата для разбора даты (fmt) и строку C char*, содержащую текстовое представление даты (str). Ожидается, что текстовое представление будет соответствовать маске формата. Однако не требуется точное соответствие строки маске формата. Функция анализирует только последовательный порядок и ищет литералы yy или yyyy, указывающие на позицию года, mm для указания позиции месяца и dd для указания позиции дня.

Таблица 33.4 указывает на несколько возможных форматов. Это даст вам представление о том, как использовать эту функцию.

Разбор временной метки из ее текстового представления в переменную временной метки.

timestamp PGTYPEStimestamp_from_asc(char *str, char **endptr);

Функция получает строку для разбора (str) и указатель на C char* (endptr). В настоящее время ECPG всегда разбирает полную строку, поэтому в настоящее время невозможно сохранить адрес первого недопустимого символа в *endptr. Вы можете безопасно установить endptr в NULL.

Функция возвращает разобранную временную метку в случае успеха. В случае ошибки возвращается значение PGTYPESInvalidTimestamp, а errno устанавливается в PGTYPES_TS_BAD_TIMESTAMP. См. PGTYPESInvalidTimestamp для важных замечаний об этом значении.

Обычно, входная строка может содержать любую комбинацию допустимой спецификации даты, пробельного символа и допустимой спецификации времени. Обратите внимание, что часовые пояса не поддерживаются ECPG. Он может их разбирать, но не применяет никаких вычислений, как это делает сервер Tantor BE, например. Спецификаторы часовых поясов молча отбрасываются.

Таблица 33.5 содержит несколько примеров для входных строк.

Преобразует дату в строку типа C char*.

char *PGTYPEStimestamp_to_asc(timestamp tstamp);

Функция принимает временную метку tstamp в качестве единственного аргумента и возвращает выделенную строку, содержащую текстовое представление временной метки. Результат должен быть освобожден с помощью PGTYPESchar_free().

Получить текущую метку времени.

void PGTYPEStimestamp_current(timestamp *ts);

Функция извлекает текущую метку времени и сохраняет ее в переменную timestamp, на которую указывает ts.

Преобразование переменной временной метки в C char* с использованием маски формата.

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

Функция получает указатель на временную метку, которую нужно преобразовать, в качестве первого аргумента (ts), указатель на буфер вывода (output), максимальную длину, выделенную для буфера вывода (str_len), и маску формата, которую нужно использовать для преобразования (fmtstr).

При успешном выполнении функция возвращает 0, а при возникновении ошибки - отрицательное значение.

Вы можете использовать следующие спецификаторы формата для маски формата. Спецификаторы формата являются теми же, что используются в функции strftime в libc. Любой не являющийся спецификатором формата будет скопирован в выходной буфер.

Вычтите одну метку времени из другой и сохраните результат в переменной типа интервал.

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

Функция вычтет значение переменной типа timestamp, на которую указывает ts2, из значения переменной типа timestamp, на которую указывает ts1, и сохранит результат в переменной типа interval, на которую указывает iv.

При успешном выполнении функция возвращает 0, а при возникновении ошибки - отрицательное значение.

Разбор значения временной метки из его текстового представления с использованием маски форматирования.

int PGTYPEStimestamp_defmt_asc(char *str, char *fmt, timestamp *d);

Функция получает текстовое представление временной метки в переменной str, а также маску форматирования, которую нужно использовать в переменной fmt. Результат будет сохранен в переменной, на которую указывает d.

Если маска форматирования fmt равна NULL, функция будет использовать маску форматирования по умолчанию, которая равна %Y-%m-%d %H:%M:%S.

Это функция обратная функции PGTYPEStimestamp_fmt_asc. См. документацию там, чтобы узнать о возможных записях маски форматирования.

Добавить переменную интервала к переменной временной метки.

int PGTYPEStimestamp_add_interval(timestamp *tin, interval *span, timestamp *tout);

Функция получает указатель на переменную типа timestamp tin и указатель на переменную типа interval span. Она добавляет интервал к метке времени и сохраняет полученную метку времени в переменной, на которую указывает tout.

При успешном выполнении функция возвращает 0, а при возникновении ошибки - отрицательное значение.

Вычтите интервальную переменную из переменной типа timestamp.

int PGTYPEStimestamp_sub_interval(timestamp *tin, interval *span, timestamp *tout);

Функция вычитает интервальную переменную, на которую указывает span, из временной переменной, на которую указывает tin, и сохраняет результат в переменную, на которую указывает tout.

При успешном выполнении функция возвращает 0, а при возникновении ошибки - отрицательное значение.

Вернуть указатель на вновь выделенную переменную интервала.

interval *PGTYPESinterval_new(void);

Освободить память ранее выделенной переменной интервала.

void PGTYPESinterval_free(interval *intvl);

Разбор интервала из его текстового представления.

interval *PGTYPESinterval_from_asc(char *str, char **endptr);

Функция разбирает входную строку str и возвращает указатель на выделенную переменную интервала. В настоящее время ECPG всегда разбирает полную строку, поэтому в настоящее время не поддерживается возможность сохранения адреса первого недопустимого символа в *endptr. Вы можете безопасно установить endptr в NULL.

Преобразование переменной типа интервал в ее текстовое представление.

char *PGTYPESinterval_to_asc(interval *span);

Функция преобразует переменную интервала, на которую указывает span, в C char*. Результат выглядит таким образом: @ 1 day 12 hours 59 mins 10 secs. Результат должен быть освобожден с помощью PGTYPESchar_free().

Скопировать переменную типа интервал.

int PGTYPESinterval_copy(interval *intvlsrc, interval *intvldest);

Функция копирует переменную интервала, на которую указывает intvlsrc, в переменную, на которую указывает intvldest. Обратите внимание, что перед этим необходимо выделить память для переменной назначения.

Запросите указатель на вновь выделенную десятичную переменную.

decimal *PGTYPESdecimal_new(void);

Освободить десятичный тип, освободить всю его память.

void PGTYPESdecimal_free(decimal *var);

Аргумент должен содержать числовую переменную (или указывать на числовую переменную), но на самом деле его внутреннее представление в памяти было недействительным.

Произошло переполнение. Поскольку числовой тип может работать с практически произвольной точностью, преобразование числовой переменной в другие типы может вызвать переполнение.

Произошла потеря значимости. Поскольку числовой тип может работать с практически произвольной точностью, преобразование числовой переменной в другие типы может вызвать потерю значимости.

Попытка деления на ноль.

Была передана недопустимая строка даты в функцию PGTYPESdate_from_asc.

Были переданы неверные аргументы в функцию PGTYPESdate_defmt_asc.

Неверный компонент во входной строке был обнаружен функцией PGTYPESdate_defmt_asc.

Была передана недопустимая строка интервала в функцию PGTYPESinterval_from_asc, или было передано недопустимое значение интервала в функцию PGTYPESinterval_to_asc.

В функции PGTYPESdate_defmt_asc произошло несоответствие в присвоении дня/месяца/года.

Было обнаружено недопустимое значение дня месяца функцией PGTYPESdate_defmt_asc.

Было обнаружено недопустимое значение месяца функцией PGTYPESdate_defmt_asc.

Передана недопустимая строка временной метки в функцию PGTYPEStimestamp_from_asc, или передано недопустимое значение временной метки в функцию PGTYPEStimestamp_to_asc.

В контексте, который не может справиться с бесконечным значением временной метки, было обнаружено бесконечное значение временной метки.

Значение типа timestamp, представляющее недопустимую метку времени. Это возвращается функцией PGTYPEStimestamp_from_asc при ошибке разбора. Обратите внимание, что из-за внутреннего представления типа данных timestamp, PGTYPESInvalidTimestamp также является допустимой меткой времени одновременно. Она установлена в значение 1899-12-31 23:59:59. Чтобы обнаружить ошибки, убедитесь, что ваше приложение проверяет не только наличие PGTYPESInvalidTimestamp, но и errno != 0 после каждого вызова функции PGTYPEStimestamp_from_asc.