НАИМЕНОВАНИЕ

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

БИБЛИОТЕКА

       Стандартная библиотека языка C (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> и Kirill Rekhov <krekhov.dev@gmail.com>

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

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

Справочные страницы Linux 6.9.1                  15 июня 2024 г.                                   wcsnrtombs(3)