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.  */
34extern 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.  */
45extern ssize_t getndelim (char **lineptr, size_t *linesize, size_t nmax,
46			  int delimiter, FILE *stream);
47
48#endif /* GETNLINE_H */
49