diff options
Diffstat (limited to 'newlib/libc/stdio/getline.c')
-rw-r--r-- | newlib/libc/stdio/getline.c | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/newlib/libc/stdio/getline.c b/newlib/libc/stdio/getline.c new file mode 100644 index 000000000..741a7dc77 --- /dev/null +++ b/newlib/libc/stdio/getline.c @@ -0,0 +1,54 @@ +/* +FUNCTION +<<getline>>---read a line from a file + +INDEX + getline + +ANSI_SYNOPSIS + #include <stdio.h> + ssize_t getline(char **<[bufptr]>, size_t *<[n]>, FILE *<[fp]>); + +TRAD_SYNOPSIS + #include <stdio.h> + ssize_t getline(<[bufptr]>, <[n]>, <[fp]>) + 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. +*/ + +/* Copyright 2002, Red Hat Inc. - all rights reserved */ + +#include <stdio.h> + +extern ssize_t __getdelim (char **, size_t *, int, FILE *); + +ssize_t +__getline (lptr, n, fp) + char **lptr; + size_t *n; + FILE *fp; +{ + return __getdelim (lptr, n, '\n', fp); +} + |