std::mbtowc

 

C++

Язык

Понятия (концепции)

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод / вывод

Локализация

Регулярные выражения (C++11)

Атомарные примитивы (C++11)

Потоки (C++11)

 

Строки

Нуль-терминальные строки

Однобайтовые строки

Многобайтовые строки

Широкие строки

Классы

basic_string

char_traits

 

Null-завершенный многобайтовых строк

Широкий / многобайтовую преобразований Original: Wide/multibyte conversions The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
mbsinit
mbtowc mbstowcs btowc mbrtowc mbsrtowcs mbrtoc16 (C++11) mbrtoc32 (C++11) mblen	wctomb wcstombs wctob wcrtomb wcsrtombs c16rtomb (C++11) c32rtomb (C++11) mbrlen
Типы Original: Types The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
mbstate_t

 

Заголовочный файл <cstdlib>
int mbtowc( wchar_t* pwc, const char* s, std::size_t n )

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

Original:

Converts a multibyte character whose first byte is pointed to by s to a wide character, written to *pwc if pwc is not null.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Если s является нулевым указателем, сбрасывает глобальное состояние преобразования и определяет, является ли сдвиг последовательности используются.

Original:

If s is a null pointer, resets the global conversion state and determines whether shift sequences are used.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Параметры

s	-	Указатель на многобайтовых символов Original: pointer to the multibyte character The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
n	-	ограничение на количество байт в сек, которые могут быть рассмотрены Original: limit on the number of bytes in s that can be examined The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
pwc	-	Указатель на широкий символ для вывода Original: pointer to the wide character for output The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.

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

Если s не является нулевым указателем, возвращает количество байтов, содержащихся в многобайтовых символов или -1, если первый байт, на который указывает s не образуют действительный характер многобайтовых или ​0​ если s указывает на нулевой charcter '\0'.

Original:

If s is not a null pointer, returns the number of bytes that are contained in the multibyte character or -1 if the first bytes pointed to by s do not form a valid multibyte character or ​0​ if s is pointing at the null charcter '\0'.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

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

Original:

If s is a null pointer, resets its internal conversion state to represent the initial shift state and returns ​0​ if the current multibyte encoding is not state-dependent (does not use shift sequences) or a non-zero value if the current multibyte encoding is state-dependent (uses shift sequences).

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Notes

Каждый вызов mbtowc обновления внутреннего состояния глобального преобразования (статический объект типа std::mbstate_t, известный только этой функции). Если кодировок используется сдвиг государства, необходимо соблюдать осторожность, чтобы избежать возвратов или нескольких сканов. В любом случае, несколько потоков не должно вызывать mbtowc без синхронизации: std::mbrtowc может быть использован вместо.

Original:

Each call to mbtowc updates the internal global conversion state (a static object of type std::mbstate_t, only known to this function). If the multibyte encoding uses shift states, care must be taken to avoid backtracking or multiple scans. In any case, multiple threads should not call mbtowc without synchronization: std::mbrtowc may be used instead.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Пример

#include <iostream>
#include <clocale>
#include <cstring>
#include <cstdlib>
 
int print_mb(const char* ptr)
{
    std::mbtowc(NULL, 0, 0); // reset the conversion state
    const char* end = ptr + std::strlen(ptr);
    int ret;
    for (wchar_t wc; (ret = std::mbtowc(&wc, ptr, end-ptr)) > 0; ptr+=ret) {
        std::wcout << wc;
    }
    std::wcout << '\n';
    return ret;
}
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    const char* str = u8"z\u00df\u6c34\U0001d10b"; // or u8"zß水𝄋"
                      // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b";
    print_mb(str);
}

Вывод:

zß水𝄋

См. также

mbrtowc	преобразует следующий символ многобайтовых широкого характера, данное состояние Original: converts the next multibyte character to wide character, given state The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (функция)
mblen	возвращает количество байтов в следующий символ многобайтовых Original: returns the number of bytes in the next multibyte character The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (функция)
do_in [virtual]	преобразует строку из externT в internT, например, при чтении из файла Original: converts a string from externT to internT, such as when reading from file The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (virtual protected std::codecvt функция-член)
C документация для mbtowc