From 7b3cb7088d59fca697b04832737e6a6d06d00ea6 Mon Sep 17 00:00:00 2001 From: Eugene Triguba Date: Wed, 3 Jul 2024 21:20:32 -0400 Subject: Initial Commit --- src/linebuffer.h | 86 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 86 insertions(+) create mode 100644 src/linebuffer.h (limited to 'src/linebuffer.h') diff --git a/src/linebuffer.h b/src/linebuffer.h new file mode 100644 index 0000000..b6f6e7e --- /dev/null +++ b/src/linebuffer.h @@ -0,0 +1,86 @@ +#ifndef LINEBUFFER_H +#define LINEBUFFER_H + +#include +#include + +typedef struct { + size_t _num_words; + size_t _buffer_length; + size_t _buffer_capacity; + char *_buffer; +} LineBuffer; + +/** + * Create a new LineBuffer + * + * Args: + * line_length: The length of the buffer to use. + * + * Returns: + * The newly allocated LineBuffer; otherwise NULL + * if the allocation fails. + */ +LineBuffer *linebuffer_create(size_t line_length); + +/** + * Release any allocated memory for the LineBuffer + * + * Args: + * lb: The LineBuffer to destroy. + */ +void linebuffer_destroy(LineBuffer *lb); + +/** + * Clear the current buffer + * + * Args: + * lb: The LineBuffer to clear. + */ +void linebuffer_clear(LineBuffer *lb); + +/** + * Append a word to the end of the buffer. + * + * Args: + * lb: The line buffer to append to. + * word: The word to append. + */ +void linebuffer_append_word(LineBuffer *lb, const char *word); + +/** + * Check how many characters can be added. + * + * Args: + * lb: The line buffer to check the space of. + * + * Returns: + * The number of characters left in the line. + */ +size_t linebuffer_space_remaining(LineBuffer *lb); + +/** + * Write the current line. + * + * Args: + * lb: The line buffer to read. + * fp: The file to write out the line buffer to. + * + * Returns: + * >= 0 on success; EOF on error. + */ +int linebuffer_write(LineBuffer *lb, FILE *fp); + +/** + * Write the current line as justified text. + * + * Args: + * lb: The line buffer to read. + * fp: The file to write out the line buffer to. + * + * Returns: + * >= 0 on success; EOF on error. + */ +int linebuffer_write_justified(LineBuffer *lb, FILE *fp); + +#endif -- cgit v1.2.3