diff options
Diffstat (limited to 'lib/linebuffer.h')
-rw-r--r-- | lib/linebuffer.h | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/lib/linebuffer.h b/lib/linebuffer.h new file mode 100644 index 0000000..07d45ca --- /dev/null +++ b/lib/linebuffer.h @@ -0,0 +1,54 @@ +/* linebuffer.h -- declarations for reading arbitrarily long lines + + Copyright (C) 1986, 1991, 1998-1999, 2002-2003, 2007, 2009-2022 Free + Software Foundation, Inc. + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see <https://www.gnu.org/licenses/>. */ + +#if !defined LINEBUFFER_H +# define LINEBUFFER_H + +# include "idx.h" +# include <stdio.h> + +/* A 'struct linebuffer' holds a line of text. */ + +struct linebuffer +{ + idx_t size; /* Allocated. */ + idx_t length; /* Used. */ + char *buffer; +}; + +/* Initialize linebuffer LINEBUFFER for use. */ +void initbuffer (struct linebuffer *linebuffer); + +/* Read an arbitrarily long line of text from STREAM into LINEBUFFER. + Consider lines to be terminated by DELIMITER. + Keep the delimiter; append DELIMITER if we reach EOF and it wasn't + the last character in the file. Do not NUL-terminate. + Return LINEBUFFER, except at end of file return NULL. */ +struct linebuffer *readlinebuffer_delim (struct linebuffer *linebuffer, + FILE *stream, char delimiter); + +/* Read an arbitrarily long line of text from STREAM into LINEBUFFER. + Keep the newline; append a newline if it's the last line of a file + that ends in a non-newline character. Do not NUL-terminate. + Return LINEBUFFER, except at end of file return NULL. */ +struct linebuffer *readlinebuffer (struct linebuffer *linebuffer, FILE *stream); + +/* Free linebuffer LINEBUFFER and its data, all allocated with malloc. */ +void freebuffer (struct linebuffer *); + +#endif /* LINEBUFFER_H */ |