**************************************************************************
 * _ _ ____ _
 * Project ___| | | | _ \| |
 * / __| | | | |_) | |
 * | (__| |_| | _ <| |___
 * \___|\___/|_| \_\_____|
 *
 * Copyright (C) 1998 - 2011, Daniel Stenberg, <daniel@haxx.se>, et al.
 *
 * This software is licensed as described in the file COPYING, which
 * you should have received as part of this distribution. The terms
 * are also available at http://curl.haxx.se/docs/copyright.html.
 *
 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
 * copies of the Software, and permit persons to whom the Software is
 * furnished to do so, under the terms of the COPYING file.
 *
 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
 * KIND, either express or implied.
 *
 **************************************************************************
 curl_printf 3 "30 April 2004" "libcurl 7.12" "libcurl Manual"
 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) "