LC_ALL, LC_COLLATE, LC_CTYPE, LC_MONETARY, LC_NUMERIC, LC_TIME

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

本地化支持

setlocale

localeconv

lconv

本地环境类别

LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME

 

在标头 <locale.h> 定义
#define LC_ALL      /*由实现定义*/
#define LC_COLLATE  /*由实现定义*/
#define LC_CTYPE    /*由实现定义*/
#define LC_MONETARY /*由实现定义*/
#define LC_NUMERIC  /*由实现定义*/
#define LC_TIME     /*由实现定义*/

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

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

<locale.h> 中可以定义附加宏常量，名称以 LC_ 后随至少一个大写字母开始。例如， POSIX 规范要求 LC_MESSAGES（此外还控制 perror 和 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）。

注意

glibc 中的本地环境类别

glibc 除了 C 标准要求的 5 个类别外，还额外支持 7 个类别，以及一个默认项：

glibc 本地环境类别常量	解释
LC_ADDRESS	选择 C 本地环境中的邮政地址格式类别
LC_IDENTIFICATION	选择 C 本地环境中的类别版本与状态
LC_KEYBOARD	选择 C 本地环境中的键盘鉴别类别
LC_MEASUREMENT	选择 C 本地环境中的度量系统信息类别
LC_NAME	选择 C 本地环境中的人名书写格式类别
LC_PAPER	选择 C 本地环境中的纸张格式类别
LC_TELEPHONE	选择 C 本地环境中的电话号码格式（和其他电话信息）类别
LANG	选择尚未指定的类别

其中 LC_ALL 的优先级高于所有特定类别，而每个特定类别都优先于 LANG 。具体而言：

1. 若设置 LC_ALL 为 "zh_CN.UTF-8" ，则不论 LC_* 和 LANG 原为何值，每个分类都会被设为 "zh_CN.UTF-8" 。
2. 若未设置 LC_ALL ，而专门设置 LANG 为 "zh_CN.UTF-8" ，并设置某 LC_* 为"en_US.UTF-8" ，则其所对应的本地环境类别被设为 "en_US.UTF-8" 。
3. 若未设置 LC_ALL 和某些类别的 LC_* ，并设置 LANG 为 "zh_CN.UTF-8" ，则这些 LC_* 所对应的本地环境被设为 "zh_CN.UTF-8" 。

所以，对于不同的目的，应该用不同方式设置本地环境：

• 例如，若需要纯中文的系统，则可调用 setlocale(LC_ALL, "zh_CN.UTF-8") 或 setlocale(LANG, "zh_CN.UTF-8") 。可以但没必要设置二次。
• 若只需要输入中文的环境，而其他界面信息和格式为英文，则可使用

setlocale(LC_CTYPE, "zh_CN.UTF-8");
setlocale(LANG, "en_US.UTF-8");

• 若有特殊的本地环境定制需求，例如使用中文 GBK 字符集、用 ISO-8859-1 字符集的大英数字系统、用 ISO-8859-15 字符集的德国度量系统……，则应逐一设置 LC_* ：

setlocale(LC_TYPE, "zh_CN.GBK/GBK");
setlocale(LC_NUMERIC, "en_GB.ISO-8859-1");
setlocale(LC_MESUREMENT, "de_DE.ISO-8859-15@euro");
// 以及其他类别

• 若只需要应用默认 "C" （ "POSIX" 为其别名）本地环境，则无需任何设置代码。

示例

运行此代码

#include <locale.h>
#include <stdio.h>
#include <time.h>
#include <wchar.h>
 
int main(void)
{
    setlocale(LC_ALL, "en_US.UTF-8"); // C 本地环境将为启用 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: 金曜日 2023年09月15日 20時04分14秒

引用

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

• 7.11/3 Localization <locale.h> （第 TBD 页）

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

• 7.11/3 Localization <locale.h> （第 TBD 页）

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

• 7.11/3 Localization <locale.h> （第 224 页）

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

• 7.11/3 Localization <locale.h> （第 205 页）

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

• 4.4 LOCALIZATION <locale.h>

参阅

setlocale

获取和设置当前 C 本地环境 (函数)