diff options
| -rw-r--r-- | slv2/plugin.h | 36 | ||||
| -rw-r--r-- | src/plugin.c | 20 |
2 files changed, 47 insertions, 9 deletions
diff --git a/slv2/plugin.h b/slv2/plugin.h index 3cc2f8c..f5add26 100644 --- a/slv2/plugin.h +++ b/slv2/plugin.h @@ -131,24 +131,42 @@ char* slv2_plugin_get_name(SLV2Plugin plugin); -/** Request some arbitrary RDF object of the plugin. +/** Get a value associated with the plugin in a plugin's data files. * - * May return NULL if the property was not found (ie is not defined in the - * data file), or if object is not sensibly represented as an SLV2Strings - * (e.g. blank nodes). + * Returns the ?object of all triples found of the form: * - * Return value must be freed by caller with slv2_value_free. + * <code><plugin-uri> predicate ?object</code> + * + * May return NULL if the property was not found, or if object is not + * sensibly represented as an SLV2Strings (e.g. blank nodes). * - * Note that this may return multiple values. If the property is a - * string with multiple languages defined, the translation according to - * $LANG will be returned if it is set. Otherwise all values will be - * returned. + * Return value must be freed by caller with slv2_strings_free. */ SLV2Strings slv2_plugin_get_value(SLV2Plugin p, const char* predicate); +/** Get a value associated with some subject in a plugin's data files. + * + * Returns the ?object of all triples found of the form: + * + * <code>subject predicate ?object</code> + * + * This can be used to investigate URIs returned by slv2_plugin_get_value + * (if information about it is contained in the plugin's data files). + * + * May return NULL if the property was not found, or if object is not + * sensibly represented as an SLV2Strings (e.g. blank nodes). + * + * Return value must be freed by caller with slv2_strings_free. + */ +SLV2Strings +slv2_plugin_get_value_for_subject(SLV2Plugin p, + const char* subject, + const char* predicate); + + /** Get the LV2 Properties of a plugin. * * LV2 Properties are mandatory. Hosts MUST NOT use a plugin if they do not diff --git a/src/plugin.c b/src/plugin.c index 8441aec..abb577b 100644 --- a/src/plugin.c +++ b/src/plugin.c @@ -172,6 +172,26 @@ slv2_plugin_get_value(SLV2Plugin p, return result; } + +SLV2Strings +slv2_plugin_get_value_for_subject(SLV2Plugin p, + const char* subject, + const char* predicate) +{ + assert(predicate); + + char* query = slv2_strjoin( + "SELECT DISTINCT ?value WHERE {\n", + subject, " ", predicate, " ?value .\n" + "}\n", NULL); + + SLV2Strings result = slv2_plugin_simple_query(p, query, "value"); + + free(query); + + return result; +} + SLV2Strings slv2_plugin_get_properties(SLV2Plugin p) |