setlocale

 

C

编译器支持

语言

头文件

类型支持

程序实用工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

本地化支持

setlocale

localeconv

lconv

区域设置类别

LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME

 

在头文件 <locale.h> 中定义
char* setlocale( int category, const char* locale );

setlocale 函数将指定的系统区域设置或其部分安装为新的 C 区域设置。这些修改将一直有效，并影响所有与区域设置相关的 C 库函数的执行，直到下次调用 setlocale 为止。如果 locale 是一个空指针，setlocale 将查询当前的 C 区域设置，而不修改它。

参数

category	-	区域设置类别标识符，是 LC_xxx 宏之一。可以为空。
locale	-	特定于系统区域设置标识符。可以是 "" 表示用户首选区域设置，或者 "C" 表示最小区域设置

返回值

指向窄空终止字符串的指针，该字符串标识应用更改（如果有）后的 C 区域设置，如果失败则为空指针。

返回字符串的副本以及本次调用 setlocale 中使用的类别可以在程序中稍后用于将区域设置恢复到本次调用结束时的状态。

注意

在程序启动期间，等效于 setlocale(LC_ALL, "C"); 会在任何用户代码运行之前执行。

虽然返回值类型为 char*，但修改指向的字符会导致未定义的行为。

由于 setlocale 修改全局状态，这将影响与区域设置相关的函数的执行，因此在一个线程中调用它，而在另一个线程中执行以下任何函数会导致未定义的行为：fprintf, isprint, iswdigit, localeconv, tolower, fscanf, ispunct, iswgraph, mblen, toupper, isalnum, isspace, iswlower, mbstowcs, towlower, isalpha, isupper, iswprint, mbtowc, towupper, isblank, iswalnum, iswpunct, setlocale, wcscoll, iscntrl, iswalpha, iswspace, strcoll, wcstod, isdigit, iswblank, iswupper, strerror, wcstombs, isgraph, iswcntrl, iswxdigit, strtod, wcsxfrm, islower, iswctype, isxdigit.

POSIX 还定义了一个名为“POSIX”的区域设置，它始终可以访问，并且与默认的最小“C”区域设置完全相同。

POSIX 还指定，返回的指针（不仅仅是指向字符串的内容）可能会被后续对 setlocale 的调用无效化。

示例

运行此代码

#include <locale.h>
#include <stdio.h>
#include <time.h>
#include <wchar.h>
 
int main(void)
{
    // the C locale will be UTF-8 enabled English;
    // decimal dot will be German
    // date and time formatting will be Japanese
    setlocale(LC_ALL, "en_US.UTF-8");
    setlocale(LC_NUMERIC, "de_DE.utf8");
    setlocale(LC_TIME, "ja_JP.utf8");
 
    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: 月曜日 2017年09月25日 13時00分15秒

参考

• C23 标准（ISO/IEC 9899:2024）

• 7.11.1.1 setlocale 函数（p: TBD）

• C17 标准（ISO/IEC 9899:2018）

• 7.11.1.1 setlocale 函数（p: 163-164）

• C11 标准（ISO/IEC 9899:2011）

• 7.11.1.1 setlocale 函数（p: 224-225）

• C99 标准（ISO/IEC 9899:1999）

• 7.11.1.1 setlocale 函数（p: 205-206）

• C89/C90 标准（ISO/IEC 9899:1990）

• 4.4.1.1 setlocale 函数

参见

LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME	用于 setlocale 的区域设置类别 (宏常量)
C++ 文档 for setlocale

外部链接

1.	Windows 区域设置名称列表.
2.	Linux 区域设置名称列表.