annotate lib/c-snprintf.h @ 17907:0a1c2535cad9

euidaccess: Fix Android build * modules/euidaccess (Depends-on): Add fcntl-h to ensure that AT_EACCESS gets declared.
author Kevin Cernekee <cernekee@google.com>
date Wed, 11 Feb 2015 15:22:54 -0800
parents ab58d4870664
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
17212
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
1 /* snprintf in C locale.
17848
ab58d4870664 version-etc: new year
Paul Eggert <eggert@cs.ucla.edu>
parents: 17587
diff changeset
2 Copyright (C) 2012-2015 Free Software Foundation, Inc.
17212
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
3
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
4 This program is free software; you can redistribute it and/or modify
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
5 it under the terms of the GNU General Public License as published by
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
6 the Free Software Foundation; either version 3, or (at your option)
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
7 any later version.
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
8
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
12 GNU General Public License for more details.
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
13
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
14 You should have received a copy of the GNU General Public License along
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
15 with this program; if not, see <http://www.gnu.org/licenses/>. */
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
16
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
17 #ifndef _C_SNPRINTF_H
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
18 #define _C_SNPRINTF_H
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
19
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
20 /* Get size_t. */
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
21 #include <stddef.h>
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
22
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
23 /* The __attribute__ feature is available in gcc versions 2.5 and later.
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
24 The __-protected variants of the attributes 'format' and 'printf' are
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
25 accepted by gcc versions 2.6.4 (effectively 2.7) and later.
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
26 We enable _GL_ATTRIBUTE_FORMAT only if these are supported too, because
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
27 gnulib and libintl do '#define printf __printf__' when they override
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
28 the 'printf' function. */
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
29 #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7)
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
30 # define _GL_ATTRIBUTE_FORMAT(spec) __attribute__ ((__format__ spec))
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
31 #else
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
32 # define _GL_ATTRIBUTE_FORMAT(spec) /* empty */
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
33 #endif
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
34
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
35 #ifdef __cplusplus
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
36 extern "C" {
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
37 #endif
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
38
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
39 int c_snprintf (char *str, size_t size, const char *format, ...)
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
40 _GL_ATTRIBUTE_FORMAT ((__printf__, 3, 4));
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
41
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
42 #ifdef __cplusplus
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
43 }
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
44 #endif
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
45
46900f509454 New 'c-*printf' modules for formatted output in C locale.
Ben Pfaff <blp@cs.stanford.edu>
parents:
diff changeset
46 #endif /* _C_SNPRINTF_H */