mirror of
https://github.com/xcat2/xNBA.git
synced 2024-12-15 15:51:44 +00:00
100 lines
2.6 KiB
C
100 lines
2.6 KiB
C
#ifndef VSPRINTF_H
|
|
#define VSPRINTF_H
|
|
|
|
/** @file
|
|
*
|
|
* printf() and friends
|
|
*
|
|
* Etherboot's printf() functions understand the following subset of
|
|
* the standard C printf()'s format specifiers:
|
|
*
|
|
* - Flag characters
|
|
* - '#' - Alternate form (i.e. "0x" prefix)
|
|
* - '0' - Zero-pad
|
|
* - Field widths
|
|
* - Length modifiers
|
|
* - 'hh' - Signed / unsigned char
|
|
* - 'h' - Signed / unsigned short
|
|
* - 'l' - Signed / unsigned long
|
|
* - 'll' - Signed / unsigned long long
|
|
* - 'z' - Signed / unsigned size_t
|
|
* - Conversion specifiers
|
|
* - 'd' - Signed decimal
|
|
* - 'x','X' - Unsigned hexadecimal
|
|
* - 'c' - Character
|
|
* - 's' - String
|
|
* - 'p' - Pointer
|
|
*
|
|
* Hexadecimal numbers are always zero-padded to the specified field
|
|
* width (if any); decimal numbers are always space-padded. Decimal
|
|
* long longs are not supported.
|
|
*
|
|
*/
|
|
|
|
#include <stdarg.h>
|
|
|
|
#define PRINTF_NO_LENGTH ( ( size_t ) -1 )
|
|
|
|
/**
|
|
* A printf context
|
|
*
|
|
* Contexts are used in order to be able to share code between
|
|
* vprintf() and vsnprintf(), without requiring the allocation of a
|
|
* buffer for vprintf().
|
|
*/
|
|
struct printf_context {
|
|
/**
|
|
* Character handler
|
|
*
|
|
* @v ctx Context
|
|
* @v c Character
|
|
*
|
|
* This method is called for each character written to the
|
|
* formatted string.
|
|
*/
|
|
void ( * handler ) ( struct printf_context *ctx, unsigned int c );
|
|
/** Length of formatted string
|
|
*
|
|
* When handler() is called, @len will be set to the number of
|
|
* characters written so far (i.e. zero for the first call to
|
|
* handler()).
|
|
*/
|
|
size_t len;
|
|
};
|
|
|
|
extern size_t vcprintf ( struct printf_context *ctx, const char *fmt,
|
|
va_list args );
|
|
extern int vsnprintf ( char *buf, size_t size, const char *fmt, va_list args );
|
|
extern int vprintf ( const char *fmt, va_list args );
|
|
|
|
extern int __attribute__ (( format ( printf, 3, 4 ) ))
|
|
snprintf ( char *buf, size_t size, const char *fmt, ... );
|
|
|
|
extern int __attribute__ (( format ( printf, 1, 2 ) ))
|
|
printf ( const char *fmt, ... );
|
|
|
|
/**
|
|
* Write a formatted string to a buffer
|
|
*
|
|
* @v buf Buffer into which to write the string
|
|
* @v fmt Format string
|
|
* @v ... Arguments corresponding to the format string
|
|
* @ret len Length of formatted string
|
|
*/
|
|
#define sprintf( buf, fmt, ... ) \
|
|
snprintf ( (buf), PRINTF_NO_LENGTH, (fmt), ## __VA_ARGS__ )
|
|
|
|
/**
|
|
* Write a formatted string to a buffer
|
|
*
|
|
* @v buf Buffer into which to write the string
|
|
* @v fmt Format string
|
|
* @v args Arguments corresponding to the format string
|
|
* @ret len Length of formatted string
|
|
*/
|
|
static inline int vsprintf ( char *buf, const char *fmt, va_list args ) {
|
|
return vsnprintf ( buf, PRINTF_NO_LENGTH, fmt, args );
|
|
}
|
|
|
|
#endif /* VSPRINTF_H */
|