Функция mbstowcs

Содержание

#include <stdlib.h>
size_t mbstowcs(wchar_t *out, const char *in, size_t size);

Функция mbstowcs() преобразует многобайтовую строку, адресуемую параметром in, в строку, состоящую из двухбайтовых символов, и помещает результат в массив, адресуемый параметром out. В массиве out будет сохранено в памяти только size байтов.

В версии С99 к параметрам out и in применен квалификатор restrict.

Функция mbstowcs() возвращает количество преобразованных многобайтовых символов. При возникновении ошибки функция возвращает значение -1.

Пример


Этот оператор преобразует первые четыре символа в многобайтовой строке, адресуемой указателем mb, и помещает результат в str.

mbstowcs(str, mb, 4);

Зависимые функции


wcstombs() mbtowc()