DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

curl_maprintf(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  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 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  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 it it failed.

       All other functions return the number of character they  actually  out-
       puted.


SEE ALSO

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

libcurl 7.12                     30 April 2004                  curl_printf(3)

Man(1) output converted with man2html