Scroll to navigation

VSNPRINTF(9) Basic C Library Functions VSNPRINTF(9)

NAME

vsnprintf - Format a string and place it in a buffer

SYNOPSIS

int vsnprintf(char * buf, size_t size, const char * fmt, va_list args);

ARGUMENTS

buf

The buffer to place the result into

size

The size of the buffer, including the trailing null space

fmt

The format string to use

args

Arguments for the format string

DESCRIPTION

This function follows C99 vsnprintf, but has some extensions: pS output the name of a text symbol with offset ps output the name of a text symbol without offset pF output the name of a function pointer with its offset pf output the name of a function pointer without its offset pR output the address range in a struct resource pIS depending on sa_family of ´struct sockaddr *´ print IPv4/IPv6 address piS depending on sa_family of ´struct sockaddr *´ print IPv4/IPv6 address %*ph[CDN] a variable-length hex string with a separator (supports up to 64 bytes of the input) n is ignored

The return value is the number of characters which would be generated for the given input, excluding the trailing ´\0´, as per ISO C99. If you want to have the exact number of characters written into buf as return value (not including the trailing ´\0´), use vscnprintf. If the return is greater than or equal to size, the resulting string is truncated.

Call this function if you are already dealing with a va_list. You probably want snprintf instead.

COPYRIGHT

April 2023 Kernel Hackers Manual 2.6.