curl_printf man page

From dcce39da3e6f7485dca39950dfc835563de3c3ea Mon Sep 17 00:00:00 2001 From: Kirill Volinsky Date: Mon, 25 Feb 2013 10:15:31 +0000 Subject: 1 step: libcurl static link git-svn-id: http://svn.miranda-ng.org/main/trunk@3763 1316c22d-e87f-b044-9b9b-93d7a3e3ba9c --- .../curl-7.29.0/docs/libcurl/curl_mprintf.html | 81 ++++++++++++++++++++++ 1 file changed, 81 insertions(+) create mode 100644 plugins/FTPFileYM/curl-7.29.0/docs/libcurl/curl_mprintf.html (limited to 'plugins/FTPFileYM/curl-7.29.0/docs/libcurl/curl_mprintf.html') diff --git a/plugins/FTPFileYM/curl-7.29.0/docs/libcurl/curl_mprintf.html b/plugins/FTPFileYM/curl-7.29.0/docs/libcurl/curl_mprintf.html new file mode 100644 index 0000000000..3d5228737c --- /dev/null +++ b/plugins/FTPFileYM/curl-7.29.0/docs/libcurl/curl_mprintf.html @@ -0,0 +1,81 @@ + + +curl_printf man page + + + + +

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.

NAME

SYNOPSIS

DESCRIPTION

AVAILABILITY

RETURN VALUE

SEE ALSO