.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (C) 2001 Andries Brouwer <aeb@cwi.nl>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" Text fragments inspired by Martin Schulze <joey@infodrom.org>.
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH asprintf 3 "5 февраля 2023 г." "Linux man\-pages 6.03" 
.SH ИМЯ
asprintf, vasprintf \- выводит данные в строку, выделенную в памяти
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#define _GNU_SOURCE\fP         /* см. feature_test_macros(7) */
\fB#include <stdio.h>\fP
.PP
\fBint asprintf(char **restrict \fP\fIstrp\fP\fB, const char *restrict \fP\fIfmt\fP\fB, ...);\fP
\fBint vasprintf(char **restrict \fP\fIstrp\fP\fB, const char *restrict \fP\fIfmt\fP\fB,\fP
\fB              va_list \fP\fIap\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
The functions \fBasprintf\fP()  and \fBvasprintf\fP()  are analogs of
\fBsprintf\fP(3)  and \fBvsprintf\fP(3), except that they allocate a string large
enough to hold the output including the terminating null byte
(\[aq]\e0\[aq]), and return a pointer to it via the first argument.  This
pointer should be passed to \fBfree\fP(3)  to release the allocated storage
when it is no longer needed.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
При успешном выполнении эти функции, подобно \fBsprintf\fP(3), возвращают
количество выведенных байтов. Если выделить память не удалось или произошла
какая\-либо другая ошибка, то эти функции возвращают \-1. При этом содержимое
\fIstrp\fP не определено.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.ad l
.nh
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
\fBasprintf\fP(),
\fBvasprintf\fP()
T}	Безвредность в нитях	MT\-Safe locale
.TE
.hy
.ad
.sp 1
.SH СТАНДАРТЫ
Эти функции являются расширениями GNU, они отсутствуют в C и POSIX. Также
они доступны в *BSD. В FreeBSD при ошибке \fIstrp\fP присваивается значение
NULL.
.SH "СМ. ТАКЖЕ"
\fBfree\fP(3), \fBmalloc\fP(3), \fBprintf\fP(3)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Dmitry Bolkhovskikh <d20052005@yandex.ru>
и
Yuri Kozlov <yuray@komyakino.ru>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .