std::setlocale详解

头文件

#include <clocale>

作用

std::setlocale是C++标准库中的一个函数，用于设置当前程序的本地化（locale）环境。

setlocale 函数安装指定的系统本地环境或其一部分，作为新的 C 本地环境。

修改保持效果，并影响所有关乎本地环境的 C 库函数执行，到下次调用 setlocale 为止。

原型

原型如下：

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

category参数

category：指定要设置的本地化环境的类别，包括以下值：

LC_ALL：所有本地化设置
LC_COLLATE：字符串比较和排序规则
LC_CTYPE：字符分类和转换规则
LC_MONETARY：货币格式
LC_NUMERIC：数值格式
LC_TIME：日期和时间格式

locale参数

locale：指定要设置的本地化环境的名称或字符串。有以下几种输入格式：

“C”

将本地化环境设置为默认的C语言环境。

在程序启动时，将执行以下语句的等效项：

setlocale( LC_ALL, "C" );    //运行库调用，无需用户手动调用

NULL

获取当前的本地化环境设置。

示例：

char* pLocale = setlocale(LC_ALL, nullptr);

结果：

因为在程序启动时，将执行以下语句的等效项：setlocale( LC_ALL, “C” );

因此程序运行后再获取到的本地化环境配置是“C”。

“”

将区域设置设定为默认值，该值是从操作系统获得的用户默认的 ANSI 代码页。 区域设置名称设置为由 GetUserDefaultLocaleName 返回的值。 代码页设置为由 GetACP 返回的值。

示例：

//获取本地化环境配置
char* pLocal = setlocale(LC_ALL, nullptr);

//恢复默认配置

//获取语言环境名称
TCHAR tchLocaleName[MAX_PATH];
int nRet = GetUserDefaultLocaleName(tchLocaleName, MAX_PATH);

//获取代码页
int nAcp = GetACP();

//获取语言配置，同GetUserDefaultLocaleName
WCHAR wchLang[MAX_PATH];
int nLen = GetLocaleInfoEx(tchLocaleName, LOCALE_SLANGUAGE, wchLang, MAX_PATH);

//获取国家/地区
WCHAR wchCountry[MAX_PATH];
int nLen2 = GetLocaleInfoEx(tchLocaleName, LOCALE_SCOUNTRY, wchCountry, MAX_PATH);

char* pDefault = setlocale(LC_ALL, "");

char* pNewLC = setlocale(LC_ALL, nullptr);

结果：

language语言字符串可选：

语言字符串 | Microsoft Learn

country国家/地区字符串可选：

国家-地区字符串 | Microsoft Learn

codepage代码页字符串可选：

代码页标识符 - Win32 apps | Microsoft Learn

其他参数值的验证方式同前，因此后面不再赘述。

“.OCP”

将设置区域设置为从操作系统获得的当前 OEM 代码页。 区域设置名称设置为由 GetUserDefaultLocaleName 返回的值。 代码页设置为由 GetLocaleInfoEx 返回的用户默认区域设置名称的 LOCALE_IDEFAULTCODEPAGE 值。

示例：

//".OCP"
char* pOCP = setlocale(LC_ALL, ".OCP");

结果：

“.ACP”

将区域设置设定为从操作系统获得的 ANSI 代码页。 区域设置名称设置为由 GetUserDefaultLocaleName 返回的值。 代码页设置为由 GetLocaleInfoEx 返回的用户默认区域设置名称的 LOCALE_IDEFAULTANSICODEPAGE 值。

示例：

//".ACP"
char* pACP = setlocale(LC_ALL, ".ACP");

结果：

“localename”

将区域设置设定为由 localename指示的区域设置名称。 代码页设置为由 GetLocaleInfoEx 返回的指定区域设置名称的 LOCALE_IDEFAULTANSICODEPAGE 值。

示例：

//"localename"
char* pLocaleName = setlocale(LC_ALL, "zh-HK");
//查看设置后的效果
char* pNewLC = setlocale(LC_ALL, nullptr);

结果：

localename语言环境字符串参考该链接中的附录 A：产品行为，参阅其中表内的“语言标记”列：

[MS-LCID]: Appendix A: Product Behavior | Microsoft Learn

“language”

将区域设置设定为由 指示的语言，为指定的语言使用默认国家/地区，为从主机操作系统获取的国家/地区使用用户默认的 ANSI 代码页。

示例：

//"language"
//以下几种设置方式是等效的
char* pLocaleName = setlocale(LC_ALL, "en-US");
char* pLocaleName2 = setlocale(LC_ALL, "English");
char* pLocaleName3 = setlocale(LC_ALL, "English_United States.1252");
//查看设置后的效果
char* pNewLC = setlocale(LC_ALL, nullptr);r);

结果：

language语言字符串可选值：

语言字符串 | Microsoft Learn

“language_country”

将区域设置设定为由 和 指示的语言和国家/地区，以及从主机操作系统获得的默认代码页。 代码页设置为由 GetLocaleInfoEx 返回的指定区域设置名称的 LOCALE_IDEFAULTANSICODEPAGE 值。

示例：

//"language-country"
char* pLocale = setlocale(LC_ALL, "chinese-traditional_hong-kong");

//国家/地区字符串可缩写
char* pLocale2 = setlocale(LC_ALL, "chinese-traditional_HKG");

char* pLocale3 = setlocale(LC_ALL, "chinese-simplified_china");

//设置的语言和指定国家/地区的默认语言不一致时，会国家/地区的默认语言为准
//hong-kong默认语言为繁体(Codepage 950)，这里即时设置语言为chinese-simplified，设置后也还是默认的繁体语言
char* pLocale4 = setlocale(LC_ALL, "chinese-simplified_hong-kong");

char* pLocale5 = setlocale(LC_ALL, "chinese-traditional_china");
//查看设置后的效果
char* pNewLC = setlocale(LC_ALL, nullptr);

结果：

language语言字符串可选：

语言字符串 | Microsoft Learn

country国家/地区字符串可选：

国家-地区字符串 | Microsoft Learn

“language_country.code-page”

将区域设置设定为由 、 和 <code_page> 字符串指示的语言、国家/地区和代码页。 你可以使用语言、国家/地区和代码页的各种组合。

例如，此调用会将区域设置设定为“法语(加拿大)”并使用代码页 1252：

setlocale( LC_ALL, "French_Canada.1252" );

示例：

//"language_country.code-page"
char* pLocale = setlocale(LC_ALL, "chinese-traditional_hong-kong.950");

char* pLocale3 = setlocale(LC_ALL, "chinese-simplified_china.936");

char* pLocale4 = setlocale(LC_ALL, "english-us_america.1252");

结果：

输入配置有冲突时，主要注意以下两种情况：

①语言和国家/地区默认语言冲突：以国家/地区默认语言为准

②语言和代码页冲突时：最终设置的语言同①，代码页则以设置的为准

示例：

//输入配置有冲突时
//语言和代码页冲突
char* pLocale5 = setlocale(LC_ALL, "chinese-traditional_hong-kong.936");

char* pLocale6 = setlocale(LC_ALL, "chinese-simplified_hong-kong.936");

char* pLocale7 = setlocale(LC_ALL, "chinese-simplified_china.950");

char* pLocale8 = setlocale(LC_ALL, "chinese-traditional_china.950");

结果：

language语言字符串可选：

语言字符串 | Microsoft Learn

country国家/地区字符串可选：

国家-地区字符串 | Microsoft Learn

代码页标识符可选值：

代码页标识符 - Win32 apps | Microsoft Learn

“.code-page”

将代码页设置为由 <code_page> 指示的值，以及指定代码页的默认国家/地区和语言（由主机操作系统定义）。

示例：

//".code-page"
//GB2312
char* pLocale = setlocale(LC_ALL, ".936");

//BIG5
char* pLocale2 = setlocale(LC_ALL, ".950");

//UTF-8
char* pLocale3 = setlocale(LC_ALL, ".65001");

//UTF-16
char* pLocale4 = setlocale(LC_ALL, ".1200");
//big endian 字节顺序
char* pLocale5 = setlocale(LC_ALL, ".1201");

//UTF-32
//little endian 字节顺序
char* pLocale6 = setlocale(LC_ALL, ".12000");
// big endian 字节顺序;
char* pLocale7 = setlocale(LC_ALL, ".12001");

//ANSI
char* pLocale8 = setlocale(LC_ALL, ".1252");

结果：

代码页标识符可选值：

代码页标识符 - Win32 apps | Microsoft Learn

返回值

函数返回值为指向字符串的指针，表示当前设置的本地化环境。

操作系统不支持所请求的本地化环境或缺少相关的本地化环境设置，则返回NULL。

注意

程序启动过程中，运行任何用户代码前会执行 std::setlocale(LC_ALL, “C”); 的等价代码。

尽管返回类型为 char* ，修改被指向的字符是未定义行为。

附录

相关参考：

setlocale，_wsetlocale | Microsoft Learn

区域设置名称、语言和国家-地区字符串 | Microsoft Learn

[MS-LCID]: Appendix A: Product Behavior | Microsoft Learn

语言字符串 | Microsoft Learn

国家-地区字符串 | Microsoft Learn

代码页标识符 - Win32 apps | Microsoft Learn