diff options
Diffstat (limited to 'xprintf.h')
-rw-r--r-- | xprintf.h | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/xprintf.h b/xprintf.h new file mode 100644 index 0000000..7634a9f --- /dev/null +++ b/xprintf.h @@ -0,0 +1,58 @@ +/* + * Copyright (c) 2010 Richard Braun. + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * + * Formatted output functions. + * + * The functions provided by this module implement a subset of the C99 + * printf() like functions, mostly centered around character, string, and + * integer conversions. + * + * The supported specifiers are: d i o u x X c s p n % + * The supported length modifiers are: hh h l ll z t + * + * The xprintf() and xvprintf() functions internally use a statically + * allocated buffer. Although they are thread-safe, they won't produce + * output larger than 1 KiB. + */ + +#ifndef _XPRINTF_H +#define _XPRINTF_H + +#include <stdarg.h> + +#include "macros.h" + +int xprintf(const char *format, ...) __format_printf(1, 2); +int xvprintf(const char *format, va_list ap) __format_printf(1, 0); + +int xsprintf(char *str, const char *format, ...) __format_printf(2, 3); +int xvsprintf(char *str, const char *format, va_list ap) __format_printf(2, 0); + +int xsnprintf(char *str, size_t size, const char *format, ...) + __format_printf(3, 4); +int xvsnprintf(char *str, size_t size, const char *format, va_list ap) + __format_printf(3, 0); + +#endif /* _XPRINTF_H */ |