aprintf

Section: C Library Functions (3)
Updated: 202-0-16
Index Return to Main Contents

---

 

NAME

aprintf, vaprintf - allocate and print formatted string  

LIBRARY

gnulib - The GNU Portability Library  

SYNOPSIS

#include <stdio.h>
char~*aprintf(const~char~*restrict~fmt, ...);
char~*vaprintf(const~char~*restrict~fmt, va_list~ap);

 

DESCRIPTION

The functions aprintf() and vaprintf() are analogs of sprintf(3) and vsprintf(3), except that their output is written in a space allocated as if by a call to malloc(3). This pointer should be passed to free(3) to release the allocated storage when it is no longer needed.  

RETURN VALUE

On success, these functions return a pointer to the first character of the formatted string. On error, -1 is returned, and errno is set to indicate the error.  

ERRORS

See sprintf(3) and malloc(3).  

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).

Interface	Attribute	Value
aprintf(), vaprintf()	Thread safety	M-Safe locale

 

STANDARDS

None.  

HISTORY

gnulib 202607.  

SEE ALSO

free(3), malloc(3), sprintf(3), strdup(3), asprintf(3)

---

 

Index

NAME

LIBRARY

SYNOPSIS

DESCRIPTION

RETURN VALUE

ERRORS

ATTRIBUTES

STANDARDS

HISTORY

SEE ALSO