C++ 参考手册

位置:首页 > C++ 参考手册 >本地化库 > std::setlocale

定义于头文件 <clocale>
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::fprintfstd::isprintstd::iswdigitstd::localeconvstd::tolowerstd::fscanfstd::ispunctstd::iswgraphstd::mblenstd::toupperstd::isalnumstd::isspacestd::iswlowerstd::mbstowcsstd::towlowerstd::isalphastd::isupperstd::iswprintstd::mbtowcstd::towupperstd::isblankstd::iswalnumstd::iswpunctstd::setlocalestd::wcscollstd::iscntrlstd::iswalphastd::iswspacestd::strcollstd::wcstodstd::isdigitstd::iswblankstd::iswupperstd::strerrorstd::wcstombsstd::isgraphstd::iswcntrlstd::iswxdigitstd::strtodstd::wcsxfrmstd::islowerstd::iswctypestd::isxdigit

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

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

示例

#include <cstdio>
#include <clocale>
#include <ctime>
#include <cwchar>
 
int main()
{
    // C 本地环境将为启用 UTF-8 的英文;
    // 小数点将为德文
    // 日期和时间格式将为日文
    std::setlocale(LC_ALL, "en_US.UTF-8");
    std::setlocale(LC_NUMERIC, "de_DE.UTF-8");
    std::setlocale(LC_TIME, "ja_JP.UTF-8");
 
    wchar_t str[100];
    std::time_t t = std::time(NULL);
    std::wcsftime(str, 100, L"%A %c", std::localtime(&t));
    std::wprintf(L"Number: %.2f\nDate: %Ls\n", 3.14, str);
}

输出:

Number: 3,14
Date: 月曜日 2011年12月19日 18時04分40秒

参阅

std::setlocale 所用的本地环境类别
(宏常量)
用以封装文化差异的多态刻面的集合
(类)