libwget-printf(3)

Wget printf functions

Section 3 wget2-dev bookworm source

Description

libwget-printf

NAME

libwget-printf - Wget 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_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 Wget 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

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

Pointer to 0-terminated string in memory

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

Pointer to 0-terminated string in memory

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

size_t wget_vsnprintf (char * str, size_t size, const char * fmt, va_listargs)

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.