ИМЯ¶

asprintf, vasprintf - выводит данные в строку, выделенную в памяти

СИНТАКСИС¶

#define _GNU_SOURCE /* смотрите feature_test_macros(7) */
#include <stdio.h>

int asprintf(char **strp, const char *fmt, ...);

int vasprintf(char **strp, const char *fmt, va_list ap);

ОПИСАНИЕ¶

Функции asprintf и vasprintf являются аналогами sprintf(3) и vsprintf(3), отличаясь только тем, что они выделяют в памяти строку, достаточную для размещения результата, включая конечный байт null ('\0'), и возвращают указатель на эту строку через первый аргумент. Для высвобождения выделенной памяти указатель должен быть передан функции free(3).

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

При успешном выполнении эти функции, подобно sprintf(3), возвращают количество выведенных байтов. Если выделить память не удалось или произошла какая-либо другая ошибка, то эти функции возвращают -1. При этом содержимое strp не определено.

АТРИБУТЫ¶

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

СООТВЕТСТВИЕ СТАНДАРТАМ¶

Эти функции являются расширениями GNU, они отсутствуют в C и POSIX. Также они доступны в *BSD. В FreeBSD при ошибке strp присваивается значение NULL.

СМ. ТАКЖЕ¶

free(3), malloc(3), printf(3)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД¶

Русский перевод этой страницы руководства был сделан Dmitry Bolkhovskikh <d20052005@yandex.ru> и Yuri Kozlov <yuray@komyakino.ru>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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