Formatted output functions for Unicode strings.
[gnulib.git] / lib / unistdio / u-vsnprintf.h
1 /* Formatted output to strings.
2    Copyright (C) 1999, 2002, 2006-2007 Free Software Foundation, Inc.
3
4    This program is free software; you can redistribute it and/or modify it
5    under the terms of the GNU Library General Public License as published
6    by the Free Software Foundation; either version 2, or (at your option)
7    any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12    Library General Public License for more details.
13
14    You should have received a copy of the GNU Library General Public
15    License along with this program; if not, write to the Free Software
16    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
17    USA.  */
18
19 /* Some systems, like OSF/1 4.0 and Woe32, don't have EOVERFLOW.  */
20 #ifndef EOVERFLOW
21 # define EOVERFLOW E2BIG
22 #endif
23
24 int
25 VSNPRINTF (DCHAR_T *buf, size_t size, const FCHAR_T *format, va_list args)
26 {
27   size_t length;
28   DCHAR_T *result;
29
30   if (size == 0)
31     buf = NULL;
32   else
33     length = size;
34   result = VASNPRINTF (buf, &length, format, args);
35   if (result == NULL)
36     return -1;
37
38   if (result != buf)
39     {
40       if (size != 0)
41         {
42           /* The result did not fit into the buffer.  Copy the initial segment
43              into the buffer, truncating it if necessary.  */
44           size_t n = (length < size ? length : size - 1);
45           DCHAR_CPY (buf, result, n);
46           buf[n] = '\0';
47         }
48       free (result);
49     }
50
51   if (length > INT_MAX)
52     {
53       errno = EOVERFLOW;
54       return -1;
55     }
56
57   /* Return the number of resulting units, excluding the trailing NUL.  */
58   return length;
59 }