curl_printf(3) libcurl Manual curl_printf(3)

NAME curl_maprintf, curl_mfprintf, curl_mprintf, curl_msnprintf, curl_msprintf curl_mvaprintf, curl_mvfprintf, curl_mvprintf, curl_mvs- nprintf, 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 produce 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 fprintf() clone.

curl_msprintf() Normal sprintf() clone.

curl_msnprintf() snprintf() clone. Many systems dont have this. It is just like sprintf but with an extra argument after the buffer that specifies 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 specifies the length of the target buffer.

curl_maprintf() Like printf() but returns the output string as a mal- loc()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.

AVAILABILITY These function will be removed from the public libcurl API in a near future. They will instead be made "available" by source code access only, and then as curlx_-prefixed functions. See lib/README.curlx for further details.

RETURN VALUE The curl_maprintf and curl_mvaprintf functions return a pointer to a newly allocated string, or NULL if it failed.

All other functions return the number of characters they actually out- putted.

SEE ALSO printf(3), sprintf(3), fprintf(3), vprintf(3)

libcurl 7.12 30 April 2004 curl_printf(3)