BSTR_PRINTF(9) Basic C Library Functions BSTR_PRINTF(9)NAME
bstr_printf - Format a string from binary arguments and place it in a buffer
SYNOPSIS
int bstr_printf(char * buf, size_t size, const char * fmt, const u32 * bin_buf);
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
bin_buf
Binary arguments for the format string
DESCRIPTION
This function like C99 vsnprintf, but the difference is that vsnprintf gets arguments from stack, and bstr_printf gets arguments from
bin_buf which is a binary buffer that generated by vbin_printf.
The format follows C99 vsnprintf, but has some extensions: see vsnprintf comment for details.
The return value is the number of characters which would be generated for the given input, excluding the trailing ' ', as per ISO C99. If
you want to have the exact number of characters written into buf as return value (not including the trailing ' '), use vscnprintf. If the
return is greater than or equal to size, the resulting string is truncated.
COPYRIGHT Kernel Hackers Manual 3.10 June 2014 BSTR_PRINTF(9)
Check Out this Related Man Page
vprintf(3) Library Functions Manual vprintf(3)NAME
vprintf, vfprintf, vsnprintf, vsprintf - Format a variable number of parameters for output
LIBRARY
Standard C Library (libc.so, libc.a)
SYNOPSIS
#include <stdarg.h> #include <stdio.h>
int vprintf(
const char *format,
va_list printarg);
int vfprintf(
FILE *stream,
const char *format,
va_list printarg);
int vsnprintf(
char *string, size_t n,
const char *format,
va_list printarg);
int vsprintf(
char *string,
const char *format,
va_list printarg);
STANDARDS
Interfaces documented on this reference page conform to industry standards as follows:
vfprintf(), vprintf(), vsnprintf(), vsprintf(): ISO C, XPG4, XPG4-UNIX
Refer to the standards(5) reference page for more information about industry standards and associated tags.
PARAMETERS
Specifies a character string that contains two types of objects: Plain characters, which are copied to the output stream. Conversion spec-
ifications, each of which causes zero or more items to be fetched from the stdarg parameter lists. Specifies the arguments to be printed.
Specifies the output stream. Specifies the buffer to which output is printed. Specifies the size of the buffer referred to by string.
DESCRIPTION
The vprintf(), vfprintf(), vsnprintf(), and vsprintf() functions format and write stdarg parameter lists.
These functions are the same as the printf(), fprintf(), snprintf(), and sprintf() functions, respectively, except that these functions are
not called with a variable number of parameters. Instead, vprintf(), vfprintf(), vsnprintf(), and vsprintf() are called with a parameter
list pointer as defined by stdarg. Because these functions invoke the va_arg() macro and not the va_end() macro, the value of printarg is
indeterminate after a return. Therefore, applications should execute a call to the va_end() macro after a call to one of these functions.
EXAMPLES
The following example demonstrates how the vfprintf() function can be used to write an error routine:
#include <stdarg.h> #include <stdio.h>
void error(char *funct, char *fmt, ...) {
va_list args;
/*
** Display the name of the function that called error
*/
fprintf(stderr, "ERROR in %s: ", funct);
/*
** Display the remainder of the message
*/
va_start(args, fmt);
vfprintf(stderr, fmt, args);
va_end(args);
abort(); }
RELATED INFORMATION
Functions: fopen(3), printf(3), vwprintf(3), wprintf(3) delim off
vprintf(3)