From 42443a47925ece8bb32b83c3edd58e404bd6b5cb Mon Sep 17 00:00:00 2001 From: Jeff Law Date: Mon, 13 Aug 2012 13:12:18 -0600 Subject: * manual/stdio.texi (snprintf): Clarify handling of the trailing null byte in the output string. --- ChangeLog | 5 +++++ manual/stdio.texi | 2 ++ 2 files changed, 7 insertions(+) diff --git a/ChangeLog b/ChangeLog index 386f8493c2..2b3d2e4550 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2012-08-13 Jeff Law + + * manual/stdio.texi (snprintf): Clarify handling of the trailing + null byte in the output string. + 2012-08-10 Joseph Myers * sysdeps/unix/sysv/linux/kernel-features.h diff --git a/manual/stdio.texi b/manual/stdio.texi index c58ca22b2d..be769a538f 100644 --- a/manual/stdio.texi +++ b/manual/stdio.texi @@ -2341,6 +2341,8 @@ The @code{snprintf} function is similar to @code{sprintf}, except that the @var{size} argument specifies the maximum number of characters to produce. The trailing null character is counted towards this limit, so you should allocate at least @var{size} characters for the string @var{s}. +If @var{size} is zero, nothing, not even the null byte, shall be written and +@var{s} may be a null pointer. The return value is the number of characters which would be generated for the given input, excluding the trailing null. If this value is -- cgit v1.2.3