Mon Nov 30 23:23:29 2009 UTC ()

Note that callers should use feof(3) or ferror(3) to distinguish between
EOF or an error.


(roy)

diff -r1.4 -r1.5 src/lib/libc/stdio/getdelim.3

--- src/lib/libc/stdio/getdelim.3 2009/11/30 22:51:46	1.4
+++ src/lib/libc/stdio/getdelim.3 2009/11/30 23:23:29	1.5

 @@ -1,14 +1,14 @@
-.\"     $NetBSD: getdelim.3,v 1.4 2009/11/30 22:51:46 roy Exp $
+.\"     $NetBSD: getdelim.3,v 1.5 2009/11/30 23:23:29 roy Exp $
 .\"
 .\" Copyright (c) 2009 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" This code is derived from software contributed to The NetBSD Foundation
 .\" by Roy Marples.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 @@ -81,26 +81,33 @@ is equivalent to
 .Fa getdelim
 with the delimiter set to the newline character.
 .Sh RETURN VALUES
 The
 .Fn getdelim
 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.
 .Pp
 The functions do not distinguish between end-of-file and error,
 and callers must use
 .Xr feof 3
 and
 .Xr ferror 3
 to determine which occurred.
 .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