Функция mbstowcs

Прототип функции mbstowcs:

size_t mbstowcs( wchar_t * wcstring, const char * mbstring, size_t max );

Заголовочный файл

Описание

Функция выполняет преобразование много-байтовой строки в строку широких символов. Строка с многобайтовыми символами передаётся в качестве аргумента, через указатель mbstring, посимвольно интерпретируется и переводится в эквивалентную строку типа wchar_t, который хранится в памяти, на которую указывает wcstring. В итоге, функция возвращает количество переведённых символов результирующей строки, не включая конечный нулевой символ.

Параметры:

• wcstring
  Указатель на строку типа wchar_t, для хранения широких символов.
• mbstring
  Указатель на строку с многобайтовыми символами.
• max Максимальное количество символов, для преобразования их в строку широких символов типа wchar_t.

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

Количество преобразованных символов, не считая конечный нулевой символ.
Если встречается недопустимый символ, функция возвращает значение: 1.