std::setlocale详解

头文件

cpp 复制代码
#include <clocale>

作用

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

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

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

原型

原型如下:

cpp 复制代码
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语言环境。

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

cpp 复制代码
setlocale( LC_ALL, "C" );    //运行库调用,无需用户手动调用

NULL

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

示例:

cpp 复制代码
char* pLocale = setlocale(LC_ALL, nullptr);

结果:

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

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

""

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

示例:

cpp 复制代码
//获取本地化环境配置
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 值。

示例:

cpp 复制代码
//".OCP"
char* pOCP = setlocale(LC_ALL, ".OCP");

结果:

".ACP"

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

示例:

cpp 复制代码
//".ACP"
char* pACP = setlocale(LC_ALL, ".ACP");

结果:

"localename"

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

示例:

cpp 复制代码
//"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 代码页。

示例:

cpp 复制代码
//"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 值。

示例:

cpp 复制代码
//"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:

cpp 复制代码
setlocale( LC_ALL, "French_Canada.1252" );

示例:

cpp 复制代码
//"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");

结果:

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

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

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

示例:

cpp 复制代码
//输入配置有冲突时
//语言和代码页冲突
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> 指示的值,以及指定代码页的默认国家/地区和语言(由主机操作系统定义)。

示例:

cpp 复制代码
//".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

相关推荐
小坏坏的大世界1 小时前
C++ STL常用容器总结(vector, deque, list, map, set)
c++·算法
liulilittle2 小时前
C++ TAP(基于任务的异步编程模式)
服务器·开发语言·网络·c++·分布式·任务·tap
励志要当大牛的小白菜4 小时前
ART配对软件使用
开发语言·c++·qt·算法
PAK向日葵5 小时前
【算法导论】如何攻克一道Hard难度的LeetCode题?以「寻找两个正序数组的中位数」为例
c++·算法·面试
QQ_4376643149 小时前
C++11 右值引用 Lambda 表达式
java·开发语言·c++
liulilittle11 小时前
C++/CLI与标准C++的语法差异(一)
开发语言·c++·.net·cli·clr·托管·原生
小狄同学呀11 小时前
VS插件报错,g++却完美编译?API调用错因分析
c++
程序员编程指南11 小时前
Qt 数据库连接池实现与管理
c语言·数据库·c++·qt·oracle
小乖兽技术11 小时前
C#与C++交互开发系列(二十四):WinForms 应用中嵌入C++ 原生窗体
c++·c#·交互
张北北.11 小时前
【深入底层】C++开发简历4+4技能描述6
java·开发语言·c++