Next: getline
—read a line from a file, Previous: getchar_unlocked
—non-thread-safe version of getchar (macro), Up: Input and Output (stdio.h) [Contents][Index]
getdelim
—read a line up to a specified line delimiterSynopsis
#include <stdio.h> int getdelim(char **bufptr, size_t *n, int delim, FILE *fp);
Description
getdelim
reads a file fp up to and possibly including a specified
delimiter delim. 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.
Returns
getdelim
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
getdelim
is a glibc extension.
No supporting OS subroutines are directly required.