Next: gets
—get character string (obsolete, use fgets
instead), Previous: getdelim
—read a line up to a specified line delimiter, Up: Input and Output (stdio.h) [Contents][Index]
getline
—read a line from a fileSynopsis
#include <stdio.h> ssize_t getline(char **bufptr, size_t *n, FILE *fp);
Description
getline
reads a file fp up to and possibly including the
newline character. The line is read into a buffer pointed to
by bufptr and designated with size *n. If the buffer is
not large enough, it will be dynamically grown by getdelim
.
As the buffer is grown, the pointer to the size n will be
updated.
getline
is equivalent to getdelim(bufptr, n, ’\n’, fp);
Returns
getline
returns -1
if no characters were successfully read,
otherwise, it returns the number of bytes successfully read.
at end of file, the result is nonzero.
Portability
getline
is a glibc extension.
No supporting OS subroutines are directly required.