Пространства имён
Варианты
Действия

std::mbtowc

Материал из cppreference.com
< cpp‎ | string‎ | multibyte

Определено в заголовочном файле <cstdlib>
int mbtowc( wchar_t* pwc, const char* s, std::size_t n )
Преобразует многобайтовые знаки, первый байт, на который указывает s в широкий символ, написанный на *pwc если pwc не пустой.
Оригинал:
Converts a multibyte character whose first byte is pointed to by s to a wide character, written to *pwc if pwc is not null.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Если s является нулевым указателем, сбрасывает глобальное состояние преобразования и определяет, является ли сдвиг последовательности используются.
Оригинал:
If s is a null pointer, resets the global conversion state and determines whether shift sequences are used.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Содержание

[править] Параметры

s -
Указатель на многобайтовых символов
Оригинал:
pointer to the multibyte character
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
n -
ограничение на количество байт в сек, которые могут быть рассмотрены
Оригинал:
limit on the number of bytes in s that can be examined
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
pwc -
Указатель на широкий символ для вывода
Оригинал:
pointer to the wide character for output
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

[править] Возвращаемое значение

Если s не является нулевым указателем, возвращает количество байтов, содержащихся в многобайтовых символов или -1, если первый байт, на который указывает s не образуют действительный характер многобайтовых или 0 если s указывает на нулевой charcter '\0'.
Оригинал:
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'.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Если s является нулевым указателем, сбрасывает его внутреннее состояние преобразования представляют начальное состояние смену и возвращается 0, если текущая кодировка многобайтовых не зависящих от состояния (не используется сдвиг последовательности) или ненулевое значение, если текущая кодировка является многобайтовой зависящих от состояния (используется сдвиг последовательности).
Оригинал:
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).
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

[править] Заметки

Каждый вызов mbtowc обновления внутреннего состояния глобального преобразования (статический объект типа std::mbstate_t, известный только этой функции). Если кодировок используется сдвиг государства, необходимо соблюдать осторожность, чтобы избежать возвратов или нескольких сканов. В любом случае, несколько потоков не должно вызывать mbtowc без синхронизации: std::mbrtowc может быть использован вместо.
Оригинал:
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.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

[править] Пример

#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ß水𝄋

[править] См. также

преобразует следующий символ многобайтовых широкого характера, данное состояние
Оригинал:
converts the next multibyte character to wide character, given state
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(функция) [edit]
возвращает количество байтов в следующий символ многобайтовых
Оригинал:
returns the number of bytes in the next multibyte character
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(функция) [edit]
[virtual]
преобразует строку из externT в internT, например, при чтении из файла
Оригинал:
converts a string from externT to internT, such as when reading from file
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

(virtual protected std::codecvt функция-член) [edit]
C documentation for mbtowc