aboutsummaryrefslogtreecommitdiffstats
path: root/man3
diff options
context:
space:
mode:
Diffstat (limited to 'man3')
-rw-r--r--man3/gets.38
-rw-r--r--man3/mbtowc.34
-rw-r--r--man3/printf.311
-rw-r--r--man3/puts.35
-rw-r--r--man3/scanf.38
-rw-r--r--man3/stpcpy.34
-rw-r--r--man3/stpncpy.38
-rw-r--r--man3/strcat.35
-rw-r--r--man3/strlen.34
-rw-r--r--man3/strnlen.36
-rw-r--r--man3/strsep.36
-rw-r--r--man3/strstr.34
-rw-r--r--man3/strxfrm.34
13 files changed, 37 insertions, 40 deletions
diff --git a/man3/gets.3 b/man3/gets.3
index f4949e4e62..d7ec25e34f 100644
--- a/man3/gets.3
+++ b/man3/gets.3
@@ -22,7 +22,7 @@
.\" License.
.\" Modified Wed Jul 28 11:12:07 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Fri Sep 8 15:48:13 1995 by Andries Brouwer (aeb@cwi.nl)
-.TH GETS 3 2008-08-06 "GNU" "Linux Programmer's Manual"
+.TH GETS 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
fgetc, fgets, getc, getchar, gets, ungetc \- input of characters and strings
.SH SYNOPSIS
@@ -71,8 +71,7 @@ into the buffer pointed to by
.I s
until either a terminating newline or
.BR EOF ,
-which it replaces with
-.BR \(aq\e0\(aq .
+which it replaces with a null byte (\(aq\e0\(aq).
No check for buffer overrun is performed (see BUGS below).
.PP
.BR fgets ()
@@ -86,8 +85,7 @@ Reading stops after an
.B EOF
or a newline.
If a newline is read, it is stored into the buffer.
-A
-.B \(aq\e0\(aq
+A terminating null byte (\(aq\e0\(aq)
is stored after the last character in the buffer.
.PP
.BR ungetc ()
diff --git a/man3/mbtowc.3 b/man3/mbtowc.3
index dd3f0ea273..1efb4ebce4 100644
--- a/man3/mbtowc.3
+++ b/man3/mbtowc.3
@@ -11,7 +11,7 @@
.\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\" ISO/IEC 9899:1999
.\"
-.TH MBTOWC 3 2001-07-04 "GNU" "Linux Programmer's Manual"
+.TH MBTOWC 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
mbtowc \- convert a multibyte sequence to a wide character
.SH SYNOPSIS
@@ -32,7 +32,7 @@ multibyte character, converts it to a wide character and stores it at
\fI*pwc\fP.
It updates an internal shift state only known to the mbtowc
function.
-If \fIs\fP does not point to a \(aq\\0\(aq byte, it returns the number
+If \fIs\fP does not point to a null byte (\(aq\\0\(aq), it returns the number
of bytes that were consumed from \fIs\fP, otherwise it returns 0.
.PP
If the \fIn\fP bytes starting at \fIs\fP do not contain a complete multibyte
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
diff --git a/man3/puts.3 b/man3/puts.3
index 0784b4ce63..0dd6864468 100644
--- a/man3/puts.3
+++ b/man3/puts.3
@@ -21,7 +21,7 @@
.\" the source, must acknowledge the copyright and authors of this work.
.\" License.
.\" Modified Sat Jul 24 18:42:59 1993 by Rik Faith (faith@cs.unc.edu)
-.TH PUTS 3 1993-04-04 "GNU" "Linux Programmer's Manual"
+.TH PUTS 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
fputc, fputs, putc, putchar, puts \- output of characters and strings
.SH SYNOPSIS
@@ -52,8 +52,7 @@ writes the string
.I s
to
.IR stream ,
-without its trailing
-.BR \(aq\e0\(aq .
+without its terminating null byte (\(aq\e0\(aq).
.PP
.BR putc ()
is equivalent to
diff --git a/man3/scanf.3 b/man3/scanf.3
index 113bcffe56..5166056d71 100644
--- a/man3/scanf.3
+++ b/man3/scanf.3
@@ -47,7 +47,7 @@
.\" Add ERRORS section.
.\" Document the 'a' and 'm' modifiers for dynamic string allocation.
.\"
-.TH SCANF 3 2010-09-20 "GNU" "Linux Programmer's Manual"
+.TH SCANF 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf \- input format conversion
.SH SYNOPSIS
@@ -223,7 +223,7 @@ when a nonmatching character is found, whichever happens first.
Most conversions discard initial white space characters (the exceptions
are noted below),
and these discarded characters don't count toward the maximum field width.
-String input conversions store a null terminator (\(aq\\0\(aq)
+String input conversions store a terminating null byte (\(aq\\0\(aq)
to mark the end of the input;
the maximum field width does not include this terminator.
.TP
@@ -449,8 +449,8 @@ Equivalent to
.B s
Matches a sequence of non-white-space characters;
the next pointer must be a pointer to character array that is
-long enough to hold the input sequence and the terminating null
-character (\(aq\\0\(aq), which is added automatically.
+long enough to hold the input sequence and
+the terminating null byte (\(aq\\0\(aq), which is added automatically.
The input string stops at white space or at the maximum field
width, whichever occurs first.
.TP
diff --git a/man3/stpcpy.3 b/man3/stpcpy.3
index 40b951ad22..827f6dac24 100644
--- a/man3/stpcpy.3
+++ b/man3/stpcpy.3
@@ -22,7 +22,7 @@
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
-.TH STPCPY 3 2010-09-15 "GNU" "Linux Programmer's Manual"
+.TH STPCPY 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
stpcpy \- copy a string returning a pointer to its end
.SH SYNOPSIS
@@ -54,7 +54,7 @@ _GNU_SOURCE
The
.BR stpcpy ()
function copies the string pointed to by \fIsrc\fP
-(including the terminating \(aq\\0\(aq character) to the array pointed to by
+(including the terminating null byte (\(aq\\0\(aq)) to the array pointed to by
\fIdest\fP.
The strings may not overlap, and the destination string
\fIdest\fP must be large enough to receive the copy.
diff --git a/man3/stpncpy.3 b/man3/stpncpy.3
index ac475f8030..8b402423a1 100644
--- a/man3/stpncpy.3
+++ b/man3/stpncpy.3
@@ -9,7 +9,7 @@
.\" GNU glibc-2 source code and manual
.\"
.\" Corrected, aeb, 990824
-.TH STPNCPY 3 2011-09-27 "GNU" "Linux Programmer's Manual"
+.TH STPNCPY 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
stpncpy \- copy a fixed-size string, returning a pointer to its end
.SH SYNOPSIS
@@ -41,16 +41,16 @@ _GNU_SOURCE
The
.BR stpncpy ()
function copies at most \fIn\fP characters from the string
-pointed to by \fIsrc\fP, including the terminating \(aq\\0\(aq character,
+pointed to by \fIsrc\fP, including the terminating null byte (\(aq\\0\(aq),
to the array pointed to by \fIdest\fP.
Exactly \fIn\fP characters are written at
\fIdest\fP.
If the length \fIstrlen(src)\fP is smaller than \fIn\fP, the
remaining characters in the array pointed to by \fIdest\fP are filled
-with \(aq\\0\(aq characters.
+with null bytes (\(aq\\0\(aq),
If the length \fIstrlen(src)\fP is greater or equal to
\fIn\fP, the string pointed to by \fIdest\fP will
-not be \(aq\\0\(aq terminated.
+not be null-terminated.
.PP
The strings may not overlap.
.PP
diff --git a/man3/strcat.3 b/man3/strcat.3
index 4437f17aea..a6ec1a1c15 100644
--- a/man3/strcat.3
+++ b/man3/strcat.3
@@ -27,7 +27,7 @@
.\" Modified Sat Jul 24 18:11:47 1993 by Rik Faith (faith@cs.unc.edu)
.\" 2007-06-15, Marc Boyer <marc.boyer@enseeiht.fr> + mtk
.\" Improve discussion of strncat().
-.TH STRCAT 3 2010-09-20 "GNU" "Linux Programmer's Manual"
+.TH STRCAT 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
strcat, strncat \- concatenate two strings
.SH SYNOPSIS
@@ -42,7 +42,8 @@ strcat, strncat \- concatenate two strings
The
.BR strcat ()
function appends the \fIsrc\fP string to the
-\fIdest\fP string, overwriting the null byte (\(aq\\0\(aq) at the end of
+\fIdest\fP string,
+overwriting the terminating null byte (\(aq\\0\(aq) at the end of
\fIdest\fP, and then adds a terminating null byte.
The strings may not overlap, and the \fIdest\fP string must have
enough space for the result.
diff --git a/man3/strlen.3 b/man3/strlen.3
index 94a1fcc27f..24778991e2 100644
--- a/man3/strlen.3
+++ b/man3/strlen.3
@@ -25,7 +25,7 @@
.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\" 386BSD man pages
.\" Modified Sat Jul 24 18:02:26 1993 by Rik Faith (faith@cs.unc.edu)
-.TH STRLEN 3 2011-09-10 "" "Linux Programmer's Manual"
+.TH STRLEN 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
strlen \- calculate the length of a string
.SH SYNOPSIS
@@ -38,7 +38,7 @@ strlen \- calculate the length of a string
The
.BR strlen ()
function calculates the length of the string
-\fIs\fP, not including the terminating \(aq\\0\(aq character.
+\fIs\fP, excluding the terminating null byte (\(aq\\0\(aq).
.SH "RETURN VALUE"
The
.BR strlen ()
diff --git a/man3/strnlen.3 b/man3/strnlen.3
index de37b32501..a5b50dd70a 100644
--- a/man3/strnlen.3
+++ b/man3/strnlen.3
@@ -8,7 +8,7 @@
.\" References consulted:
.\" GNU glibc-2 source code and manual
.\"
-.TH STRNLEN 3 2011-09-10 "GNU" "Linux Programmer's Manual"
+.TH STRNLEN 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
strnlen \- determine the length of a fixed-size string
.SH SYNOPSIS
@@ -40,7 +40,7 @@ _GNU_SOURCE
The
.BR strnlen ()
function returns the number of characters in the string
-pointed to by \fIs\fP, not including the terminating \(aq\\0\(aq character,
+pointed to by \fIs\fP, excluding the terminating null bye (\(aq\\0\(aq),
but at most \fImaxlen\fP.
In doing this,
.BR strnlen ()
@@ -51,7 +51,7 @@ The
.BR strnlen ()
function returns \fIstrlen(s)\fP, if that is less than
\fImaxlen\fP, or \fImaxlen\fP
-if there is no \(aq\\0\(aq character among the first
+if there is no null byte (\(aq\\0\(aq) among the first
\fImaxlen\fP characters pointed to by \fIs\fP.
.SH "CONFORMING TO"
POSIX.1-2008.
diff --git a/man3/strsep.3 b/man3/strsep.3
index f23127ffa1..d80b4b2595 100644
--- a/man3/strsep.3
+++ b/man3/strsep.3
@@ -28,7 +28,7 @@
.\" Modified Mon Jan 20 12:04:18 1997 by Andries Brouwer (aeb@cwi.nl)
.\" Modified Tue Jan 23 20:23:07 2001 by Andries Brouwer (aeb@cwi.nl)
.\"
-.TH STRSEP 3 2010-09-20 "GNU" "Linux Programmer's Manual"
+.TH STRSEP 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
strsep \- extract token from string
.SH SYNOPSIS
@@ -53,8 +53,8 @@ and does nothing else.
Otherwise, this function finds the first token
in the string \fI*stringp\fP, where tokens
are delimited by symbols in the string \fIdelim\fP.
-This token is terminated with a \(aq\\0\(aq character
-(by overwriting the delimiter)
+This token is terminated by overwriting the delimiter
+with a null byte (\(aq\\0\(aq)
and \fI*stringp\fP is updated to point past the token.
In case no delimiter was found, the token is taken to be
the entire string \fI*stringp\fP, and \fI*stringp\fP is made NULL.
diff --git a/man3/strstr.3 b/man3/strstr.3
index 56ddc90b23..3aa9053b8c 100644
--- a/man3/strstr.3
+++ b/man3/strstr.3
@@ -28,7 +28,7 @@
.\" Added history, aeb, 980113.
.\" 2005-05-05 mtk: added strcasestr()
.\"
-.TH STRSTR 3 2010-09-20 "GNU" "Linux Programmer's Manual"
+.TH STRSTR 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
strstr, strcasestr \- locate a substring
.SH SYNOPSIS
@@ -48,7 +48,7 @@ The
.BR strstr ()
function finds the first occurrence of the substring
\fIneedle\fP in the string \fIhaystack\fP.
-The terminating \(aq\\0\(aq characters are not compared.
+The terminating null bytes (\(aq\\0\(aq) are not compared.
The
.BR strcasestr ()
diff --git a/man3/strxfrm.3 b/man3/strxfrm.3
index 49d94d7d5d..b3b080aa1f 100644
--- a/man3/strxfrm.3
+++ b/man3/strxfrm.3
@@ -25,7 +25,7 @@
.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\" 386BSD man pages
.\" Modified Sun Jul 25 10:41:28 1993 by Rik Faith (faith@cs.unc.edu)
-.TH STRXFRM 3 2010-09-20 "GNU" "Linux Programmer's Manual"
+.TH STRXFRM 3 2011-09-28 "GNU" "Linux Programmer's Manual"
.SH NAME
strxfrm \- string transformation
.SH SYNOPSIS
@@ -56,7 +56,7 @@ The
.BR strxfrm ()
function returns the number of bytes required to
store the transformed string in \fIdest\fP excluding the
-terminating \(aq\\0\(aq character.
+terminating null byte (\(aq\\0\(aq).
If the value returned is \fIn\fP or more, the
contents of \fIdest\fP are indeterminate.
.SH "CONFORMING TO"