libwget-printf(3) Introduction to Library Functions libwget-printf(3)

NAME

libwget-printf - Libwget printf functions

SYNOPSIS

Functions

size_t wget_vasprintf (char **strp, const char *fmt, va_list args)
size_t wget_asprintf (char **strp, const char *fmt,...)
char * wget_vaprintf (const char *fmt, va_list args)
char * wget_aprintf (const char *fmt,...)
size_t wget_vfprintf (FILE *fp, const char *fmt, va_list args)
size_t wget_fprintf (FILE *fp, const char *fmt,...)
size_t wget_printf (const char *fmt,...)
size_t wget_vsnprintf (char *str, size_t size, const char *fmt,
va_list args)
size_t wget_snprintf (char *str, size_t size, const char *fmt,...)

Detailed Description
This is a collection of printf-style functions that are used with
libwget and/or Wget2 code. They may be useful to other developers
that is why they are exported.

Function Documentation
size_t wget_vasprintf (char ** strp, const char * fmt, va_list args)
Parameters
strp Pointer to hold the string output
fmt Printf-like format specifier
args va_list of arguments

Returns
Length of the string returned via strp or (size_t) -1 on error

Prints arguments to allocated memory and 0-terminates it. The string
is returned via the first argument. It has to be free()'d by the
caller when it is no longer needed.

size_t wget_asprintf (char ** strp, const char * fmt, ...)
Parameters
strp Pointer to hold the string output
fmt Printf-like format specifier
... List of arguments

Returns
Length of the string returned via strp

Prints arguments to allocated memory and 0-terminates it. The string
is returned via the first argument. It has to be free()'d by the
caller when it is no longer needed.

char * wget_vaprintf (const char * fmt, va_list args)
Parameters
fmt Printf-like format specifier
args va_list of arguments

Returns
Pointer to 0-terminated string in memory

Prints arguments to memory and returns a pointer to allocated and
0-terminated chunk of memory. The return value has to be free()'d by
the caller when it is no longer needed.

char * wget_aprintf (const char * fmt, ...)
Parameters
fmt Printf-like format specifier
... List of arguments

Returns
Pointer to 0-terminated string in memory

Prints arguments to memory and returns a pointer to allocated and
0-terminated chunk of memory. The return value has to be free()'d by
the caller when it is no longer needed.

size_t wget_vfprintf (FILE * fp, const char * fmt, va_list args)
Parameters
fp FILE pointer
fmt Printf-like format specifier
args List of arguments

Returns
Number of bytes written or -1 on error

Prints arguments to stream fp and returns number of bytes written.

size_t wget_fprintf (FILE * fp, const char * fmt, ...)
Parameters
fp FILE pointer
fmt Printf-like format specifier
... List of arguments

Returns
Number of bytes written or -1 on error

Prints arguments to stream fp and returns number of bytes written.

size_t wget_printf (const char * fmt, ...)
Parameters
fmt Printf-like format specifier
... List of arguments

Returns
Number of bytes written or -1 on error

Prints arguments to stdout and returns number of bytes written.

size_t wget_vsnprintf (char * str, size_t size, const char * fmt, va_list
args)
Parameters
str Destination buffer
size Size of str
fmt Printf-like format specifier
args List of arguments

Returns
Number of bytes written, or, on truncation, that would have been
written

Prints arguments to buffer str and returns number of bytes written,
or on truncation: that would have been written.

If str is NULL the return value are the number of bytes that would
have been written.

size_t wget_snprintf (char * str, size_t size, const char * fmt, ...)
Parameters
str Destination buffer
size Size of str
fmt Printf-like format specifier
... List of arguments

Returns
Number of bytes written, or, on truncation, that would have been
written

Prints arguments to buffer str and returns number of bytes written,
or on truncation: that would have been written.

If str is NULL the return value are the number of bytes that would
have been written.

Author
Generated automatically by Doxygen for wget2 from the source code.

wget2 Version 2.2.0 libwget-printf(3)