Scroll to navigation

libwget-printf(3) Library Functions Manual 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.

Version 2.1.0 wget2