1 /* getnline - Read a line from a stream, with bounded memory allocation. 2 3 Copyright (C) 2003, 2004 Free Software Foundation, Inc. 4 5 This program is free software; you can redistribute it and/or modify 6 it under the terms of the GNU General Public License as published by 7 the Free Software Foundation; either version 2, or (at your option) 8 any later version. 9 10 This program is distributed in the hope that it will be useful, 11 but WITHOUT ANY WARRANTY; without even the implied warranty of 12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 GNU General Public License for more details. 14 15 You should have received a copy of the GNU General Public License 16 along with this program; if not, write to the Free Software Foundation, 17 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ 18 19 #ifndef GETNLINE_H 20 #define GETNLINE_H 1 21 22 #include <stdio.h> 23 #include <sys/types.h> 24 25 #define GETNLINE_NO_LIMIT ((size_t) -1) 26 27 /* Read a line, up to the next newline, from STREAM, and store it in *LINEPTR. 28 *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE 29 bytes of space. It is realloc'd as necessary. Reallocation is limited to 30 NMAX bytes; if the line is longer than that, the extra bytes are read but 31 thrown away. 32 Return the number of bytes read and stored at *LINEPTR (not including the 33 NUL terminator), or -1 on error or EOF. */ 34 extern ssize_t getnline (char **lineptr, size_t *linesize, size_t nmax, 35 FILE *stream); 36 37 /* Read a line, up to the next occurrence of DELIMITER, from STREAM, and store 38 it in *LINEPTR. 39 *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE 40 bytes of space. It is realloc'd as necessary. Reallocation is limited to 41 NMAX bytes; if the line is longer than that, the extra bytes are read but 42 thrown away. 43 Return the number of bytes read and stored at *LINEPTR (not including the 44 NUL terminator), or -1 on error or EOF. */ 45 extern ssize_t getndelim (char **lineptr, size_t *linesize, size_t nmax, 46 int delimiter, FILE *stream); 47 48 #endif /* GETNLINE_H */ 49