diff options
author | David Robillard <d@drobilla.net> | 2016-03-15 23:21:34 -0400 |
---|---|---|
committer | David Robillard <d@drobilla.net> | 2020-10-27 13:13:58 +0100 |
commit | c63451092692c251cab874475d3540408ed5d8c2 (patch) | |
tree | 02a91a059723946c5db5f11977a79d1f1aed1a85 /serd | |
parent | 203ca287b9fe7dc00f02ac5e354260cfedfeac93 (diff) | |
download | serd-c63451092692c251cab874475d3540408ed5d8c2.tar.gz serd-c63451092692c251cab874475d3540408ed5d8c2.tar.bz2 serd-c63451092692c251cab874475d3540408ed5d8c2.zip |
Add SerdBuffer type for mutable buffers
This avoids const violations from abusing SerdChunk as a mutable buffer
for string sinks.
Diffstat (limited to 'serd')
-rw-r--r-- | serd/serd.h | 20 |
1 files changed, 14 insertions, 6 deletions
diff --git a/serd/serd.h b/serd/serd.h index c1e8ba8e..08a5e151 100644 --- a/serd/serd.h +++ b/serd/serd.h @@ -234,6 +234,14 @@ typedef struct { } SerdChunk; /** + A mutable buffer in memory. +*/ +typedef struct { + void* buf; /**< Buffer */ + size_t len; /**< Size of buffer in bytes */ +} SerdBuffer; + +/** An error description. */ typedef struct { @@ -975,24 +983,24 @@ serd_file_sink(const void* buf, size_t len, void* stream); /** A convenience sink function for writing to a string. - This function can be used as a SerdSink to write to a SerdChunk which is + This function can be used as a SerdSink to write to a SerdBuffer which is resized as necessary with realloc(). The `stream` parameter must point to - an initialized SerdChunk. When the write is finished, the string should be - retrieved with serd_chunk_sink_finish(). + an initialized SerdBuffer. When the write is finished, the string should be + retrieved with serd_buffer_sink_finish(). */ SERD_API size_t -serd_chunk_sink(const void* buf, size_t len, void* stream); +serd_buffer_sink(const void* buf, size_t len, void* stream); /** - Finish a serialisation to a chunk with serd_chunk_sink(). + Finish a serialisation to a chunk with serd_buffer_sink(). The returned string is the result of the serialisation, which is NULL terminated (by this function) and owned by the caller. */ SERD_API uint8_t* -serd_chunk_sink_finish(SerdChunk* stream); +serd_buffer_sink_finish(SerdBuffer* stream); /** Set a function to be called when errors occur during writing. |