Manual Pages for UNIX Operating System command usage for man curl_mprintf

libcurl Manual                                     curl_printf(3)



NAME
     curl_maprintf, curl_mfprintf, curl_mprintf,  curl_msnprintf,
     curl_msprintf curl_mvaprintf, curl_mvfprintf, curl_mvprintf,
     curl_mvsnprintf, curl_mvsprintf - formatted  output  conver-
     sion

SYNOPSIS
     #include 

     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
     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()



libcurl 7.12       Last change: 30 April 2004                   1






libcurl Manual                                     curl_printf(3)



               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 argu-
               ment 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 argu-
               ments.

     To easily use all these cloned functions instead of the nor-
     mal  ones,  #define  _MPRINTF_REPLACE before you include the
       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  func-
     tions. 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),

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:









libcurl 7.12       Last change: 30 April 2004                   2






libcurl Manual                                     curl_printf(3)



     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  web/curl       |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for C-URL is available on http://opensolaris.org.













































libcurl 7.12       Last change: 30 April 2004                   3