root/maint/gnulib/lib/unistdio/u-vsnprintf.h

/* */

INCLUDED FROM

DEFINITIONS

1. VSNPRINTF

   1 /* Formatted output to strings.
   2    Copyright (C) 1999, 2002, 2006-2021 Free Software Foundation, Inc.
   3 
   4    This file is free software.
   5    It is dual-licensed under "the GNU LGPLv3+ or the GNU GPLv2+".
   6    You can redistribute it and/or modify it under either
   7      - the terms of the GNU Lesser General Public License as published
   8        by the Free Software Foundation; either version 3, or (at your
   9        option) any later version, or
  10      - the terms of the GNU General Public License as published by the
  11        Free Software Foundation; either version 2, or (at your option)
  12        any later version, or
  13      - the same dual license "the GNU LGPLv3+ or the GNU GPLv2+".
  14 
  15    This file is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  18    Lesser General Public License and the GNU General Public License
  19    for more details.
  20 
  21    You should have received a copy of the GNU Lesser General Public
  22    License and of the GNU General Public License along with this
  23    program.  If not, see <https://www.gnu.org/licenses/>.  */
  24 
  25 int
  26 VSNPRINTF (DCHAR_T *buf, size_t size, const FCHAR_T *format, va_list args)
     /*  */
  27 {
  28   size_t length;
  29   DCHAR_T *result;
  30 
  31   if (size == 0)
  32     buf = NULL;
  33   else
  34     length = size;
  35   result = VASNPRINTF (buf, &length, format, args);
  36   if (result == NULL)
  37     return -1;
  38 
  39   if (result != buf)
  40     {
  41       if (size != 0)
  42         {
  43           /* The result did not fit into the buffer.  Copy the initial segment
  44              into the buffer, truncating it if necessary.  */
  45           size_t n = (length < size ? length : size - 1);
  46           DCHAR_CPY (buf, result, n);
  47           buf[n] = '\0';
  48         }
  49       free (result);
  50     }
  51 
  52   if (length > INT_MAX)
  53     {
  54       errno = EOVERFLOW;
  55       return -1;
  56     }
  57 
  58   /* Return the number of resulting units, excluding the trailing NUL.  */
  59   return length;
  60 }

/* */