locale.h

简介

locale.h是程序的本地化设置，主要影响以下的行为。

  • 数字格式
  • 货币格式
  • 字符集
  • 日期和时间格式

它设置了以下几个宏。

  • LC_COLLATE：影响字符串比较函数strcoll()和strxfrm()。
  • LC_CTYPE：影响字符处理函数的行为。
  • LC_MONETARY：影响货币格式。
  • LC_NUMERIC：影响printf()的数字格式。
  • LC_TIME：影响时间格式strftime()和wcsftime()。
  • LC_ALL：将以上所有类别设置为给定的语言环境。

setlocale()

setlocale()用来设置当前的地区。

  1. char* setlocale(int category, const char* locale);

它接受两个参数。第一个参数表示影响范围，如果值为前面五个表示类别的宏之一，则只影响该宏对应的类别，如果值为LC_ALL，则影响所有类别。第二个参数通常只为"C"（正常模式）或""（本地模式）。

任意程序开始时，都隐含下面的调用。

  1. setlocale(LC_ALL, "C");

下面的语句将格式本地化。

  1. setlocale(LC_ALL, "");

上面示例中，第二个参数为空字符，表示使用当前环境提供的本地化设置。

理论上，第二个参数也可以设为当前系统支持的某种格式。

  1. setlocale(LC_ALL, "en_US.UTF-8");

但是这样的话，程序的可移植性就变差了，因为无法保证其他系统也会支持那种格式。所以，通常都将第二个参数设为空字符串，使用操作系统的当前设置。

setlocale()的返回值是一个字符串指针，表示已经设置好的格式。如果调用失败，则返回空指针 NULL。

setlocale()可以用来查询当前地区，这时第二个参数设为 NULL 就可以了。

  1. char *loc;
  3. loc = setlocale(LC_ALL, NULL);
  5. // 输出 Starting locale: C
  6. printf("Starting locale: %s\n", loc);
  8. loc = setlocale(LC_ALL, "");
  10. // 输出 Native locale: en_US.UTF-8    
  11. printf("Native locale: %s\n", loc);

localeconv()

localeconv()用来获取当前格式的详细信息。

  1. struct lconv* localeconv(void);

该函数返回一个 Struct 结构指针，该结构里面包含了格式信息，它的主要属性如下。

  • char* mon_decimal_point：货币的十进制小数点字符，比如.。
  • char* mon_thousands_sep：货币的千位分隔符，比如,。
  • char* mon_grouping：货币的分组描述符。
  • char* positive_sign：货币的正值符号，比如+或为空字符串。
  • char* negative_sign：货币的负值符号，比如-。
  • char* currency_symbol：货币符号，比如$。
  • char frac_digits：打印货币金额时，十进制小数点后面输出几位小数，比如设为2。
  • char p_cs_precedes：设为1时，货币符号currency_symbol出现在非负金额前面。设为0时，出现在后面。
  • char n_cs_precedes：设为1时，货币符号currency_symbol出现在负的货币金额前面。设为0时，出现在后面。
  • char p_sep_by_space：决定了非负的货币金额与货币符号之间的分隔字符。
  • char n_sep_by_space：决定了负的货币金额与货币符号之间的分隔字符。
  • char p_sign_posn：决定了非负值的正值符号的位置。
  • char n_sign_posn：决定了负值的负值符号的位置。
  • char* int_curr_symbol：货币的国际符号，比如USD。
  • char int_frac_digits：使用国际符号时，frac_digits的值。
  • char int_p_cs_precedes：使用国际符号时，p_cs_precedes的值。
  • char int_n_cs_precedes：使用国际符号时，n_cs_precedes的值。
  • char int_p_sep_by_space：使用国际符号时，p_sep_by_space的值。
  • char int_n_sep_by_space：使用国际符号时，n_sep_by_space的值。
  • char int_p_sign_posn：使用国际符号时，p_sign_posn的值。
  • char int_n_sign_posn：使用国际符号时，n_sign_posn的值。

下面程序打印当前系统的属性值。

  1. #include <stdio.h>
  2. #include <locale.h>
  3. #include <string.h>
  5. int main ()
  6. {
  7.     setlocale (LC_ALL,"zh_CN");
  8.     struct lconv * lc;
  9.     lc=localeconv();
  10.     printf ("decimal_point: %s\n",lc->decimal_point);
  11.     printf ("thousands_sep: %s\n",lc->thousands_sep);
  12.     printf ("grouping: %s\n",lc->grouping);
  13.     printf ("int_curr_symbol: %s\n",lc->int_curr_symbol);
  14.     printf ("currency_symbol: %s\n",lc->currency_symbol);
  15.     printf ("mon_decimal_point: %s\n",lc->mon_decimal_point);
  16.     printf ("mon_thousands_sep: %s\n",lc->mon_thousands_sep);
  17.     printf ("mon_grouping: %s\n",lc->mon_grouping);
  18.     printf ("positive_sign: %s\n",lc->positive_sign);
  19.     printf ("negative_sign: %s\n",lc->negative_sign);
  20.     printf ("frac_digits: %d\n",lc->frac_digits);
  21.     printf ("p_cs_precedes: %d\n",lc->p_cs_precedes);
  22.     printf ("n_cs_precedes: %d\n",lc->n_cs_precedes);
  23.     printf ("p_sep_by_space: %d\n",lc->p_sep_by_space);
  24.     printf ("n_sep_by_space: %d\n",lc->n_sep_by_space);
  25.     printf ("p_sign_posn: %d\n",lc->p_sign_posn);
  26.     printf ("n_sign_posn: %d\n",lc->n_sign_posn);
  27.     printf ("int_frac_digits: %d\n",lc->int_frac_digits);
  28.     printf ("int_p_cs_precedes: %d\n",lc->int_p_cs_precedes);
  29.     printf ("int_n_cs_precedes: %d\n",lc->int_n_cs_precedes);
  30.     printf ("int_p_sep_by_space: %d\n",lc->int_p_sep_by_space);
  31.     printf ("int_n_sep_by_space: %d\n",lc->int_n_sep_by_space);
  32.     printf ("int_p_sign_posn: %d\n",lc->int_p_sign_posn);
  33.     printf ("int_n_sign_posn: %d\n",lc->int_n_sign_posn);
  35.     return 0;
  36. }