Функция wcstombs () в C ++ преобразует строку широких символов в эквивалентную многобайтовую последовательность.
Функция wcstombs () определена в заголовочном файле.
прототип wcstombs ()
size_t wcstombs (char * dest, const wchar_t * src, size_t max);
Функция wcstombs () принимает три аргумента и возвращает целочисленное значение.
Эта функция преобразует строку широких символов, первый элемент которой указан src, в ее многобайтовое представление.
Результат сохраняется в ячейке памяти, указанной dest. Параметр max представляет максимальное количество преобразовываемых широких символов.
Механизм преобразования такой же, как у wctomb, за исключением того, что это не влияет на состояние преобразования wctomb. Преобразование прекращается, если:
- Встречается нулевой символ, который затем преобразуется и сохраняется.
- Обнаружен wchar_t, который не соответствует допустимому символу в текущей локали C.
- преобразовано максимальное количество широких символов.
Параметры wcstombs ()
- dest: указатель на результирующий массив многобайтовых символов.
- src: указатель на первый элемент широкого символа, который преобразуется в многобайтовый символ.
- max: Максимальное количество широких символов для преобразования.
wcstombs () Возвращаемое значение
- Если преобразование прошло успешно, wcstombs () возвращает количество многобайтовых символов, исключая завершающий символ (например, ' 0'), которые записываются в целевой массив.
- Если во время преобразования возникает какая-либо ошибка, возвращается -1.
Пример: как работает функция wcstombs ()?
#include #include using namespace std; int main() ( wchar_t src() = L"Welcome To Programiz.com"; char dest(50); int num; num = wcstombs(dest, src, 50); cout << "Number of wide character converted = " << num << endl; cout << "Multibyte Character String = " << dest << endl; return 0; )
Когда вы запустите программу, возможный результат будет:
Количество преобразованных широких символов = 24 Многобайтовая строка символов = Добро пожаловать на Programiz.com
