summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOtto Moerbeek <otto@cvs.openbsd.org>2005-04-14 18:19:25 +0000
committerOtto Moerbeek <otto@cvs.openbsd.org>2005-04-14 18:19:25 +0000
commit3d3bbc8f3ad0c6a1ca8417379a2c4e3c9e31901e (patch)
treea622fef9a9d3709096979e63da83f9987c417b00
parent7a0df57ca13540b7336606bc12e8f1e5bf54f46c (diff)
Explain what happens when len equals 0 for snprintf().
ok jmc@ millert@
-rw-r--r--lib/libc/stdio/printf.310
1 files changed, 9 insertions, 1 deletions
diff --git a/lib/libc/stdio/printf.3 b/lib/libc/stdio/printf.3
index 4931d4e3b3d..1eaf7375db4 100644
--- a/lib/libc/stdio/printf.3
+++ b/lib/libc/stdio/printf.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: printf.3,v 1.45 2005/02/25 03:12:44 cloder Exp $
+.\" $OpenBSD: printf.3,v 1.46 2005/04/14 18:19:24 otto Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -165,6 +165,14 @@ if the return value is greater than or equal to the
.Fa size
argument, the string was too short
and some of the printed characters were discarded.
+If
+.Fa size
+is zero,
+.Fa str
+may be a null pointer and no characters will be written;
+the number of bytes that would have been written excluding the terminating
+.Ql \e0
+byte, or \-1 on error, will be returned.
.Pp
.Fn sprintf
and