Loading Atoms

typedef struct SratomLoaderImpl SratomLoader

Atom loader that reads atoms from a document.

SratomLoader *sratom_loader_new(SerdWorld *world, LV2_URID_Map *map)

Create a new loader for forging atoms from a document.

Parameters

  • world – RDF world.

  • map – URID mapper.

Returns

A new object that must be freed with sratom_loader_free().

void sratom_loader_free(SratomLoader *loader)

Free an atom loader created with sratom_loader_new()

SratomStatus sratom_load(SratomLoader *loader, const SerdNode *base_uri, LV2_Atom_Forge *forge, const SerdModel *model, const SerdNode *node)

Load an atom from a model by forging the binary representation.

This reads node in model as an atom, constructing the result with forge.

Parameters

  • loader – Loader set up with the appropriate world and URID map.

  • base_uri – Base URI for making relative URI references. This is typically used with file URIs to construct atoms with relative paths. Any URI within the given base URI will be written to forge as a relative URI reference. For example, with base URI file:///my/data/, the URI file:///my/data/dir/file.txt will be written to the forge as the path “dir/file.txt”.

  • forge – Atom forge where the result is written.

  • model – Model that contains a description of the atom.

  • node – Node for the atom. This can be a simple literal node for primitive atoms, or the subject resource for more complex structures like objects and vectors.

Returns

A status code which is zero on success.

LV2_Atom *sratom_from_string(SratomLoader *loader, SerdEnv *env, const char *str)

Load an Atom from a Turtle string.

The returned atom must be free()’d by the caller.

LV2_Atom *sratom_from_model(SratomLoader *loader, const SerdNode *base_uri, const SerdModel *model, const SerdNode *subject)

Load an Atom from a model.

The returned atom must be free()’d by the caller.