lod_locate

Locate data about a subject within a model's context

Synopsis

#include <liblod.h>

LODINSTANCE *lod_locate(LODCONTEXT *context, const char *uri);

Description

lod_locate attempts to locate triples where uri is the subject URI within the model associated with context. In contrast to lod_fetch and lod_resolve, lod_locate will make no attempt to fetch additional data if no triples where uri is the subject are present in the model.

Return value

Upon success, lod_locate returns a new LODINSTANCE, which should be later freed using lod_instance_destroy.

If an error occurs, or uri was not a subject of any triple in the context's model, lod_locate returns NULL.

Use lod_error to determine whether an error occurred, or whether the subject does not exist in the data. If an error does occur, you can use lod_errmsg to obtain a description of the error condition.

See also

liblod, lod_resolve, lod_fetch, lod_create, lod_error, lod_errmsg, lod_instance_exists, lod_instance_stream, librdf_parser_create.