setlocale

来自cppreference.com
< c‎ | locale
定义于头文件 <locale.h>
char* setlocale( int category, const char* locale);

setlocale将指定的系统本地环境或其一部分安装成新的C本地环境。修改在下一次setlocale前调用保持生效,并影响所有对本地环境敏感的C库函数。若locale是空指针,则setlocale查询当前C本地环境而不修改它。

目录

[编辑] 参数

category - 本地环境分类标识符,LC_xxx宏之一。可以是空。
locale - 系统指定的本地环境标识符。可以是代表用户偏好的本地环境的""或代表最小本地环境的"C"

[编辑] 返回值

成功时,返回指针,指向标识更改应用后的C本地环境的窄空终止字符串。失败时返回空指针。

返回字符串的副本可以和用于此次setlocale调用的类别一同,在程序之后的部分将本地环境恢复到此次调用结束时的状态。

[编辑] 注意

在程序启动时,等价于setlocale(LC_ALL, "C");的内容会在任何用户代码运行前执行。

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

因为setlocale修改影响依赖本地环境的函数执行的全局状态,故而一个线程调用它,同时另一个线程执行任何下列函数是未定义行为:fprintfisprintiswdigitlocaleconvtolowerfscanfispunctiswgraphmblentoupperisalnumisspaceiswlowermbstowcstowlowerisalphaisupperiswprintmbtowctowupperisblankiswalnumiswpunctsetlocalewcscolliscntrliswalphaiswspacestrcollwcstodisdigitiswblankiswupperstrerrorwcstombsisgraphiswcntrliswxdigitstrtodwcsxfrmisloweriswctypeisxdigit

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

POSIX亦指明了不仅是返回指针指向的内容,返回的指针本身亦可能被后继的setlocale调用非法化。

[编辑] 示例

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

可能的输出:

Number: 3,14
Date: 木曜日 2014年11月06日 09時58分56秒

[编辑] 参考

  • C11 standard (ISO/IEC 9899:2011):
  • 7.11.1.1 The setlocale function (p: 224-225)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.11.1.1 The setlocale function (p: 205-206)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.4.1.1 The setlocale function

[编辑] 参阅

setlocale所用的本地环境类别
(宏常量) [edit]
setlocaleC++文档