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

mbstowcs

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

 
 
 
Null-завершенный многобайтовых строк
Широкий / многобайтовую преобразований
Оригинал:
Wide/multibyte conversions
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
mbsinit
Типы
Оригинал:
Types
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
mbstate_t
 
Определено в заголовочном файле <stdlib.h>
size_t mbstowcs( wchar_t* dst, const char* src, size_t len)
Преобразует строку многобайтовых символов из массива, чей первый элемент, на который указывает src его широкой представленности характер. Старинная символы хранятся в последовательных элементов массива, на который указывает dst. Не более широкий len символы записываются в массив назначения.
Оригинал:
Converts a multibyte character string from the array whose first element is pointed to by src to its wide character representation. Converted characters are stored in the successive elements of the array pointed to by dst. No more than len wide characters are written to the destination array.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Каждый персонаж превращается как бы призыв к mbtowc, за исключением того, что mbtowc состояние преобразования остается неизменным. Преобразование прекращается, если:
Оригинал:
Each character is converted as if by a call to mbtowc, except that the mbtowc conversion state is unaffected. The conversion stops if:
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
  • Многобайтовых нулевого символа был преобразован и сохранен.
    Оригинал:
    The multibyte null character was converted and stored.
    Текст был переведён автоматически используя Переводчик Google.
    Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
  • Недействительными (в текущей локали C) многобайтовых символов была обнаружена.
    Оригинал:
    An invalid (in the current C locale) multibyte character was encountered.
    Текст был переведён автоматически используя Переводчик Google.
    Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
  • Следующий широкий символ, который будет храниться будет превышать len.
    Оригинал:
    The next wide character to be stored would exceed len.
    Текст был переведён автоматически используя Переводчик Google.
    Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Содержание

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

В большинстве реализаций, эта функция обновления глобальный статический объект типа mbstate_t как он обрабатывает через строку, и не может быть вызвана одновременно из двух потоков, mbsrtowcs должны быть использованы в таких случаях.
Оригинал:
In most implementations, this function updates a global static object of type mbstate_t as it processes through the string, and cannot be called simultaneously by two threads, mbsrtowcs should be used in such cases.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
POSIX определяет общее расширение: если dst является нулевым указателем, то эта функция возвращает количество широких символов, которые будут записаны в dst, если преобразовать. Подобное поведение является стандартным для mbsrtowcs.
Оригинал:
POSIX specifies a common extension: if dst is a null pointer, this function returns the number of wide characters that would be written to dst, if converted. Similar behavior is standard for mbsrtowcs.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

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

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

В случае успеха, возвращается количество широких символов, исключая завершающий L'\0', написанные в массив назначения.
Оригинал:
On success, returns the number of wide characters, excluding the terminating L'\0', written to the destination array.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
На ошибки преобразования (если недействительных многобайтовых символов встречается), возвращается (size_t)-1.
Оригинал:
On conversion error (if invalid multibyte character was encountered), returns (size_t)-1.
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

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

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

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

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