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;
  2. loc = setlocale(LC_ALL, NULL);
  3. // 输出 Starting locale: C
  4. printf("Starting locale: %s\n", loc);
  5. loc = setlocale(LC_ALL, "");
  6. // 输出 Native locale: en_US.UTF-8
  7. 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>
  4. int main ()
  5. {
  6. setlocale (LC_ALL,"zh_CN");
  7. struct lconv * lc;
  8. lc=localeconv();
  9. printf ("decimal_point: %s\n",lc->decimal_point);
  10. printf ("thousands_sep: %s\n",lc->thousands_sep);
  11. printf ("grouping: %s\n",lc->grouping);
  12. printf ("int_curr_symbol: %s\n",lc->int_curr_symbol);
  13. printf ("currency_symbol: %s\n",lc->currency_symbol);
  14. printf ("mon_decimal_point: %s\n",lc->mon_decimal_point);
  15. printf ("mon_thousands_sep: %s\n",lc->mon_thousands_sep);
  16. printf ("mon_grouping: %s\n",lc->mon_grouping);
  17. printf ("positive_sign: %s\n",lc->positive_sign);
  18. printf ("negative_sign: %s\n",lc->negative_sign);
  19. printf ("frac_digits: %d\n",lc->frac_digits);
  20. printf ("p_cs_precedes: %d\n",lc->p_cs_precedes);
  21. printf ("n_cs_precedes: %d\n",lc->n_cs_precedes);
  22. printf ("p_sep_by_space: %d\n",lc->p_sep_by_space);
  23. printf ("n_sep_by_space: %d\n",lc->n_sep_by_space);
  24. printf ("p_sign_posn: %d\n",lc->p_sign_posn);
  25. printf ("n_sign_posn: %d\n",lc->n_sign_posn);
  26. printf ("int_frac_digits: %d\n",lc->int_frac_digits);
  27. printf ("int_p_cs_precedes: %d\n",lc->int_p_cs_precedes);
  28. printf ("int_n_cs_precedes: %d\n",lc->int_n_cs_precedes);
  29. printf ("int_p_sep_by_space: %d\n",lc->int_p_sep_by_space);
  30. printf ("int_n_sep_by_space: %d\n",lc->int_n_sep_by_space);
  31. printf ("int_p_sign_posn: %d\n",lc->int_p_sign_posn);
  32. printf ("int_n_sign_posn: %d\n",lc->int_n_sign_posn);
  33. return 0;
  34. }