C 库函数 - wctomb()

描述

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

声明

下面是 wctomb() 函数的声明。

  1. int wctomb(char *str, wchar_t wchar)

参数

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

返回值

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

实例

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

  1. #include <stdio.h>
  2. #include <stdlib.h>
  4. int main()
  5. {
  6.    int i;
  7.    wchar_t wc = L'a';
  8.    char *pmbnull = NULL;
  9.    char *pmb = (char *)malloc(sizeof( char ));
  11.    printf("要转换的宽字符：\n");
  12.    i = wctomb( pmb, wc );
  13.    printf("被转换的字符：%u\n", i);
  14.    printf("多字节字符：%.1s\n", pmb);
  16.    printf("当要转换的字符为 NULL 时尝试转换：\n");
  17.    i = wctomb( pmbnull, wc );
  18.    printf("被转换的字符：%u\n", i);
  19.    /* 不会输出任何值 */
  20.    printf("多字节字符：%.1s\n", pmbnull);
  22.    return(0);
  23. }

让我们编译并运行上面的程序，这将产生以下结果：

  1. 要转换的宽字符：
  2. 被转换的字符：1
  3. 多字节字符：a
  4. 当要转换的字符为 NULL 时尝试转换：
  5. 被转换的字符：0
  6. 多字节字符：