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

mbsrtowcs

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

 
 
 
Null-завершенный многобайтовых строк
Широкий / многобайтовую преобразований
Оригинал:
Wide/multibyte conversions
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
mbsinit
Типы
Оригинал:
Types
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
mbstate_t
 
Определено в заголовочном файле <wchar.h>
size_t mbsrtowcs( wchar_t* dst, const char** src, size_t len, mbstate_t* ps )
Преобразует нулем многобайтовую последовательность символов, которая начинается в преобразовании состояние, описываемое *ps, из массива, чей первый элемент, на который указывает *src его широкой представленности характер. Если dst не является нулевым, преобразованные символы хранятся в последовательных элементов массива wchar_t, на которую указывает dst. Не более широкий len символы записываются в массив назначения.
Оригинал:
Converts a null-terminated multibyte character sequence, which begins in the conversion state described by *ps, from the array whose first element is pointed to by *src to its wide character representation. If dst is not null, converted characters are stored in the successive elements of the wchar_t array pointed to by dst. No more than len wide characters are written to the destination array.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
Каждый многобайтовых символов превращается как бы призыв к mbrtowc. Преобразование прекращается, если:
Оригинал:
Each multibyte character is converted as if by a call to mbrtowc. The conversion stops if:
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
  • Многобайтовых нулевого символа был преобразован и сохранен. src установлен в NULL и *ps представляет начальное состояние сдвига.
    Оригинал:
    The multibyte null character was converted and stored. src is set to NULL and *ps represents the initial shift state.
    Текст был переведён автоматически через Google Translate.
    Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
  • Недопустимый символ многобайтовых (в соответствии с действующим языка C) была обнаружена. src установлен, чтобы указать на начало первого необращенных характер многобайтовых.
    Оригинал:
    An invalid multibyte character (according to the current C locale) was encountered. src is set to point at the beginning of the first unconverted multibyte character.
    Текст был переведён автоматически через Google Translate.
    Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
  • Следующий широкий символ, который будет храниться будет превышать len. src установлен, чтобы указать на начало первого необращенных характер многобайтовых. Это условие не проверяется, если dst==NULL.
    Оригинал:
    the next wide character to be stored would exceed len. src is set to point at the beginning of the first unconverted multibyte character. This condition is not checked if dst==NULL.
    Текст был переведён автоматически через Google Translate.
    Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

Содержание

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

dst -
Указатель на широкий массив символов, где результаты будут сохранены
Оригинал:
pointer to wide character array where the results will be stored
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
src -
Указатель на указатель на первый элемент нулем многобайтовую строку
Оригинал:
pointer to pointer to the first element of a null-terminated multibyte string
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
len -
Число широких символов, доступных в массиве, на который указывает DST
Оригинал:
number of wide characters available in the array pointed to by dst
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
ps -
указатель на объект, состояние преобразования
Оригинал:
pointer to the conversion state object
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

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

В случае успеха, возвращается количество широких символов, исключая завершающий L'\0', написанные на массив символов.. Если dst==NULL, возвращает количество широких символов, которые были бы написаны данной неограниченной длины.
Оригинал:
On success, returns the number of wide characters, excluding the terminating L'\0', written to the character array.. If dst==NULL, returns the number of wide characters that would have been written given unlimited length.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
На ошибки преобразования (если недействительных многобайтовых символов встречается), возвращается (size_t)-1, магазины EILSEQ в errno, и оставляет *ps в неопределенное состояние.
Оригинал:
On conversion error (if invalid multibyte character was encountered), returns (size_t)-1, stores EILSEQ in errno, and leaves *ps in unspecified state.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

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

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

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

(функция) [edit]
Преобразует строку широких к узким многобайтовой строки символов, данное состояние
Оригинал:
converts a wide string to narrow multibyte character string, given state
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

(функция) [edit]
C++ documentation for mbsrtowcs