aboutsummaryrefslogtreecommitdiffstats
path: root/man3/printf.3
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2011-09-28 06:16:17 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2011-09-28 06:20:52 +0200
commit71d9e7ae77e74475825e2850c1daef779b51f978 (patch)
treefd4ac0cd38c5852ddb8aaa7beaccbbb1b53f34fc /man3/printf.3
parente9c23bc636426366d659809bc99cd84661e86464 (diff)
downloadman-pages-71d9e7ae77e74475825e2850c1daef779b51f978.tar.gz
gets.3, mbtowc.3, printf.3, puts.3, scanf.3, stpcpy.3, stpncpy.3, strcat.3, strlen.3, strnlen.3, strsep.3, strstr.3, strxfrm.3, utmp.5: Global fix: consistent use of "null byte"
Bring more consistency to the discussion of "[terminating] null byte" by writing (at least in the initial use in a page) "[terminating] null byte ('\0')". Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man3/printf.3')
-rw-r--r--man3/printf.311
1 files changed, 5 insertions, 6 deletions
diff --git a/man3/printf.3 b/man3/printf.3
index 720a8fff5c..194050b1fa 100644
--- a/man3/printf.3
+++ b/man3/printf.3
@@ -31,7 +31,7 @@
.\" 2000-07-26 jsm28@hermes.cam.ac.uk - three small fixes
.\" 2000-10-16 jsm28@hermes.cam.ac.uk - more fixes
.\"
-.TH PRINTF 3 2010-09-20 "GNU" "Linux Programmer's Manual"
+.TH PRINTF 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
printf, fprintf, sprintf, snprintf, vprintf, vfprintf, vsprintf,
vsnprintf \- formatted output conversion
@@ -105,7 +105,7 @@ and
.BR vsnprintf ()
write at most
.I size
-bytes (including the trailing null byte (\(aq\e0\(aq)) to
+bytes (including the terminating null byte (\(aq\e0\(aq)) to
.IR str .
.PP
The functions
@@ -151,8 +151,7 @@ refer to the same buffer).
See NOTES.
.SS "Return value"
Upon successful return, these functions return the number of characters
-printed (not including the
-trailing \(aq\e0\(aq used to end output to strings).
+printed (excluding the null byte used to end output to strings).
The functions
.BR snprintf ()
@@ -160,9 +159,9 @@ and
.BR vsnprintf ()
do not write more than
.I size
-bytes (including the trailing \(aq\e0\(aq).
+bytes (including the terminating null byte (\(aq\e0\(aq)).
If the output was truncated due to this limit then the return value
-is the number of characters (not including the trailing \(aq\e0\(aq)
+is the number of characters (excluding the terminating null byte)
which would have been written to the final string if enough space
had been available.
Thus, a return value of