ИМЯ

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

LIBRARY

       Standard C library (libc, -lc)

СИНТАКСИС

       #include <wchar.h>

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

   Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

       wcsnrtombs():
           Начиная с glibc 2.10:
               _POSIX_C_SOURCE >= 200809L
           До glibc 2.10:
               _BSD_SOURCE

ОПИСАНИЕ

       Функция   wcsnrtombs()  похожа  на  функцию  wcsrtombs(3),  исключая  то,  что  количество
       преобразуемых широких символов, начиная с *src, ограничено nwc.

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

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

       •  nwc wide characters have been converted without  encountering  a  null  wide  character
          (L'\0'), or the length limit forces a stop.  In this case, *src is left pointing to the
          next wide character to be converted, and  the  number  of  bytes  written  to  dest  is
          returned.

       •  The wide-character string has been completely converted, including the terminating null
          wide character (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, то используется  статическое  анонимное
       состояние, известное только функции wcsnrtombs().

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

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

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

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).

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

СТАНДАРТЫ

       POSIX.1-2008.

ЗАМЕЧАНИЯ

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

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

СМ. ТАКЖЕ

       iconv(3), mbsinit(3), wcsrtombs(3)

ПЕРЕВОД

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

       Этот  перевод  является  бесплатной  документацией;  прочитайте  Стандартную  общественную
       лицензию GNU версии 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
       узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если вы обнаружите ошибки в переводе  этой  страницы  руководства,  пожалуйста,  отправьте
       электронное письмо на ⟨man-pages-ru-talks@lists.sourceforge.net⟩.