ИМЯ

       wcsrtombs - преобразует широкосимвольную строку в многобайтовую строку

LIBRARY

       Standard C library (libc, -lc)

СИНТАКСИС

       #include <wchar.h>

       size_t wcsrtombs(char dest[restrict .len], const wchar_t **restrict src,
                        size_t len, mbstate_t *restrict ps);

ОПИСАНИЕ

       Если  dest  не  равно  NULL, функция wcsrtombs() преобразует широкосимвольную строку *src в многобайтовую
       строку, начиная с dest. В dest будет записано максимум len байтов. Обновляется состояние смещения в  *ps.
       Замена  происходит  путем  повторяющихся вызовов wcrtomb(dest, *src, ps) до тех пор, пока они выполняются
       без ошибок. При этом значение dest увеличивается на количество записанных байтов, а *src  —  на  единицу.
       Замена может быть остановлена в трех случаях:

       •  Встретившийся   широкий   символ   нельзя  представить  в  виде  многобайтовой  последовательности  (в
          соответствии с текущей системной локалью). В этом случае *src будет указывать на неправильный  широкий
          символ, возвращается (size_t) -1, а значение errno становится равным EILSEQ.

       •  Остановка  при  достижении  ограничения  длины.  В этом случае *src также будет указывать на следующий
          широкий символ, подлежащий преобразованию, и возвращается количество байтов, записанных в dest.

       •  The wide-character string has been completely converted, including the terminating null wide character
          (L'\0'), which has the side effect of bringing back *ps to the initial state.  In this case,  *src  is
          set  to  NULL, and the number of bytes written to dest, excluding the terminating null byte ('\0'), is
          returned.

       Если значение dest равно NULL, то  len  игнорируется  и  преобразование  выполняется  как  описано  выше,
       исключая то, что преобразованные байты не записываются в память и нет ограничения по длине.

       В  обоих  перечисленных  случаях,  если  ps  равно NULL, то используется статическое анонимное состояние,
       известное только функции wcsrtombs().

       Программист должен быть уверен, что в dest достаточно места для, по крайней мере, len байт.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       Функция wcsrtombs() возвращает количество байт в полученной многобайтовой последовательности, не  включая
       завершающий  байт  null.  Если встречается широкий символ, который невозможно преобразовать, возвращается
       (size_t) -1 и значение errno становится равным EILSEQ.

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).
       ┌─────────────┬──────────────────────┬──────────────────────────────────────────────────────────────────┐
       │ Интерфейс   │ Атрибут              │ Значение                                                         │
       ├─────────────┼──────────────────────┼──────────────────────────────────────────────────────────────────┤
       │ wcsrtombs() │ Безвредность в нитях │ MT-Unsafe race:wcsrtombs/!ps                                     │
       └─────────────┴──────────────────────┴──────────────────────────────────────────────────────────────────┘

СТАНДАРТЫ

       C11, POSIX.1-2008.

ИСТОРИЯ

       POSIX.1-2001, C99.

ПРИМЕЧАНИЯ

       Поведение wcsrtombs() зависит от категории LC_CTYPE текущей локали.

       Передавать NULL в качестве ps небезопасно при работе с нитями.

СМОТРИТЕ ТАКЖЕ

       iconv(3), mbsinit(3), wcrtomb(3), wcsnrtombs(3), wcstombs(3)

ПЕРЕВОД

       Русский перевод этой страницы руководства разработал Azamat Hackimov <azamat.hackimov@gmail.com>  и  Yuri
       Kozlov <yuray@komyakino.ru>

       Этот  перевод является свободной программной документацией; он распространяется на условиях общедоступной
       лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html  версии  3  или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если  вы  обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом
       разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.

Linux man-pages 6.8                               2 мая 2024 г.                                     wcsrtombs(3)