lib/linebuffer.h

   1 /* linebuffer.h -- declarations for reading arbitrarily long lines
   2
   3    Copyright (C) 1986, 1991, 1998-1999, 2002-2003, 2007, 2009-2020 Free
   4    Software Foundation, Inc.
   5
   6    This program is free software: you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 3 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  18
  19 #if !defined LINEBUFFER_H
  20 # define LINEBUFFER_H
  21
  22 # include <stdio.h>
  23
  24 /* A 'struct linebuffer' holds a line of text. */
  25
  26 struct linebuffer
  27 {
  28   size_t size;                  /* Allocated. */
  29   size_t length;                /* Used. */
  30   char *buffer;
  31 };
  32
  33 /* Initialize linebuffer LINEBUFFER for use. */
  34 void initbuffer (struct linebuffer *linebuffer);
  35
  36 /* Read an arbitrarily long line of text from STREAM into LINEBUFFER.
  37    Consider lines to be terminated by DELIMITER.
  38    Keep the delimiter; append DELIMITER if we reach EOF and it wasn't
  39    the last character in the file.  Do not NUL-terminate.
  40    Return LINEBUFFER, except at end of file return NULL.  */
  41 struct linebuffer *readlinebuffer_delim (struct linebuffer *linebuffer,
  42                                          FILE *stream, char delimiter);
  43
  44 /* Read an arbitrarily long line of text from STREAM into LINEBUFFER.
  45    Keep the newline; append a newline if it's the last line of a file
  46    that ends in a non-newline character.  Do not NUL-terminate.
  47    Return LINEBUFFER, except at end of file return NULL.  */
  48 struct linebuffer *readlinebuffer (struct linebuffer *linebuffer, FILE *stream);
  49
  50 /* Free linebuffer LINEBUFFER and its data, all allocated with malloc. */
  51 void freebuffer (struct linebuffer *);
  52
  53 #endif /* LINEBUFFER_H */