setlocale函数

#include <locale.h>
char *setlocale(int category, const char *locale);

该函数选择由参数category和参数locale指定的程序语言环境的适当部分；该函数可用于更改或者查询整个当前语言环境或者部分当前语言环境。

如果参数locale值为"C"，将指定C程序编译的最小语言环境；如果参数locale值为""，将指定特定语言环境的本地环境。参数locale还可能是其它实现定义的字符串。

C程序启动时执行"C"语言环境，等同于执行以下语句：

setlocale(LC_ALL, "C");

"C"语言环境在所有系统和编译器上设置是相同的，因此该语言环境下程序的运行结果是可以预测的。

如果要使用本地默认的语言环境，可使用以下语句进行设置：

setlocale(LC_ALL, "");

如果要获取当前语言环境，可使用以下语句：

setlocale(LC_ALL, NULL);

setlocale函数的调用可能会与setlocale函数的其它调用或者受当前语言环境影响的函数调用产生数据竞争。实现应像没有库函数调用setlocale函数一样。

category为下述值之一：

locale为下述值之一：

1、特定值

"C"、""、空指针都是ISO/IEC 9899:2018标准支持的locale值，支持ISO/IEC 9899:2018标准的C编译器都可以使用这三个locale值；"POSIX"是ISO/IEC/IEEE 9945:2009标准中提供的locale值，是否支持以及如何支持各编译器差异较大。

2、格式化值

参数locale也可能具有以下格式化值。

language[_territory][.codeset][@modifier]

该值是实现提供的语言环境，其中语言（language）、地区（territory）和代码集（codeset）的设置由具体实现定义。[ ]中的字段是可选的。如果设置的语言环境类别是LC_COLLATE、LC_CTYPE、LC_MONETARY、LC_NUMERIC或者LC_TIME，可以附加字段@modifier，这允许用户在单个类别中选择本地化数据的特定实例。

ISO 639标准对全球500多种语言进行了编码，以汉语为例，其对应的2字母编码为zh，更完整的语言编码请查阅ISO官网。ISO 3166标准对国家进行了编码，以中国为例，其对应的2字母编码为CN，更完整的国家编码请查阅ISO官网。下面是两个根据上述标准设置语言环境的例子：

实现还可能支持其它形式的格式化值。Windows系统支持的locale值请查阅此网页。Visual Studio编译器可以使用语言环境名（locale-name）用作locale值。语言环境名是IETF标准化的短字符串，例如："zh-CN"、"en-US"等等。

如果语言环境设置成功，函数返回一个指向与新语言环境指定类别相关联的字符串的指针；如果语言环境设置不成功，函数返回一个空指针，程序的语言环境保持不变。

如果参数locale是空指针，函数返回一个指向与当前语言环境指定类别相关联的字符串的指针，并且程序的语言环境保持不变。

setlocale函数返回的指向字符串的指针可以用作后续恢复程序的语言环境；该字符串不能被程序修改，但可以被后续setlocale函数调用覆盖。

1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 

/*函数setlocale范例*/

#include <locale.h>
#include <stdio.h>

int main(void)
{
    printf("Locale: %s\n", setlocale(LC_ALL, NULL));

    setlocale(LC_ALL,"");
    printf("Locale: %s\n", setlocale(LC_ALL, NULL));

    setlocale(LC_ALL, "en-GB");
    printf("Locale: %s\n", setlocale(LC_ALL, NULL));

    return 0;
}

注：使用Visual Studio编译。