annotate lib/unistdio/u-vsprintf.h @ 18062:a1744ab6ea8e

time_rz: fix off-by-one typo * lib/time_rz.c (extend_abbrs): Fix off-by-one typo.
author Paul Eggert <eggert@cs.ucla.edu>
date Sat, 25 Jul 2015 15:10:16 -0700
parents ab58d4870664
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9030
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 /* Formatted output to strings.
17848
ab58d4870664 version-etc: new year
Paul Eggert <eggert@cs.ucla.edu>
parents: 17587
diff changeset
2 Copyright (C) 1999, 2002, 2006-2015 Free Software Foundation, Inc.
9030
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3
9307
ad8a75a45dc9 Change copyright notice from LGPLv2.0+ to LGPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 9030
diff changeset
4 This program is free software: you can redistribute it and/or modify it
ad8a75a45dc9 Change copyright notice from LGPLv2.0+ to LGPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 9030
diff changeset
5 under the terms of the GNU Lesser General Public License as published
ad8a75a45dc9 Change copyright notice from LGPLv2.0+ to LGPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 9030
diff changeset
6 by the Free Software Foundation; either version 3 of the License, or
ad8a75a45dc9 Change copyright notice from LGPLv2.0+ to LGPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 9030
diff changeset
7 (at your option) any later version.
9030
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
9307
ad8a75a45dc9 Change copyright notice from LGPLv2.0+ to LGPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 9030
diff changeset
12 Lesser General Public License for more details.
9030
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
13
9307
ad8a75a45dc9 Change copyright notice from LGPLv2.0+ to LGPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 9030
diff changeset
14 You should have received a copy of the GNU Lesser General Public License
ad8a75a45dc9 Change copyright notice from LGPLv2.0+ to LGPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 9030
diff changeset
15 along with this program. If not, see <http://www.gnu.org/licenses/>. */
9030
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
16
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
17 #ifndef SIZE_MAX
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
18 # define SIZE_MAX ((size_t) -1)
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19 #endif
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21 int
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22 VSPRINTF (DCHAR_T *buf, const FCHAR_T *format, va_list args)
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
23 {
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
24 /* Pass an infinite length. But note that *vasnprintf may fail if the buffer
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
25 argument is larger than INT_MAX (if that fits into a 'size_t' at all).
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
26 Also note that glibc's iconv fails with E2BIG when we pass a length that
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
27 is so large that buf + length wraps around, i.e.
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
28 (uintptr_t) (buf + length) < (uintptr_t) buf. */
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
29 size_t length;
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
30 DCHAR_T *result;
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
31
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
32 /* Set length = min (SIZE_MAX, INT_MAX, - (uintptr_t) buf - 1). */
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
33 length = (SIZE_MAX < INT_MAX ? SIZE_MAX : INT_MAX);
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
34 if (length > (~ (uintptr_t) buf) / sizeof (DCHAR_T))
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
35 length = (~ (uintptr_t) buf) / sizeof (DCHAR_T);
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
36
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
37 result = VASNPRINTF (buf, &length, format, args);
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
38 if (result == NULL)
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
39 return -1;
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
40
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
41 /* The infinite buffer size guarantees that the result is not malloc()ed. */
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
42 if (result != buf)
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
43 {
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
44 /* length is near SIZE_MAX. */
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
45 free (result);
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
46 errno = EOVERFLOW;
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
47 return -1;
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
48 }
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
49
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
50 if (length > INT_MAX)
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
51 {
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
52 errno = EOVERFLOW;
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
53 return -1;
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
54 }
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
55
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
56 /* Return the number of resulting units, excluding the trailing NUL. */
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
57 return length;
870029929d86 Formatted output functions for Unicode strings.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
58 }