core: add b_stream interface

b_stream represents a character-based I/O stream. it is an abstract interface
that can be implemented by any other object, allowing the object to be
interacted with via the b_stream api.

core/include/blue/core/stream.h

@@ -0,0 +1,102 @@
+#ifndef BLUELIB_CORE_STREAM_H_
+#define BLUELIB_CORE_STREAM_H_
+
+#include <blue/core/misc.h>
+#include <blue/core/status.h>
+#include <stdarg.h>
+
+#define b_stdin  (z__b_stream_get_stdin())
+#define b_stdout (z__b_stream_get_stdout())
+#define b_stderr (z__b_stream_get_stderr())
+
+typedef enum b_stream_pipeline_flags {
+	B_STREAM_PIPELINE_F_NONE = 0x00u,
+	B_STREAM_PIPELINE_F_DYNAMIC = 0x01u,
+	B_STREAM_PIPELINE_F_BUF_DYNAMIC = 0x02u,
+} b_stream_pipeline_flags;
+
+typedef struct b_stream_pipeline {
+	b_stream_pipeline_flags p_flags;
+	void *p_buf;
+	size_t p_buf_len;
+} b_stream_pipeline;
+
+typedef enum b_stream_mode {
+	B_STREAM_READ = 0x01u,
+	B_STREAM_WRITE = 0x02u,
+	B_STREAM_BINARY = 0x10u,
+	Z__B_STREAM_STATIC = 0x80u,
+} b_stream_mode;
+
+typedef enum b_stream_seek_origin {
+	B_STREAM_SEEK_START = 0x01u,
+	B_STREAM_SEEK_CURRENT = 0x02u,
+	B_STREAM_SEEK_END = 0x03u,
+} b_stream_seek_origin;
+
+typedef struct b_stream {
+	b_stream_mode s_mode;
+	size_t s_cursor;
+	int *s_istack;
+	int s_add_indent;
+	size_t s_istack_ptr, s_istack_size;
+	void *s_ptr;
+
+	b_status (*s_close)(struct b_stream *);
+	b_status (*s_seek)(struct b_stream *, long long, b_stream_seek_origin);
+	b_status (*s_getc)(struct b_stream *, int *);
+	b_status (*s_read)(struct b_stream *, unsigned char *, size_t, size_t *);
+	b_status (*s_write)(
+		struct b_stream *, const unsigned char *, size_t, size_t *);
+	b_status (*s_reserve)(struct b_stream *, size_t);
+} b_stream;
+
+BLUE_API b_stream *z__b_stream_get_stdin(void);
+BLUE_API b_stream *z__b_stream_get_stdout(void);
+BLUE_API b_stream *z__b_stream_get_stderr(void);
+
+BLUE_API b_status b_stream_pipeline_create(
+	size_t buffer_size, b_stream_pipeline **out);
+
+BLUE_API b_status b_stream_pipeline_create(
+	size_t buffer_size, b_stream_pipeline **out);
+BLUE_API b_status b_stream_pipeline_init(
+	void *p, size_t len, b_stream_pipeline *out);
+BLUE_API b_status b_stream_pipeline_destroy(b_stream_pipeline *pipeline);
+
+BLUE_API b_status b_stream_close(b_stream *stream);
+BLUE_API b_status b_stream_reserve(b_stream *stream, size_t len);
+BLUE_API b_status b_stream_seek(
+	b_stream *stream, long long offset, b_stream_seek_origin origin);
+BLUE_API size_t b_stream_cursor(const b_stream *stream);
+
+BLUE_API b_status b_stream_push_indent(b_stream *stream, int indent);
+BLUE_API b_status b_stream_pop_indent(b_stream *stream);
+
+BLUE_API b_status b_stream_read_char(b_stream *stream, int *c);
+
+BLUE_API b_status b_stream_read_bytes(
+	b_stream *stream, void *buf, size_t count, size_t *nr_read);
+
+BLUE_API b_status b_stream_read_line(b_stream *stream, char *s, size_t max);
+BLUE_API b_status b_stream_read_line_s(b_stream *src, b_stream *dest);
+
+BLUE_API b_status b_stream_read_all_bytes(
+	b_stream *stream, void *p, size_t max, size_t *nr_read);
+BLUE_API b_status b_stream_read_all_bytes_s(
+	b_stream *src, b_stream *dest, b_stream_pipeline *pipeline,
+	size_t *nr_read);
+
+BLUE_API b_status b_stream_write_char(b_stream *stream, char c);
+BLUE_API b_status b_stream_write_string(
+	b_stream *stream, const char *s, size_t *nr_written);
+
+BLUE_API b_status b_stream_write_bytes(
+	b_stream *stream, void *buf, size_t count, size_t *nr_written);
+
+BLUE_API b_status b_stream_write_fmt(
+	b_stream *stream, size_t *nr_written, const char *format, ...);
+BLUE_API b_status b_stream_write_vfmt(
+	b_stream *stream, size_t *nr_written, const char *format, va_list arg);
+
+#endif