wcsnrtombs(3) | Library Functions Manual | wcsnrtombs(3) |
ИМЯ
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);
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 небезопасно при работе с нитями.
СМОТРИТЕ ТАКЖЕ
ПЕРЕВОД
Русский перевод этой страницы руководства разработал 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 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.
2 мая 2024 г. | Linux man-pages 6.8 |