1 |
205 |
julius |
/* Implement the snprintf function.
|
2 |
|
|
Copyright (C) 2003 Free Software Foundation, Inc.
|
3 |
|
|
Written by Kaveh R. Ghazi <ghazi@caip.rutgers.edu>.
|
4 |
|
|
|
5 |
|
|
This file is part of the libiberty library. This library is free
|
6 |
|
|
software; you can redistribute it and/or modify it under the
|
7 |
|
|
terms of the GNU General Public License as published by the
|
8 |
|
|
Free Software Foundation; either version 2, or (at your option)
|
9 |
|
|
any later version.
|
10 |
|
|
|
11 |
|
|
This library is distributed in the hope that it will be useful,
|
12 |
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13 |
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14 |
|
|
GNU General Public License for more details.
|
15 |
|
|
|
16 |
|
|
You should have received a copy of the GNU General Public License
|
17 |
|
|
along with GNU CC; see the file COPYING. If not, write to
|
18 |
|
|
the Free Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.
|
19 |
|
|
|
20 |
|
|
As a special exception, if you link this library with files
|
21 |
|
|
compiled with a GNU compiler to produce an executable, this does not cause
|
22 |
|
|
the resulting executable to be covered by the GNU General Public License.
|
23 |
|
|
This exception does not however invalidate any other reasons why
|
24 |
|
|
the executable file might be covered by the GNU General Public License. */
|
25 |
|
|
|
26 |
|
|
/*
|
27 |
|
|
|
28 |
|
|
@deftypefn Supplemental int snprintf (char *@var{buf}, size_t @var{n}, const char *@var{format}, ...)
|
29 |
|
|
|
30 |
|
|
This function is similar to @code{sprintf}, but it will write to
|
31 |
|
|
@var{buf} at most @code{@var{n}-1} bytes of text, followed by a
|
32 |
|
|
terminating null byte, for a total of @var{n} bytes.
|
33 |
|
|
On error the return value is -1, otherwise it returns the number of
|
34 |
|
|
bytes, not including the terminating null byte, that would have been
|
35 |
|
|
written had @var{n} been sufficiently large, regardless of the actual
|
36 |
|
|
value of @var{n}. Note some pre-C99 system libraries do not implement
|
37 |
|
|
this correctly so users cannot generally rely on the return value if
|
38 |
|
|
the system version of this function is used.
|
39 |
|
|
|
40 |
|
|
@end deftypefn
|
41 |
|
|
|
42 |
|
|
*/
|
43 |
|
|
|
44 |
|
|
#include "ansidecl.h"
|
45 |
|
|
|
46 |
|
|
#include <stdarg.h>
|
47 |
|
|
#include <stddef.h>
|
48 |
|
|
|
49 |
|
|
int vsnprintf (char *, size_t, const char *, va_list);
|
50 |
|
|
|
51 |
|
|
int
|
52 |
|
|
snprintf (char *s, size_t n, const char *format, ...)
|
53 |
|
|
{
|
54 |
|
|
int result;
|
55 |
|
|
VA_OPEN (ap, format);
|
56 |
|
|
VA_FIXEDARG (ap, char *, s);
|
57 |
|
|
VA_FIXEDARG (ap, size_t, n);
|
58 |
|
|
VA_FIXEDARG (ap, const char *, format);
|
59 |
|
|
result = vsnprintf (s, n, format, ap);
|
60 |
|
|
VA_CLOSE (ap);
|
61 |
|
|
return result;
|
62 |
|
|
}
|