1
0
wiki/docs/开发/C/lib 标准库/locale.h.md

143 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# locale.h
## 简介
`locale.h`是程序的本地化设置,主要影响以下的行为。
- 数字格式
- 货币格式
- 字符集
- 日期和时间格式
它设置了以下几个宏。
- LC_COLLATE影响字符串比较函数`strcoll()`和`strxfrm()`。
- LC_CTYPE影响字符处理函数的行为。
- LC_MONETARY影响货币格式。
- LC_NUMERIC影响`printf()`的数字格式。
- LC_TIME影响时间格式`strftime()`和`wcsftime()`。
- LC_ALL将以上所有类别设置为给定的语言环境。
## setlocale()
`setlocale()`用来设置当前的地区。
```c
char* setlocal(int category, const char* locale);
```
它接受两个参数。第一个参数表示影响范围,如果值为前面五个表示类别的宏之一,则只影响该宏对应的类别,如果值为`LC_ALL`,则影响所有类别。第二个参数通常只为`"C"`(正常模式)或`""`(本地模式)。
任意程序开始时,都隐含下面的调用。
```c
setlocale(LC_ALL, "C");
```
下面的语句将格式本地化。
```c
setlocale(LC_ALL, "");
```
上面示例中,第二个参数为空字符,表示使用当前环境提供的本地化设置。
理论上,第二个参数也可以设为当前系统支持的某种格式。
```c
setlocale(LC_ALL, "en_US.UTF-8");
```
但是这样的话,程序的可移植性就变差了,因为无法保证其他系统也会支持那种格式。所以,通常都将第二个参数设为空字符串,使用操作系统的当前设置。
`setlocale()`的返回值是一个字符串指针,表示已经设置好的格式。如果调用失败,则返回空指针 NULL。
`setlocale()`可以用来查询当前地区,这时第二个参数设为 NULL 就可以了。
```c
char *loc;
loc = setlocale(LC_ALL, NULL);
// 输出 Starting locale: C
printf("Starting locale: %s\n", loc);
loc = setlocale(LC_ALL, "");
// 输出 Native locale: en_US.UTF-8
printf("Native locale: %s\n", loc);
```
## localeconv()
`localeconv()`用来获取当前格式的详细信息。
```c
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`的值。
下面程序打印当前系统的属性值。
```c
#include <stdio.h>
#include <locale.h>
#include <string.h>
int main ()
{
setlocale (LC_ALL,"zh_CN");
struct lconv * lc;
lc=localeconv();
printf ("decimal_point: %s\n",lc->decimal_point);
printf ("thousands_sep: %s\n",lc->thousands_sep);
printf ("grouping: %s\n",lc->grouping);
printf ("int_curr_symbol: %s\n",lc->int_curr_symbol);
printf ("currency_symbol: %s\n",lc->currency_symbol);
printf ("mon_decimal_point: %s\n",lc->mon_decimal_point);
printf ("mon_thousands_sep: %s\n",lc->mon_thousands_sep);
printf ("mon_grouping: %s\n",lc->mon_grouping);
printf ("positive_sign: %s\n",lc->positive_sign);
printf ("negative_sign: %s\n",lc->negative_sign);
printf ("frac_digits: %d\n",lc->frac_digits);
printf ("p_cs_precedes: %d\n",lc->p_cs_precedes);
printf ("n_cs_precedes: %d\n",lc->n_cs_precedes);
printf ("p_sep_by_space: %d\n",lc->p_sep_by_space);
printf ("n_sep_by_space: %d\n",lc->n_sep_by_space);
printf ("p_sign_posn: %d\n",lc->p_sign_posn);
printf ("n_sign_posn: %d\n",lc->n_sign_posn);
printf ("int_frac_digits: %d\n",lc->int_frac_digits);
printf ("int_p_cs_precedes: %d\n",lc->int_p_cs_precedes);
printf ("int_n_cs_precedes: %d\n",lc->int_n_cs_precedes);
printf ("int_p_sep_by_space: %d\n",lc->int_p_sep_by_space);
printf ("int_n_sep_by_space: %d\n",lc->int_n_sep_by_space);
printf ("int_p_sign_posn: %d\n",lc->int_p_sign_posn);
printf ("int_n_sign_posn: %d\n",lc->int_n_sign_posn);
return 0;
}
```