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

NAME - SYNOPSIS - DESCRIPTION - AVAILABILITY - RETURN VALUE - SEE ALSO -