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

      mbsrtowcs

      Материал из cppreference.com

      Эта страница была переведена автоматически с английской версии вики используя Переводчик Google. Перевод может содержать ошибки и странные формулировки.

      Наведите курсор на текст, чтобы увидеть оригинал. Щёлкните здесь, чтобы увидеть английскую версию этой страницы.

      (Вы можете помочь в исправлении ошибок и улучшении перевода. Для инструкций перейдите по ссылке.)

      <metanoindex/>

       
      C
       
      Библиотека работы со строками
       
      Null-завершенный многобайтовых строк
      Широкий / многобайтовую преобразований
      Оригинал:
      Wide/multibyte conversions
      Текст был переведён автоматически используя Переводчик Google.
      Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
      Типы
      Оригинал:
      Types
      Текст был переведён автоматически используя Переводчик Google.
      Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
       
      <tbody> </tbody>
      Определено в заголовочном файле <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.
      Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
      Каждый многобайтовых символов превращается как бы призыв к mbrtowc. Преобразование прекращается, если:
      Оригинал:
      Each multibyte character is converted as if by a call to mbrtowc. The conversion stops if:
      Текст был переведён автоматически используя Переводчик Google.
      Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
      • Многобайтовых нулевого символа был преобразован и сохранен. src установлен в NULL и *ps представляет начальное состояние сдвига.
        Оригинал:
        The multibyte null character was converted and stored. src is set to NULL and *ps represents the initial shift state.
        Текст был переведён автоматически используя Переводчик Google.
        Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
      • Недопустимый символ многобайтовых (в соответствии с действующим языка 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.
        Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
      • Следующий широкий символ, который будет храниться будет превышать 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.
        Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

      Параметры

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

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

      В случае успеха, возвращается количество широких символов, исключая завершающий 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.
      Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
      На ошибки преобразования (если недействительных многобайтовых символов встречается), возвращается (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.
      Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

      Пример

      Этот раздел не завершён
      Причина: нет примера

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

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

      (функция) [править]
      Документация C++ по mbsrtowcs