Man page - wcsrtombs(3)

Packages contains this manual

Available languages:

en fr es ja ru ro de

Manual

wcsrtombs

НАИМЕНОВАНИЕ
БИБЛИОТЕКА
ОБЗОР
ОПИСАНИЕ
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
АТРИБУТЫ
СТАНДАРТЫ
ИСТОРИЯ
ПРИМЕЧАНИЯ
СМОТРИТЕ ТАКЖЕ
ПЕРЕВОД

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

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

БИБЛИОТЕКА

Стандартная библиотека языка C ( 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).

Image grohtml-627021-1.png

СТАНДАРТЫ

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> и Kirill Rekhov <krekhov.dev@gmail.com>

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

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