C/C++ 中的 mbrtoc32() 函数及示例


本文将讨论 C++ STL 中 std::mbrtoc32() 函数的工作原理、语法和示例。

什么是 std::mbrtoc32()?

std::mbrtoc32() 函数是 C++ STL 中的内置函数,定义在 <cuchar> 头文件中。此函数用于将窄多字节字符转换为 UTF-32 字符表示。

如果关联的字符指针不为空,并且所有其他参数也被接受,则它将转换相应的 32 位字符。

语法

size_t mbrtoc32( char32_t* pc32, char* str, size_t n, mbstate_t* ps);

参数

该函数接受以下参数:

  • pc32 − 这是我们希望将输出存储到的位置的指针。
  • str − 用作输入的字符字符串。
  • n − 要检查的字节数。
  • ps − 当我们解释多字节字符串时,它是指向状态对象的指针。

返回值

此函数的返回值根据以下条件而有所不同:

  • 0 − 当要转换的 str 中的字符为空字符时,函数将返回零。
  • 1…n − 从字符字符串 *str 转换的多字节字符的字节数。
  • -3 − 如果存在代理对,这意味着 char32_t 来自多 char32_t。输入中不应创建任何字节。
  • -2 − 当接下来的 n 个字节不完整但到目前为止是有效的多字节字符时,我们将得到 -2。
  • -1 − 当我们遇到编码错误时,我们将得到 -1,没有任何内容写入 *pc32。

示例

在线演示

#include <cstdio>
#include <cstdlib>
#include <iostream>
#include <uchar.h>
#include <wchar.h>
using namespace std;
int main(void) {
   char32_t hold;
   char str[] = "I";
   mbstate_t arr{};
   int len;
   // initializing the function
   len = mbrtoc32(&hold, str, MB_CUR_MAX, &arr);
   if (len < 0) {
      perror("conversion failed");
      exit(-1);
   }
   cout << "String is: " << str << endl;
   cout << "Length is: " << len << endl;
   printf("32-bit character = 0g%02hd\n", hold);
}

输出

String is: I
Length is: 1
32-bit character = 0g73

示例

在线演示

#include <cstdio>
#include <cstdlib>
#include <iostream>
#include <uchar.h>
#include <wchar.h>
using namespace std;
int main(void){
   char32_t hold;
   char str[] = "I";
   mbstate_t arr{};
   int len;
   // initializing the function
   len = mbrtoc32(&hold, str, MB_CUR_MAX, &arr);
   if (len < 0){
      perror("conversion failed");
      exit(-1);
   }
   cout << "String is: " << str << endl;
   cout << "Length is: " << len << endl;
   printf("32-bit character = 0x%08hx\n", hold);
}

输出

String is: I
Length is: 1
32-bit character = 0x0x000000490

更新于:2020年4月17日

144 次浏览

开启您的 职业生涯

完成课程获得认证

开始学习
广告