2005-01-28 Andrew J. Schorr <ajschorr@alumni.princeton.edu>
* lib/buffer.h: Document behavior of buffer_getstr function.
* lib/buffer.c: (buffer_getstr) Fix bug: must handle case where
the string extends beyond the head struct buffer_data.
diff --git a/lib/buffer.h b/lib/buffer.h
index 65b8a8c..c3787d7 100644
--- a/lib/buffer.h
+++ b/lib/buffer.h
@@ -65,7 +65,14 @@
struct buffer *buffer_new (size_t);
int buffer_write (struct buffer *, const void *, size_t);
void buffer_free (struct buffer *);
+
+/* Combine all accumulated (and unflushed) data inside the buffer into a
+ single NUL-terminated string allocated using malloc (N.B. should be changed
+ to use XMALLOC(MTYPE_TMP)). Note that this function does not alter
+ the state of the buffer, so the data is still inside waiting to be
+ flushed. */
char *buffer_getstr (struct buffer *);
+
int buffer_putc (struct buffer *, u_char);
int buffer_putstr (struct buffer *, const char *);
void buffer_reset (struct buffer *);