NAME

       curl_maprintf, curl_mfprintf, curl_mprintf, curl_msnprintf, curl_msprintf curl_mvaprintf, curl_mvfprintf,
       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 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 don't 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 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.

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 outputted.

SEE ALSO

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