std::wcsrtombs
STD::wcsrtombs
Defined in header | | |
---|---|---|
std::size_t wcsrtombs( char* dst, const wchar_t** src, std::size_t len, std::mbstate_t* ps | | |
从第一个元素指向的数组中转换宽字符序列。*src
的转换状态开始的窄的多字节表示形式。*ps
.如果dst
不为空,转换后的字符存储在char数组的连续元素中。dst
.不超过len
字节被写入目标数组。
每个字符被转换为调用std::wcrtomb
.在下列情况下停止转换:
- 空字符被转换并存储。
src
设置为NULL
和*ps
表示初始移位状态。
- 阿
wchar_t
被发现与当前C语言环境中的有效字符不对应。src
设置为指向第一个未转换的宽字符。
- 要存储的下一个多字节字符将超过
len
...src
设置为指向第一个未转换的宽字符。如果没有检查此条件,则不检查此条件。dst==
NULL
...
参数
dst | - | pointer to narrow character array where the multibyte characters will be stored |
---|---|---|
src | - | pointer to pointer to the first element of a null-terminated wide string |
len | - | number of bytes available in the array pointed to by dst |
ps | - | pointer to the conversion state object |
返回值
成功后,返回字节数%28,包括任何移位序列,但不包括终止'\0'
将%29写入第一个元素指向的字符数组dst
.如果dst==
NULL
,返回将再次写入%28的字节数,不包括终止空字符。'\0'
29%。
在转换错误%28时,如果遇到无效的宽字符%29,则返回static_cast<std::size_t>(-1)、商店EILSEQ在errno,还有树叶*ps处于未指定的状态。
例
二次
#include <iostream>
#include <vector>
#include <clocale>
#include <string>
#include <cwchar>
void print_wide(const wchar_t* wstr)
{
std::mbstate_t state = std::mbstate_t(
int len = 1 + std::wcsrtombs(nullptr, &wstr, 0, &state
std::vector<char> mbstr(len
std::wcsrtombs(&mbstr[0], &wstr, mbstr.size(), &state
std::cout << "multibyte string: " << &mbstr[0] << '\n'
<< "Length, including '\\0': " << mbstr.size() << '\n';
}
int main()
{
std::setlocale(LC_ALL, "en_US.utf8"
// UTF-8 narrow multibyte encoding
const wchar_t* wstr = L"z\u00df\u6c34\U0001d10b"; // or L"zß水?"
print_wide(wstr
}
二次
产出:
二次
multibyte string: zß水?
Length, including '\0': 11
二次
另见
wcrtomb | converts a wide character to its multibyte representation, given state (function) |
---|---|
mbsrtowcs | converts a narrow multibyte character string to wide string, given state (function) |
do_out virtual | converts a string from internT to externT, such as when writing to file (virtual protected member function of std::codecvt) |
wcsrtomb文档
© cppreference.com
在CreativeCommonsAttribution下授权-ShareAlike未移植许可v3.0。