c++11 标准模板（STL）本地化库 - 平面类别 C 库本地环境

本地化库

本地环境设施包含字符分类和字符串校对、数值、货币及日期/时间格式化和分析，以及消息取得的国际化支持。本地环境设置控制流 I/O 、正则表达式库和 C++ 标准库的其他组件的行为。

C 库本地环境

获取和设置当前 C 本地环境

std::setlocale

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

setlocale 函数安装指定的系统本地环境或其一部分，作为新的 C 本地环境。修改保持效果，并影响所有关乎本地环境的 C 库函数执行，到下次调用 setlocale 为止。若 locale 为空指针，则 setlocale 查询当前 C 本地环境而不修改它。

参数

category	-	本地环境类别标识符， LC_xxx 宏之一。可为 0 。
locale	-	系统限定的本地环境标识符。对于用户偏好的本地环境为 "" ，对于最小本地环境为 "C" 。

返回值

指向窄空终止字符串的指针，它表示应用更改后的 C 本地环境，若存在。或在失败时为空指针。

返回字符串的副本和到 std::setlocale 的此调用中所用的类别，可在程序的后面用来恢复本地环境到此调用结束时的状态。

注意

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

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

setlocale 修改影响本地环境依赖函数的全局状态，故从一个线程调用它，而另一线程同时执行任何下列函数是未定义行为： std::fprintf 、 std::isprint 、 std::iswdigit 、 std::localeconv 、 std::tolower 、 std::fscanf 、 std::ispunct 、 std::iswgraph 、 std::mblen 、 std::toupper 、 std::isalnum 、 std::isspace 、 std::iswlower 、 std::mbstowcs 、 std::towlower 、 std::isalpha 、 std::isupper 、 std::iswprint 、 std::mbtowc 、 std::towupper 、 std::isblank 、 std::iswalnum 、 std::iswpunct 、 std::setlocale 、 std::wcscoll 、 std::iscntrl 、 std::iswalpha 、 std::iswspace 、 std::strcoll 、 std::wcstod 、 std::isdigit 、 std::iswblank 、 std::iswupper 、 std::strerror 、 std::wcstombs 、 std::isgraph 、 std::iswcntrl 、 std::iswxdigit 、 std::strtod 、 std::wcsxfrm 、 std::islower 、 std::iswctype 、 std::isxdigit 。

POSIX 亦定义名为 "POSIX" 的本地环境，它始终可访问，并准确等于默认的最小 "C" 本地环境。

POSIX 亦指定后继的 setlocale 调用可以非法化返回的指针，而不仅是被指向的字符串内容。

std::setlocale 所用的本地环境类别

LC_ALL, 
LC_COLLATE, 
LC_CTYPE, 
LC_MONETARY, 
LC_NUMERIC, 
LC_TIME

#define LC_ALL      /*implementation defined*/
#define LC_COLLATE  /*implementation defined*/
#define LC_CTYPE    /*implementation defined*/
#define LC_MONETARY /*implementation defined*/
#define LC_NUMERIC  /*implementation defined*/
#define LC_TIME     /*implementation defined*/

上面每个宏常量都展开成拥有相异值的整数常量表达式，适合用作 std::setlocale 的首个参数。

常量	解释
LC_ALL	选择整个 C 本地环境
LC_COLLATE	选择 C 本地环境的对照类别
LC_CTYPE	选择 C 本地环境中的字符分类类别
LC_MONETARY	选择 C 本地环境中的货币格式化类别
LC_NUMERIC	选择 C 本地环境中的数值格式化类别
LC_TIME	选择 C 本地环境中的时间格式化类别

<clocale> 中可以定义附加宏常量，名称以 LC_ 后随至少一个大写字母开始。例如， POSIX 规范要求 LC_MESSAGES （控制 std::perror 和 std::strerror ）， ISO/IEC 30112:2014 （ 2014 方案）额外定义 LC_IDENTIFICATION 、 LC_XLITERATE 、 LC_NAME 、 LC_ADDRESS 、 LC_TELEPHONE 、 LC_PAPER 、 LC_MEASUREMENT 和 LC_KEYBOARD ，它们均为 GNU C 库所支持（除了 LC_XLITERATE ）。

调用示例 windows

#include <iostream>
#include <sstream>
#include <locale>
#include <iomanip>
#include <vector>
#include <algorithm>
#include <iterator>
#include <exception>

#include <clocale>
#include <ctime>
#include <cwchar>

#include <Windows.h>

std::vector<std::wstring> locals;

BOOL CALLBACK MyFuncLocaleEx(LPWSTR pStr, DWORD dwFlags, LPARAM lparam)
{
    locals.push_back(pStr);
    return TRUE;
}

std::string stows(const std::wstring& ws)
{
    std::string curLocale = setlocale(LC_ALL, NULL); // curLocale = "C";
    setlocale(LC_ALL, "chs");
    const wchar_t* _Source = ws.c_str();
    size_t _Dsize = 2 * ws.size() + 1;
    char *_Dest = new char[_Dsize];
    memset(_Dest, 0, _Dsize);
    wcstombs(_Dest, _Source, _Dsize);
    std::string result = _Dest;
    delete[]_Dest;
    setlocale(LC_ALL, curLocale.c_str());
    return result;
}

int main()
{
    EnumSystemLocalesEx(MyFuncLocaleEx, LOCALE_ALTERNATE_SORTS, NULL, NULL);

    for (std::vector<std::wstring>::const_iterator str = locals.begin();
            str != locals.end(); ++str)
    {
        // C 本地环境将为启用 UTF-8 的英文；
        // 小数点将为德文
        // 日期和时间格式将为日文
        std::locale locale(stows(*str));
        std::setlocale(LC_ALL, locale.name().c_str());
        std::setlocale(LC_NUMERIC, locale.name().c_str());
        std::setlocale(LC_TIME, locale.name().c_str());
        std::cout << "locale: " << locale.name().c_str() << "    ";

        wchar_t strArr[100];
        std::time_t time = std::time(NULL);
        std::wcsftime(strArr, 100, L"%A %c", std::localtime(&time));
        std::wprintf(L"Number: %.2f    Date: %Ls\n", 3.14, strArr);
    }

    return 0;
}

输出

locale: de-DE_phoneb    Number: 3,14    Date: Sonntag 26.05.2024 17:09:18
locale: es-ES_tradnl    Number: 3,14    Date: domingo 26/05/2024 17:09:18
locale: hu-HU_technl    Number: 3,14    Date: vasárnap 2024. 05. 26. 17:09:18
locale: ja-JP_radstr    Number: 3.14    Date: 日曜日 2024/05/26 17:09:18
locale: ka-GE_modern    Number: 3,14    Date: ????? 26.05.2024 17:09:18
locale: x-IV_mathan    Number: 3.14    Date: Sunday 05/26/2024 17:09:18
locale: zh-CN_phoneb    Number: 3.14    Date: 星期日 2024/5/26 17:09:18
locale: zh-CN_stroke    Number: 3.14    Date: 星期日 2024/5/26 17:09:18
locale: zh-HK_radstr    Number: 3.14    Date: 星期日 26/5/2024 17:09:18
locale: zh-MO_radstr    Number: 3.14    Date: 星期日 26/5/2024 17:09:18
locale: zh-MO_stroke    Number: 3.14    Date: 星期日 26/5/2024 17:09:18
locale: zh-SG_phoneb    Number: 3.14    Date: 星期日 26/5/2024 下午 5:09:18
locale: zh-SG_stroke    Number: 3.14    Date: 星期日 26/5/2024 下午 5:09:18
locale: zh-TW_pronun    Number: 3.14    Date: 星期日 2024/5/26 下午 05:09:18
locale: zh-TW_radstr    Number: 3.14    Date: 星期日 2024/5/26 下午 05:09:18