aboutsummaryrefslogtreecommitdiffstats
path: root/serd/serd.h
diff options
context:
space:
mode:
Diffstat (limited to 'serd/serd.h')
-rw-r--r--serd/serd.h52
1 files changed, 46 insertions, 6 deletions
diff --git a/serd/serd.h b/serd/serd.h
index 79f164ea..94499a4d 100644
--- a/serd/serd.h
+++ b/serd/serd.h
@@ -267,10 +267,55 @@ serd_strlen(const uint8_t* str, size_t* n_bytes, SerdNodeFlags* flags);
/**
@}
- @name URI
+ @name Sink
@{
*/
+/**
+ Sink function for raw string output.
+*/
+typedef size_t (*SerdSink)(const void* buf, size_t len, void* stream);
+
+/**
+ Sink adapter that writes blocks to the target sink.
+
+ This is itself a SerdSink which can be used with any SerdSink as a target to
+ transparently write chunked I/O to the output sink. This can significantly
+ improve write performance when the target is a file or similar resource.
+*/
+typedef struct SerdBulkSinkImpl SerdBulkSink;
+
+/**
+ Create a new bulk sink adapter.
+ @param sink Target sink where completed blocks will be written.
+ @param stream Stream parameter for target sink.
+ @param block_size Size of blocks to write, and internal buffer size.
+*/
+SERD_API
+SerdBulkSink*
+serd_bulk_sink_new(SerdSink sink, void* stream, size_t block_size);
+
+/**
+ Free a bulk sink adapter.
+*/
+SERD_API
+void
+serd_bulk_sink_free(SerdBulkSink* bsink);
+
+/**
+ Write data to a bulk sink adapter.
+
+ This function may safely be cast to SerdSink.
+*/
+SERD_API
+size_t
+serd_bulk_sink_write(const void* buf, size_t len, SerdBulkSink* bsink);
+
+/**
+ @}
+ @name URI
+ @{
+*/
static const SerdURI SERD_URI_NULL = {{0,0},{0,0},{0,0},{0,0},{0,0},{0,0}};
/**
@@ -302,11 +347,6 @@ void
serd_uri_resolve(const SerdURI* uri, const SerdURI* base, SerdURI* out);
/**
- Sink function for raw string output.
-*/
-typedef size_t (*SerdSink)(const void* buf, size_t len, void* stream);
-
-/**
Serialise @c uri with a series of calls to @c sink.
*/
SERD_API