C 语言标准库函数 - wctomb() - C 语言标准库

C 语言标准库 <stdlib.h> 函数 int wctomb(char *str, wchar_t wchar) 把宽字符 wchar 转换为它的多字节表示形式，并把它存储在 str 指向的字符数组的开头。

头文件

#include <stdlib.h>

函数原型

下面是 wctomb() 函数的原型

int wctomb(char *str, wchar_t wchar)

参数

str ：一个指针，指向一个足以存储多字节字符的数组
wchar ：类型为 wchar_t 的宽字符

返回值

如果 str 不为 NULL，wctomb() 函数返回写入字节数组中的字节数。如果 wchar 不能被表示为一个多字节序列，则会返回 -1
如果 str 为 NULL，如果编码具有移位状态，则 wctomb() 函数返回非零，如果编码是无状态的，则返回 0

范例

下面的范例演示了 wctomb() 函数的用法

/**
 * file: main.c
 * author: 简单教程(www.twle.cn)
 *
 * Copyright © 2015-2065 www.twle.cn. All rights reserved.
 */

#include <stdio.h>
#include <stdlib.h>

int main()
{
   int i;
   wchar_t wc = L'a';
   char *pmbnull = NULL;
   char *pmb = (char *)malloc(sizeof( char ));

   printf("要转换的宽字符：\n");
   i = wctomb( pmb, wc );
   printf("被转换的字符：%u\n", i);
   printf("多字节字符：%.1s\n", pmb);

   printf("当要转换的字符为 NULL 时尝试转换：\n");
   i = wctomb( pmbnull, wc );
   printf("被转换的字符：%u\n", i);
   /* 不会输出任何值 */
   printf("多字节字符：%.1s\n", pmbnull);

   return(0);
}

编译运行范例，输出结果如下

$ gcc main.c && ./a.out
要转换的宽字符：
被转换的字符：1
多字节字符：a
当要转换的字符为 NULL 时尝试转换：
被转换的字符：0
多字节字符：(