std::mbrtowc

std::size_t mbrtowc( wchar_t* pwc,
                     const char* s,
                     std::size_t n,
                     std::mbstate_t* ps );

Преобразует узкий многобайтовый символ в широкий символ.

Если s не является нулевым указателем, проверяет не более n байтов строки многобайтовых символов, начиная с байта, на который указывает s, чтобы определить количество байтов, необходимое для завершения следующего многобайтового символа (включая любые последовательности переключения). Если функция определяет, что следующий многобайтовый символ в s является полным и корректным, она преобразует его в соответствующий широкий символ и сохраняет его в *pwc (если pwc не является нулевым указателем).

Если s является нулевым указателем, значения n и pwc игнорируются, а вызов эквивалентен std::mbrtowc(nullptr, "", 1, ps).

Если полученный широкий символ является нулевым символом, состояние преобразования, сохранённое в *ps, является исходным состоянием переключения.

Параметры

Возвращаемое значение

Первое из следующих подходящих значений:

• 0, если символ, преобразованный из s (и сохранённый в pwc, если он не является нулевым указателем), был нулевым символом.
• количество байтов [1...n] многобайтового символа, успешно преобразованного из s.
• static_cast<std::size_t>(-2), если следующие n байтов образуют неполный, но пока корректный многобайтовый символ. В *pwc ничего не записывается.
• static_cast<std::size_t>(-1), если произошла ошибка кодирования. В *pwc ничего не записывается, значение EILSEQ сохраняется в errno, а значение *ps остаётся неопределённым.

Пример

#include <clocale>
#include <cstring>
#include <cwchar>
#include <iostream>
 
void print_mb(const char* ptr)
{
    std::mbstate_t state = std::mbstate_t(); // initial state
    const char* end = ptr + std::strlen(ptr);
    int len;
    wchar_t wc;
    while ((len = std::mbrtowc(&wc, ptr, end-ptr, &state)) > 0)
    {
        std::wcout << "Next " << len << " bytes are the character " << wc << '\n';
        ptr += len;
    }
}

int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    const char* str = "z\u00df\u6c34\U0001d10b"; // or u8"zß水𝄋"
                      // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b";
    print_mb(str);
}

Next 1 bytes are the character z
Next 2 bytes are the character ß
Next 3 bytes are the character 水
Next 4 bytes are the character 𝄋

См. также