curl_printf(3) libcurl Manual curl_printf(3)NAME
curl_maprintf, curl_mfprintf, curl_mprintf,
curl_msnprintf, curl_msprintf curl_mvaprintf, curl_mvf-
printf, curl_mvprintf, curl_mvsnprintf, curl_mvsprintf -
formatted output conversion
SYNOPSIS
#include <curl/mprintf.h>
int curl_mprintf(const char *format, ...);
int curl_mfprintf(FILE *fd, const char *format, ...);
int curl_msprintf(char *buffer, const char *format, ...);
int curl_msnprintf(char *buffer, size_t maxlength, const
char *format, ...);
int curl_mvprintf(const char *format, va_list args);
int curl_mvfprintf(FILE *fd, const char *format, va_list
args);
int curl_mvsprintf(char *buffer, const char *format,
va_list args);
int curl_mvsnprintf(char *buffer, size_t maxlength, const
char *format, va_list args);
char *curl_maprintf(const char *format, ...);
char *curl_mvaprintf(const char *format, va_list args);
DESCRIPTION
These are all functions that produces output according to
a format string and given arguments. These are mostly
clones of the well-known C-style functions and there will
be no detailed explanation of all available formatting
rules and usage here.
See this table for notable exceptions.
curl_mprintf()
Normal printf() clone.
curl_mfprintf()
Normal fprinf() clone.
curl_msprintf()
Normal sprintf() clone.
curl_msnprintf()snprintf() clone. Many systems don't have
this. It is just like sprintf but with an
extra argument after the buffer that speci-
fies the length of the target buffer.
curl_mvprintf()
Normal vprintf() clone.
curl_mvfprintf()
Normal vfprintf() clone.
curl_mvsprintf()
Normal vsprintf() clone.
curl_mvsnprintf()vsnprintf() clone. Many systems don't have
this. It is just like vsprintf but with an
extra argument after the buffer that speci-
fies the length of the target buffer.
curl_maprintf()
Like printf() but returns the output string
as a malloc()ed string. The returned string
must be free()ed by the receiver.
curl_mvaprintf()
Like curl_maprintf() but takes a va_list
pointer argument instead of a variable
amount of arguments.
To easily use all these cloned functions instead of the
normal ones, #define _MPRINTF_REPLACE before you include
the <curl/mprintf.h> file. Then all the normal names like
printf, fprintf, sprintf etc will use the curl-functions
instead.
RETURN VALUE
The curl_maprintf and curl_mvaprintf functions return a
pointer to a newly allocated string, or NULL it it failed.
All other functions return the number of character they
actually outputed.
SEE ALSOprintf(3), sprintf(3), fprintf(3), vprintf(3)libcurl 7.7.2 20 April 2001 curl_printf(3)
