wcstombs(3) | Library Functions Manual | wcstombs(3) |
wcstombs - преобразует широкосимвольную строку в многобайтовую строку
Standard C library (libc, -lc)
#include <stdlib.h>
size_t wcstombs(char dest[restrict .n], const wchar_t *restrict src, size_t n);
Если значение dest не равно NULL, то функция wcstombs() преобразует широкосимвольную строку src в многобайтовую строку, начинающуюся с dest. В dest будет записано не более n байт. Последовательность символов, помещённая в dest, начинается с первоначальным состоянием сдвига. Преобразование может прекратиться по трём причинам:
Программист должен быть уверен, что в dest достаточно места для, по крайней мере, n байт.
Если значение dest равно NULL, то n игнорируется и преобразование выполняется как описано выше, исключая то, что преобразованные байты не записываются в память и нет ограничения по длине.
Для того, чтобы избежать ограничения пункта 2, программист должен удостовериться, что значение n больше или равно wcstombs(NULL,src,0)+1.
Функция wcstombs() возвращает количество байт в полученной многобайтовой последовательности, не включая завершающий байт null. Если встречается широкий символ, который невозможно преобразовать, возвращается (size_t) -1.
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение |
wcstombs() | Безвредность в нитях | MT-Safe |
POSIX.1-2001, POSIX.1-2008, C99.
Поведение wcstombs() зависит от категории LC_CTYPE текущей локали.
Функция wcsrtombs(3) предоставляет лучший интерфейс с теми же возможностями.
mblen(3), mbstowcs(3), mbtowc(3), wcsrtombs(3), wctomb(3)
Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com> и Yuri Kozlov <yuray@komyakino.ru>
Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.
5 февраля 2023 г. | Linux man-pages 6.03 |