diff options
author | David Robillard <d@drobilla.net> | 2018-10-28 14:00:47 +0100 |
---|---|---|
committer | David Robillard <d@drobilla.net> | 2018-11-25 22:12:47 +0100 |
commit | 01ce25ac77fb1d8109cb45796ad9b4da1f9e8349 (patch) | |
tree | a85bab75c089bd27488922e5f36885d248d48181 /serd | |
parent | 6a95fc336970abdbc9583e6da55ae6c244fc6142 (diff) | |
download | serd-01ce25ac77fb1d8109cb45796ad9b4da1f9e8349.tar.gz serd-01ce25ac77fb1d8109cb45796ad9b4da1f9e8349.tar.bz2 serd-01ce25ac77fb1d8109cb45796ad9b4da1f9e8349.zip |
Add SerdNodes class for storing a cache of nodes
Diffstat (limited to 'serd')
-rw-r--r-- | serd/serd.h | 65 |
1 files changed, 65 insertions, 0 deletions
diff --git a/serd/serd.h b/serd/serd.h index 0dc95d5e..444330f9 100644 --- a/serd/serd.h +++ b/serd/serd.h @@ -63,6 +63,14 @@ extern "C" { typedef struct SerdWorldImpl SerdWorld; /** + Nodes. + + A hashing container for nodes that can be used for interning and simplified + memory management. +*/ +typedef struct SerdNodesImpl SerdNodes; + +/** Statement. A subject, predicate, and object, with optional graph context. @@ -1302,6 +1310,63 @@ serd_writer_finish(SerdWriter* writer); /** @} + @name Nodes + @{ +*/ + +/** + Create a new node set. +*/ +SERD_API +SerdNodes* +serd_nodes_new(void); + +/** + Free `nodes` and all nodes that are stored in it. + + Note that this invalidates any pointers previously returned from + `serd_nodes_intern()` or `serd_nodes_manage()` calls on `nodes`. +*/ +SERD_API +void +serd_nodes_free(SerdNodes* nodes); + +/** + Intern `node`. + + Multiple calls with equivalent nodes will return the same pointer. + + @return A node that is different than, but equivalent to, `node`. +*/ +SERD_API +const SerdNode* +serd_nodes_intern(SerdNodes* nodes, const SerdNode* node); + +/** + Manage `node`. + + Like `serd_nodes_intern`, but takes ownership of `node`, freeing it and + returning a previously interned/managed equivalent node if necessary. + + @return A node that is equivalent to `node`. +*/ +SERD_API +const SerdNode* +serd_nodes_manage(SerdNodes* nodes, SerdNode* node); + +/** + Dereference `node`. + + Decrements the reference count of `node`, and frees the internally stored + equivalent node if this was the last reference. Does nothing if no node + equivalent to `node` is stored in `nodes`. +*/ +SERD_API +void +serd_nodes_deref(SerdNodes* nodes, const SerdNode* node); + +/** + @} @name Statement @{ */ |