Add documentation, expand error handling, implement file and buffer io

include/bh/buffer.h

@@ -0,0 +1,91 @@
+#ifndef BH_BUFFER_H
+#define BH_BUFFER_H
+
+#include "io.h"
+
+typedef struct bh_buffer_s bh_buffer_t;
+
+bh_buffer_t *bh_buffer_new(void);
+
+void bh_buffer_free(bh_buffer_t *buffer);
+
+const char *bh_buffer_data(bh_buffer_t *buffer);
+
+void bh_buffer_set_data(bh_buffer_t *buffer,
+                        const char *data,
+                        size_t size);
+
+size_t bh_buffer_capacity(bh_buffer_t *buffer);
+
+int bh_buffer_reserve(bh_buffer_t *buffer,
+                      size_t size);
+
+int bh_buffer_open_base(bh_buffer_t *buffer,
+                        int mode);
+
+void bh_buffer_close_base(bh_buffer_t *buffer);
+
+int bh_buffer_is_open_base(bh_buffer_t *buffer);
+
+size_t bh_buffer_read_base(bh_buffer_t *buffer,
+                           char *data,
+                           size_t size);
+
+size_t bh_buffer_write_base(bh_buffer_t *buffer,
+                            const char *data,
+                            size_t size);
+
+void bh_buffer_flush_base(bh_buffer_t *buffer);
+
+int bh_buffer_seek_base(bh_buffer_t *buffer,
+                        bh_off_t pos,
+                        int dir);
+
+bh_off_t bh_buffer_size_base(bh_buffer_t *buffer);
+
+bh_off_t bh_buffer_tell_base(bh_buffer_t *buffer);
+
+bh_off_t bh_buffer_available_base(bh_buffer_t *buffer);
+
+void bh_buffer_clear_base(bh_buffer_t *buffer);
+
+#define bh_buffer_open(buffer, mode) \
+    bh_io_open((bh_io_t *)(buffer), (mode))
+
+#define bh_buffer_close(buffer) \
+    bh_io_close((bh_io_t *)(buffer))
+
+#define bh_buffer_is_open(buffer) \
+    bh_io_is_open((bh_io_t *)(buffer))
+
+#define bh_buffer_read(buffer, data, size) \
+    bh_io_read((bh_io_t *)(buffer), (data), (size))
+
+#define bh_buffer_write(buffer, data, size) \
+    bh_io_write((bh_io_t *)(buffer), (data), (size))
+
+#define bh_buffer_flush(buffer) \
+    bh_io_flush((bh_io_t *)(buffer))
+
+#define bh_buffer_seek(buffer, pos, dir) \
+    bh_io_seek((bh_io_t *)(buffer), (pos), (dir))
+
+#define bh_buffer_size(buffer) \
+    bh_io_size((bh_io_t *)(buffer))
+
+#define bh_buffer_tell(buffer) \
+    bh_io_tell((bh_io_t *)(buffer))
+
+#define bh_buffer_available(buffer) \
+    bh_io_available((bh_io_t *)(buffer))
+
+#define bh_buffer_clear(buffer) \
+    bh_io_clear((bh_io_t *)(buffer))
+
+#define bh_buffer_error(buffer) \
+    bh_io_error((bh_io_t *)(buffer))
+
+#define bh_buffer_eof(buffer) \
+    bh_io_eof((bh_io_t *)(buffer))
+
+#endif /* BH_BUFFER_H */