std:: setlocale

setlocale 函数将指定的系统区域设置或其部分安装为新的 C 区域设置。此修改会持续生效，并影响所有区域设置敏感的 C 库函数的执行，直至下一次调用 setlocale 。若 locale 为空指针， setlocale 将查询当前 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 的调用所失效。

示例

#include <clocale>
#include <cstdio>
#include <ctime>
#include <cwchar>
#include <iterator>
#include <string>
int main()
{
    // 对当前区域设置名称进行“深拷贝”
    std::string prev_loc = std::setlocale(LC_ALL, nullptr);
    // C区域设置将启用UTF-8英语环境，
    // 小数点使用德语格式，
    // 日期时间格式使用日语格式。
    if (const char* loc = std::setlocale(LC_ALL, "en_US.UTF-8"))
        std::wprintf(L"New LC_ALL locale: %s\n", loc);
    if (const char* loc = std::setlocale(LC_NUMERIC, "de_DE.UTF-8"))
        std::wprintf(L"New LC_NUMERIC locale: %s\n", loc);
    if (const char* loc = std::setlocale(LC_TIME, "ja_JP.UTF-8"))
        std::wprintf(L"New LC_TIME locale: %s\n", loc);
    wchar_t buf[100];
    std::time_t t = std::time(nullptr);
    std::wcsftime(buf, std::size(buf), L"%A %c", std::localtime(&t));
    std::wprintf(L"Number: %.2f\nDate: %Ls\n", 3.14, buf);
    // 恢复之前的区域设置
    if (const char* loc = std::setlocale(LC_ALL, prev_loc.c_str()))
        std::wprintf(L"Restorred LC_ALL locale: %s\n", loc);
}

New LC_ALL locale: en_US.UTF-8
New LC_NUMERIC locale: de_DE.UTF-8
New LC_TIME locale: ja_JP.UTF-8
Number: 3,14
Date: 日曜日 2022年11月06日 20時40分59秒
Restorred LC_ALL locale: C

参阅

外部链接