curl_mprintf(3) - phpMan

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_mvsnprintf, curl_mvsprintf - formatted output  conver-
       sion

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 argu-
       ments. 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 vari-
                     able 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  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), vprintf(3)



libcurl 7.12                              30 April 2004                            curl_printf(3)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-04-24 04:55 @13.59.218.147 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)