mbrtoc16()是C /C++中的内置函数,它将狭窄的多字节字符转换为16位字符表示形式。它在C++的uchar.h头文件中定义。
用法:
ssize_t mbrtoc16( char16_t* pc16, const char* s, size_t n, mbstate_t* ps);
参数:该函数接受四个强制性参数,如下所述:
- s:指定要转换的多字节字符。
- pc16:指定存储位置以存储结果16位字符。
- n:指定s中要转换的最大字节数。
- ps:指定在解释多字节字符串时使用的mbstate_t对象。
返回值:该函数返回五个值,如下所示:
- 如果转换后的字符为空字符,则为0。
- 已成功转换为16位字符的多字节字符的字节数(最多n个)。
- 如果来自multi-char16_t字符的下一个char16_t(例如代理对)现在已写入* pc16,则为-3。在这种情况下,不会从输入中处理任何字节。
- -2,如果接下来的n个字节构成一个不完整但到目前为止有效的多字节字符。在这种情况下,不会将任何内容写入* pc16。
- 如果发生编码错误,则为-1。在这种情况下,不会将任何内容写入* pc16,将errno设置为EILSEQ,并且未指定* ps的值。
以下示例程序旨在说明上述函数。
程序1:
// C++ program to illustrate the
// mbrtoc16() function
#include <cstdio>
#include <cstdlib>
#include <iostream>
#include <uchar.h>
#include <wchar.h>
using namespace std;
int main(void)
{
char16_t pc16;
char s[] = "G";
mbstate_t ps{};
int length;
// initializing the function
length = mbrtoc16(&pc16, s, MB_CUR_MAX, &ps);
if (length < 0) {
perror("mbrtoc16() fails to convert");
exit(-1);
}
cout << "Multibyte string = " << s << endl;
cout << "Length = " << length << endl;
printf("16-bit character = 0g%02hd\n", pc16);
}
输出:
Multibyte string = G Length = 1 16-bit character = 0g71
程序2:
// C++ program to illustrate the
// mbrtoc16() function
#include <cstdio>
#include <cstdlib>
#include <iostream>
#include <uchar.h>
#include <wchar.h>
using namespace std;
int main(void)
{
char16_t pc16;
char s[] = "";
mbstate_t ps{};
int length;
// initializing the function
length = mbrtoc16(&pc16, s, MB_CUR_MAX, &ps);
if (length < 0) {
perror("mbrtoc16() fails to convert");
exit(-1);
}
cout << "Multibyte string = " << s << endl;
cout << "Length = " << length << endl;
printf("16-bit character = 1e%04xy\n", pc16);
}
输出:
Multibyte string = Length = 0 16-bit character = 1e0000y
相关用法
- C++ cin get()用法及代码示例
- C++ ratio_not_equal()用法及代码示例
- C++ ios bad()用法及代码示例
- C++ mbrtoc32()用法及代码示例
- C++ ratio_equal()用法及代码示例
- C++ ios eof()用法及代码示例
注:本文由纯净天空筛选整理自RICHIK BHATTACHARJEE大神的英文原创作品 mbrtoc16() in C/C++ with Examples。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。