Функция wcstomb

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

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

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

Описание

Преобразование строки с широкими символами в строку с многобайтовыми символами.

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

Параметры:

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

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

Количество байтов  переведенных и записанных в mbstring, не считая нуль-символ.
Если встречается недопустимый символ, возвращается значение -1.