Книга: Linux программирование в примерах

13.2.4. Числовое и денежное низкоуровневое форматирование: localeconv()

13.2.4. Числовое и денежное низкоуровневое форматирование: localeconv()

Корректное форматирование числовых и денежных значений требует значительной низкоуровневой информации. Указанная информация доступна в struct lconv, которую получают с помощью функции localeconv():

#include <locale.h> /* ISO С */
struct lconv *localeconv(void);

Подобно функции ctime(), эта функция возвращает указатель на внутренние статические данные. Следует сделать копию возвращенных данных, поскольку последующие вызовы могут возвратить другие значения, если локаль изменилась. Вот struct lconv (слегка сжатая), непосредственно из GLIBC <locale.h>:

struct lconv {
 /* Числовая (не денежная) информация. */
 char *decimal_point; /* Разделитель десятичной дроби. */
 char *thousands_sep; /* Разделитель тысяч. */
 /* Каждый элемент является числом цифр в каждой группе;
    элементы с большими индексами оставлены дальше. Элемент со
    значением CHAR_MAX означает, что дальнейшая группировка не
    производится. Элемент со значением 0 означает, что предыдущий
    элемент используется для всех оставшихся групп. */
 char *grouping;
 /* Денежная информация. */
 /* Первые три символа являются символами валют из ISO 4217.
    Четвертый символ является разделителем. Пятый символ ''. */
 char *int_curr_symbol;
 char *currency_symbol; /* Символ местной валюты. */
 char *mon_decimal_point; /* Символ десятичной точки. */
 char *mon_thousands_sep; /* Разделитель тысяч. */
 char *mon_grouping; /* Аналогично элементу 'группировки' (выше). */
 char *positive_sign; /* Знак для положительных значений. */
 char *negative_sign; /* Знак для отрицательных значений. */
 char int_frac_digits; /* Международные цифры дробей. */
 char frac_digits; /* Местные цифры дробей. */
 /* 1, если символ валюты перед положит, значением, 0, если после. */
 char p_cs_precedes;
 /* 1, если символ валюты отделяется от положит, значения пробелом. */
 char p_sep_by_space;
 /* 1, если символ валюты перед отриц. значением, 0, если после. */
 char n_cs_precedes;
 /* 1, если символ валюты отделяется от отриц. значения пробелом. */
 char n_sep_by_space;
 /* Размещение положительного и отрицательного знака:
    0 Количество и символ валюты окружены скобками.
    1 Строка знака перед количеством и символом валюты.
    2 Строка знака за количеством и символом валюты.
    3 Строка знака непосредственно перед символом валюты.
    4 Строка знака непосредственно после символа валюты. */
 char p_sign_posn;
 char n_sign_posn;
 /* 1, если int_curr_symbol до положит. значения, 0, если после. */
 char int_p_cs_precedes;
 /* 1, если int_curr_symbol отделен от положит, знач. пробелом. */
 char int_p_sep_by_space;
 /* 1, если int_curr_symbol перед отриц. значением, 0, если после. */
 char int_n_cs_precedes;
 /* 1, если int_curr_symbol отделен от отриц. знач. пробелом. */
 char int_n_sep_by_space;
 /* Размещение положительного и отрицательного знака:
    0 Количество и int_curr_symbol окружены скобками.
    1 Строка знака до количества и int_curr_symbol.
    2 Строка знака после количества и int_curr_symbol.
    3 Строка знака непосредственно до int_curr_symbol.
    4 Строка знака непосредственно после int_curr_symbol. */
 char int_p_sign_posn;
 char int_n_sign_posn;
};

Комментарии показывают довольно ясно, что происходит. Давайте посмотрим на несколько первых полей struct lconv:

decimal_point

Используемый символ разделителя десятичной дроби. В Соединенных Штатах и других англоязычных странах это точка, но во многих странах используется запятая.

thousands_sep

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

grouping

Массив однобайтных целых значений. Каждый элемент указывает, сколько цифр в группе. Как сказано в комментарии, CHAR_MAX означает, что дальше группировка не используется, а 0 означает повторное использование последнего элемента (Далее в главе мы покажем пример кода.)

int_curr_symbol

Это международный символ для местной валюты. Например, 'USD' для доллара США.

currency_symbol

Локальный символ для местной валюты. Например, $ для доллара США.

mon_decimal_point, mon_thousands_sep, mon_grouping

Соответствуют предыдущим полям, предоставляя те же сведения, но для денежных сумм.

Большая часть оставшихся значений не имеет значения для повседневного программирования. Следующая программа, ch13-lconv.c, выводит некоторые из этих значений, чтобы дать вам представление, для какого рода сведений они используются:

/* ch13-lconv.c --- показывает некоторые компоненты struct lconv */
#include <stdio.h>
#include <limits.h>
#include <locale.h>
int main(void) {
 struct lconv l;
 int i;
 setlocale(LC_ALL, "");
 l = *localeconv();
 printf("decimal_point = [%s]n", l.decimal_point);
 printf("thousands_sep = [%s]n", l.thousands_sep);
 for (i = 0; l.grouping[i] != 0 && l.grouping[i] != CHAR_MAX; i++)
  printf("grouping[%d] = [%djn", i, l.grouping[i]);
 printf("int_curr_symbol = [%s]n", l.int_curr_symbol);
 printf("currency_symbol = f%s]n", l.currency_symbol);
 printf("mon_decimal_point = f%s]n", l.mon_decimal_point);
 printf("mon_thousands_sep = [%s]n", l.mon_thousands_sep);
 printf("positive_sign = [%s]n", l.positive_sign);
 printf("negative_sign = [%s]n", l.negative_sign);
}

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

$ LC_ALL=en_US ch13-lconv /* Результаты для Соединенных Штатов */
decimal_point = [.]
thousands_sep = [,]
grouping[0] = [3]
grouping[1] = [3]
int_curr_symbol = [USD ]
currency_symbol = [$]
mon_decimal_point = [.]
mon_thousands_sep = [,]
positive_sign = []
negative_sign = [-]
$ LC_ALL=it_IT ch13-lconv /* Результаты для Италии */
decimal_point = [.]
thousands_sep = []
int_curr_symbol = []
currency_symbol = []
mon_decimal_point = []
mon_thousands_sep = []
positive_sign = []
negative_sign = []

Обратите внимание, что значение int_curr_symbol в локали "en_US" включает завершающий символ пробела, который служит для отделения символа от последующего денежного значения.

Оглавление книги