C语言标准库函数setlocale用法详解

C语言标准库函数setlocale用法详解

C语言标准库函数setlocale定义在 <locale.h> 头文件中(在C++编程中,这个头文件等价于 <clocale> )。

原型:

c 复制代码
char* setlocale (int category, const char* locale);

函数参数解析

category

int类型,可以取以下几个值:

影响范围
LC_ALL 全部更改为传入的locale
LC_COLLATE 影响字符串比较函数 strcol1()和 strxfrm()。
LC_CTYPE 影响字符处理函数的行为。
LC_MONETARY 影响货币格式
LC_NUMERIC 影响 printf() 的数字格式
LC_TIME 影响时间格式 strftime()和 wcsftime()。

locale

locale参数是字符串(char*)类型,有以下几种写法:

| "language[_country-region[.code-page]]"

  1. 名称写法,例如中文多字节代码页""
  2. Windows特有的代码页写法 ".code-page",例如936代码页的locale,".936";65001代码页的locale,".65001"。
  3. 通用选项"C"、""、NULL

常见的locale本地化参数效果如下表所示:

效果
"C" 采用仅支持ASCII的最小本地化配置
NULL 不改变任何设置,函数仅返回当前的locale名称
"" 采用当前系统环境的默认代码页。例如中文Windows系统默认的locale为ANSI/OEM 936
".utf8" 使用UTF-8本地化
".utf-8" 使用UTF-8本地化
"en_us.utf8" 使用UTF-8本地化
"LC_MONETARY=en-US;LC_TIME=ja-JP" 货币使用en-US本地化(美国货币符号),时间使用ja-JP本地化(日本时间格式)

更多设置格式,可参考文末UCRT Locale names, Languages, and Country/Region strings链接。

应用

本节给出setlocale函数的具体应用,以便读者体会其功能。

应用1:在控制台打印宽字符

为输出宽字符,调用setlocale是必要的。

看一段例程:

c 复制代码
/* setlocale example */
#include <stdio.h>      /* printf */
#include <time.h>       /* time_t, struct tm, time, localtime, strftime */
#include <locale.h>     /* struct lconv, setlocale, localeconv */

int main ()
{
    wchar_t* pstr0=L"Wide Character Test 0\n";
    wprintf(pstr0);
    wchar_t* pstr1=L"宽字符测试1\n";
    wprintf(pstr1);
    setlocale(LC_ALL,"");
    wchar_t* pstr2=L"宽字符测试2\n";
    wprintf(pstr2);
    return 0;
}

运行后得到如下输出:

Wide Character Test 0

宽字符测试2

也就是说,调用setlocale之前,程序的默认本地化环境是 "C" ,只支持 ASCII 字符,中日韩等非ASCII字符会被视为无效字符。

而wprintf函数输出字符串到控制台时,需要先将UTF-16编码的字符数据转换成多字节编码(如GBK、UTF-8等)数据。调用setlocale之前,包含了中日韩字符的字符串转换过程必失败,从而导致L"宽字符测试1"未被输出。

将setlocale的调用位置放到程序最开始,再次尝试:

c 复制代码
/* setlocale example */
#include <stdio.h>      /* printf */
#include <time.h>       /* time_t, struct tm, time, localtime, strftime */
#include <locale.h>     /* struct lconv, setlocale, localeconv */

int main ()
{
    setlocale(LC_ALL,"");
    wchar_t* pstr0=L"Wide Character Test 0\n";
    wprintf(pstr0);
    wchar_t* pstr1=L"宽字符测试1\n";
    wprintf(pstr1);
    wchar_t* pstr2=L"宽字符测试2\n";
    wprintf(pstr2);
    return 0;
}

运行后得到如下输出:

Wide Character Test 0

宽字符测试1

宽字符测试2

应用2:控制货币、时间日期格式

请运行代码以切实体会setlocale的不同参数对货币符号、时间日期格式的影响:

c 复制代码
/* setlocale example */
#include <stdio.h>      /* printf */
#include <time.h>       /* time_t, struct tm, time, localtime, strftime */
#include <locale.h>     /* struct lconv, setlocale, localeconv */

int main ()
{
  time_t rawtime;
  struct tm * timeinfo;
  char buffer [80];

  struct lconv * lc;

  time ( &rawtime );
  timeinfo = localtime ( &rawtime );

  int twice=0;

  do {
    printf ("Locale is: %s\n", setlocale(LC_ALL,NULL) );

    strftime (buffer,80,"%c",timeinfo);
    printf ("Date is: %s\n",buffer);

    lc = localeconv ();
    printf ("Currency symbol is: %s\n-\n",lc->currency_symbol);

    setlocale (LC_ALL,"");
  } while (!twice++);

  return 0;

命令行输出结果为:

参考

来自cplusplus.com的setlocale函数定义与示例

微软文档:

setlocale, _wsetlocale
UCRT Locale names, Languages, and Country/Region strings

相关推荐
双叶83617 分钟前
(C++)学生管理系统(正式版)(map数组的应用)(string应用)(引用)(文件储存的应用)(C++教学)(C++项目)
c语言·开发语言·数据结构·c++
is08152 小时前
STM32的 syscalls.c 和 sysmem.c
c语言·stm32·嵌入式硬件
学不动CV了3 小时前
数据结构---链表结构体、指针深入理解(三)
c语言·arm开发·数据结构·stm32·单片机·链表
liulilittle7 小时前
C++ i386/AMD64平台汇编指令对齐长度获取实现
c语言·开发语言·汇编·c++
V我五十买鸡腿9 小时前
顺序栈和链式栈
c语言·数据结构·笔记·算法
森焱森17 小时前
水下航行器外形分类详解
c语言·单片机·算法·架构·无人机
small_wh1te_coder21 小时前
硬件嵌入式学习路线大总结(一):C语言与linux。内功心法——从入门到精通,彻底打通你的任督二脉!
linux·c语言·汇编·嵌入式硬件·算法·c
黑听人1 天前
【力扣 简单 C】70. 爬楼梯
c语言·leetcode
杜子不疼.1 天前
二分查找,乘法口诀表,判断闰年,判断素数,使用函数实现数组操作
c语言