Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[src/trunk]: src/lib/libc/stdio Note that EOF returns -1 when no characters a...
details: https://anonhg.NetBSD.org/src/rev/52d8979d6c82
branches: trunk
changeset: 749485:52d8979d6c82
user: roy <roy%NetBSD.org@localhost>
date: Mon Nov 30 22:51:46 2009 +0000
description:
Note that EOF returns -1 when no characters are read.
Add code example.
diffstat:
lib/libc/stdio/getdelim.3 | 20 +++++++++++++++++---
1 files changed, 17 insertions(+), 3 deletions(-)
diffs (51 lines):
diff -r 9a214a23b76b -r 52d8979d6c82 lib/libc/stdio/getdelim.3
--- a/lib/libc/stdio/getdelim.3 Mon Nov 30 21:40:35 2009 +0000
+++ b/lib/libc/stdio/getdelim.3 Mon Nov 30 22:51:46 2009 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: getdelim.3,v 1.3 2009/08/25 16:28:26 wiz Exp $
+.\" $NetBSD: getdelim.3,v 1.4 2009/11/30 22:51:46 roy Exp $
.\"
.\" Copyright (c) 2009 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd August 25, 2009
+.Dd November 30, 2009
.Dt GETDELIM 3
.Os
.Sh NAME
@@ -86,9 +86,23 @@
and
.Fn getline
functions return the number of characters read, including the delimiter.
+If no characters were read and the stream is at end-of-file, the functions
+return \-1.
If an error occurs, the functions return \-1 and the global variable
.Va errno
is set to indicate the error.
+.Sh EXAMPLE
+The following code fragment reads lines from a file and writes them to
+standard output.
+.Bd -literal -offset indent
+char *line = NULL;
+size_t linesize = 0;
+ssize_t linelen;
+while ((linelen = getline(&line, &linesize, fp)) != -1)
+ fwrite(line, linelen, 1, stdout);
+
+if (ferror(fp))
+ perror("getline");
.Sh ERRORS
.Bl -tag -width [EOVERFLOW]
.It Bq Er EINVAL
@@ -99,7 +113,7 @@
.Dv NULL
pointer.
.It Bq Er EOVERFLOW
-More than ssize_t characters were read without encountering the delimiter.
+More than SSIZE_MAX characters were read without encountering the delimiter.
.El
.Pp
The
Home |
Main Index |
Thread Index |
Old Index