aboutsummaryrefslogtreecommitdiffstats
path: root/serd/serd.h
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2018-04-29 15:24:05 +0200
committerDavid Robillard <d@drobilla.net>2018-05-27 18:21:57 +0200
commit40268925466dba7a37b468be0bba951e7f6ca5d1 (patch)
tree066808e4923a0fb0cce7d4609e021e0b0907b5ea /serd/serd.h
parent129bc1d39254ff4c56e9cffab6d064bc5863ea2f (diff)
downloadserd-40268925466dba7a37b468be0bba951e7f6ca5d1.tar.gz
serd-40268925466dba7a37b468be0bba951e7f6ca5d1.tar.bz2
serd-40268925466dba7a37b468be0bba951e7f6ca5d1.zip
Add SerdWorld for shared library state
Diffstat (limited to 'serd/serd.h')
-rw-r--r--serd/serd.h72
1 files changed, 46 insertions, 26 deletions
diff --git a/serd/serd.h b/serd/serd.h
index 4e9b5d48..715ff22a 100644
--- a/serd/serd.h
+++ b/serd/serd.h
@@ -56,6 +56,13 @@ extern "C" {
*/
/**
+ World.
+
+ The World represents all library state shared between various objects.
+*/
+typedef struct SerdWorldImpl SerdWorld;
+
+/**
Environment.
Represents the state required to resolve a CURIE or relative URI, e.g. the
@@ -695,6 +702,41 @@ typedef struct SerdSinkInterface {
/**
@}
+ @name World
+ @{
+*/
+
+/**
+ Create a new Serd World.
+
+ It is safe to use multiple worlds in one process, though no objects can be
+ shared between worlds.
+*/
+SERD_API
+SerdWorld*
+serd_world_new(void);
+
+/**
+ Free `world`.
+*/
+SERD_API
+void
+serd_world_free(SerdWorld* world);
+
+/**
+ Set a function to be called when errors occur.
+
+ The `error_sink` will be called with `handle` as its first argument. If
+ no error function is set, errors are printed to stderr.
+*/
+SERD_API
+void
+serd_world_set_error_sink(SerdWorld* world,
+ SerdErrorSink error_sink,
+ void* handle);
+
+/**
+ @}
@name Environment
@{
*/
@@ -800,7 +842,8 @@ serd_env_foreach(const SerdEnv* env,
*/
SERD_API
SerdReader*
-serd_reader_new(SerdSyntax syntax,
+serd_reader_new(SerdWorld* world,
+ SerdSyntax syntax,
const SerdSinkInterface* sink);
/**
@@ -815,18 +858,6 @@ void
serd_reader_set_strict(SerdReader* reader, bool strict);
/**
- Set a function to be called when errors occur during reading.
-
- The `error_sink` will be called with `handle` as its first argument. If
- no error function is set, errors are printed to stderr in GCC style.
-*/
-SERD_API
-void
-serd_reader_set_error_sink(SerdReader* reader,
- SerdErrorSink error_sink,
- void* error_handle);
-
-/**
Return the `handle` passed to serd_reader_new().
*/
SERD_API
@@ -944,7 +975,8 @@ serd_reader_free(SerdReader* reader);
*/
SERD_API
SerdWriter*
-serd_writer_new(SerdSyntax syntax,
+serd_writer_new(SerdWorld* world,
+ SerdSyntax syntax,
SerdStyle style,
SerdEnv* env,
const SerdURI* base_uri,
@@ -1005,18 +1037,6 @@ char*
serd_buffer_sink_finish(SerdBuffer* stream);
/**
- Set a function to be called when errors occur during writing.
-
- The `error_sink` will be called with `handle` as its first argument. If
- no error function is set, errors are printed to stderr.
-*/
-SERD_API
-void
-serd_writer_set_error_sink(SerdWriter* writer,
- SerdErrorSink error_sink,
- void* error_handle);
-
-/**
Set a prefix to be removed from matching blank node identifiers.
*/
SERD_API