d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Back out my changes describing how snprintf nul terminates. It

Browse Source 
was from the iso standard.  Keep the sentence that says it is always
NUL terminated to make sure that people understand that.

Requested by: bde
This commit is contained in:
imp 2001-06-05 23:39:45 +00:00
parent 2ea81c771a
commit 3cf6d9eec0
1 changed files with 11 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
lib/libc/stdio/printf.3
View File

@ -150,15 +150,17 @@ to be a NULL pointer.
.Fn Snprintf
and
.Fn vsnprintf
return the number of characters
that would have been written had
.Fa size
been sufficiently large, not counting the terminating
.Ql \e0
character, or a negative value if an encoding error occurred.
Thus, the null-terminated output has been completely written if and only if
the returned value is nonnegative and less than
.Fa size .
will write at most
.Fa size Ns \-1
of the characters printed into the output string
(the
.Fa size Ns 'th
character then gets the terminating
.Ql \e0 ) ;
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.
The output is always null-terminated.
.Pp
.Fn Sprintf