]> Savannah Git Hosting - gnulib.git/commitdiff
c-vzsnprintf: New module.
authorBruno Haible <bruno@clisp.org>
Sat, 22 Jun 2024 10:21:11 +0000 (12:21 +0200)
committerBruno Haible <bruno@clisp.org>
Sat, 22 Jun 2024 10:21:11 +0000 (12:21 +0200)
* lib/c-vsnprintf.h: Change license to LGPLv2+.
(c_vzsnprintf): New declaration.
* lib/c-vzsnprintf.c: New file, based on lib/vzsnprintf.c.
* modules/c-vzsnprintf: New file.

ChangeLog
lib/c-vsnprintf.h
lib/c-vzsnprintf.c [new file with mode: 0644]
modules/c-vzsnprintf [new file with mode: 0644]

index ef21dcc22270bc544fc074a4c0be14f9158d3beb..0f37171285bb3e99637dbf86068e03e71f37240c 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2024-06-22  Bruno Haible  <bruno@clisp.org>
+
+       c-vzsnprintf: New module.
+       * lib/c-vsnprintf.h: Change license to LGPLv2+.
+       (c_vzsnprintf): New declaration.
+       * lib/c-vzsnprintf.c: New file, based on lib/vzsnprintf.c.
+       * modules/c-vzsnprintf: New file.
+
 2024-06-22  Bruno Haible  <bruno@clisp.org>
 
        xvasprintf: Guarantee a non-NULL result.
index 57d689e297ef7901d692f9f30c4586e8b6f12a1a..e00ade93f87e45fde1b15bf72f0cd34aa9e4c7db 100644 (file)
@@ -1,18 +1,18 @@
 /* vsnprintf in C locale.
    Copyright (C) 2012-2024 Free Software Foundation, Inc.
 
-   This program is free software; you can redistribute it and/or modify
-   it under the terms of the GNU General Public License as published by
-   the Free Software Foundation, either version 3, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-   GNU General Public License for more details.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License along
-   with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _C_VSNPRINTF_H
 #define _C_VSNPRINTF_H
@@ -22,7 +22,7 @@
  #error "Please include config.h first."
 #endif
 
-/* Get size_t.  */
+/* Get size_t, ptrdiff_t.  */
 #include <stddef.h>
 
 /* Get va_list. */
 extern "C" {
 #endif
 
+/* Prints formatted output to string STR.  Similar to vsprintf, but the
+   additional parameter SIZE limits how much is written into STR.
+   STR may be NULL, in which case nothing will be written.
+   Returns the string length of the formatted string (which may be larger
+   than SIZE).  Upon failure, returns -1 with errno set.
+
+   Failure code EOVERFLOW can only occur when a width > INT_MAX is used.
+   Therefore, if the format string is valid and does not use %ls/%lc
+   directives nor widths, the only possible failure code is ENOMEM.
+
+   Formatting takes place in the C locale, that is, the decimal point
+   used in floating-point formatting directives is always '.'. */
+extern ptrdiff_t c_vzsnprintf (char *restrict str, size_t size,
+                               const char *format, va_list args)
+       _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_STANDARD, 3, 0));
+
 extern int c_vsnprintf (char *restrict str, size_t size,
                         const char *format, va_list args)
        _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_STANDARD, 3, 0));
diff --git a/lib/c-vzsnprintf.c b/lib/c-vzsnprintf.c
new file mode 100644 (file)
index 0000000..948266d
--- /dev/null
@@ -0,0 +1,66 @@
+/* Formatted output to strings in C locale.
+   Copyright (C) 2004, 2006-2024 Free Software Foundation, Inc.
+   Written by Simon Josefsson and Yoann Vandoorselaere <yoann@prelude-ids.org>.
+   Modified for C locale by Ben Pfaff.
+
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
+
+   This file is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+#ifdef HAVE_CONFIG_H
+# include <config.h>
+#endif
+
+/* Specification.  */
+#include "c-vsnprintf.h"
+
+#include <errno.h>
+#include <stdarg.h>
+#include <stdint.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include "c-vasnprintf.h"
+
+ptrdiff_t
+c_vzsnprintf (char *str, size_t size, const char *format, va_list args)
+{
+  char *output;
+  size_t len;
+  size_t lenbuf = size;
+
+  output = c_vasnprintf (str, &lenbuf, format, args);
+  len = lenbuf;
+
+  if (!output)
+    return -1;
+
+  if (output != str)
+    {
+      if (size)
+        {
+          size_t pruned_len = (len < size ? len : size - 1);
+          memcpy (str, output, pruned_len);
+          str[pruned_len] = '\0';
+        }
+
+      free (output);
+    }
+
+  if (len > PTRDIFF_MAX)
+    {
+      errno = ENOMEM;
+      return -1;
+    }
+
+  return len;
+}
diff --git a/modules/c-vzsnprintf b/modules/c-vzsnprintf
new file mode 100644 (file)
index 0000000..4049974
--- /dev/null
@@ -0,0 +1,27 @@
+Description:
+c_vzsnprintf(): print formatted output from an stdarg argument list to a
+fixed length string (without INT_MAX limitation) in C locale
+
+Files:
+lib/c-vsnprintf.h
+lib/c-vzsnprintf.c
+
+Depends-on:
+stdint
+stdio
+c-vasnprintf
+
+configure.ac:
+AC_REQUIRE([AC_C_RESTRICT])
+
+Makefile.am:
+lib_SOURCES += c-vzsnprintf.c
+
+Include:
+"c-vsnprintf.h"
+
+License:
+LGPLv2+
+
+Maintainer:
+all