1/*****************************************************************************/
2/* */
3/* xsprintf.h */
4/* */
5/* Replacement sprintf function */
6/* */
7/* */
8/* */
9/* (C) 2000-2008 Ullrich von Bassewitz */
10/* Roemerstrasse 52 */
11/* D-70794 Filderstadt */
12/* EMail: uz@cc65.org */
13/* */
14/* */
15/* This software is provided 'as-is', without any expressed or implied */
16/* warranty. In no event will the authors be held liable for any damages */
17/* arising from the use of this software. */
18/* */
19/* Permission is granted to anyone to use this software for any purpose, */
20/* including commercial applications, and to alter it and redistribute it */
21/* freely, subject to the following restrictions: */
22/* */
23/* 1. The origin of this software must not be misrepresented; you must not */
24/* claim that you wrote the original software. If you use this software */
25/* in a product, an acknowledgment in the product documentation would be */
26/* appreciated but is not required. */
27/* 2. Altered source versions must be plainly marked as such, and must not */
28/* be misrepresented as being the original software. */
29/* 3. This notice may not be removed or altered from any source */
30/* distribution. */
31/* */
32/*****************************************************************************/
33
34
35
36/* We need a way to output a StrBuf, but on the other side, we don't want to
37** switch off gcc's printf format string checking. So we cheat as follows:
38** %m (which is a gcc extension and doesn't take an argument) switches %p
39** between outputting a pointer and a string buf. This works just one time,
40** so each StrBuf needs in fact a %m%p spec. There's no way to apply a width
41** and precision to such a StrBuf, but *not* using %p would bring up a warning
42** about a wrong argument type each time. Maybe gcc will one day allow custom
43** format specifiers and we can change this ...
44*/
45
46
47
48#ifndef XSPRINTF_H
49#define XSPRINTF_H
50
51
52
53#include <stdlib.h>
54#include <stdarg.h>
55
56#include "attrib.h"
57
58
59
60/*****************************************************************************/
61/* Code */
62/*****************************************************************************/
63
64
65
66int xvsnprintf (char* Buf, size_t Size, const char* Format, va_list ap)
67 attribute ((format (printf, 3, 0)));
68/* A basic vsnprintf implementation. Does currently only support integer
69** formats.
70*/
71
72int xsnprintf (char* Buf, size_t Size, const char* Format, ...)
73 attribute ((format (printf, 3, 4)));
74/* A basic snprintf implementation. Does currently only support integer
75** formats.
76*/
77
78int xsprintf (char* Buf, size_t BufSize, const char* Format, ...)
79 attribute ((format (printf, 3, 4)));
80/* Replacement function for sprintf. Will FAIL on errors. */
81
82int xvsprintf (char* Buf, size_t BufSize, const char* Format, va_list ap)
83 attribute ((format (printf, 3, 0)));
84/* Replacement function for sprintf. Will FAIL on errors. */
85
86
87
88/* End of xsprintf.h */
89
90#endif
91