lib/getnline.h

   1 /* getnline - Read a line from a stream, with bounded memory allocation.
   2
   3    Copyright (C) 2003-2004, 2009-2025 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 3 of the License, or
   8    (at your option) 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, see <https://www.gnu.org/licenses/>.  */
  17
  18 #ifndef GETNLINE_H
  19 #define GETNLINE_H 1
  20
  21 #include <stdio.h>
  22 #include <sys/types.h>
  23
  24 #ifdef __cplusplus
  25 extern "C" {
  26 #endif
  27
  28
  29 #define GETNLINE_NO_LIMIT ((size_t) -1)
  30
  31 /* Read a line, up to the next newline, from STREAM, and store it in *LINEPTR.
  32    *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
  33    bytes of space.  It is realloc'd as necessary.  Reallocation is limited to
  34    NMAX bytes; if the line is longer than that, the extra bytes are read but
  35    thrown away.
  36    Return the number of bytes read and stored at *LINEPTR (not including the
  37    NUL terminator), or -1 on error or EOF.  */
  38 extern ssize_t getnline (char **lineptr, size_t *linesize, size_t nmax,
  39                          FILE *stream);
  40
  41 /* Read a line, up to the next occurrence of DELIMITER, from STREAM, and store
  42    it in *LINEPTR.
  43    *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
  44    bytes of space.  It is realloc'd as necessary.  Reallocation is limited to
  45    NMAX bytes; if the line is longer than that, the extra bytes are read but
  46    thrown away.
  47    Return the number of bytes read and stored at *LINEPTR (not including the
  48    NUL terminator), or -1 on error or EOF.  */
  49 extern ssize_t getndelim (char **lineptr, size_t *linesize, size_t nmax,
  50                           int delimiter, FILE *stream);
  51
  52
  53 #ifdef __cplusplus
  54 }
  55 #endif
  56
  57 #endif /* GETNLINE_H */