redland(3) Redland RDF Application Framework redland(3)
NAME
redland - Resource Description Framework (RDF) Library
VERSION
1.0.16
SYNOPSIS
#include
DESCRIPTION
redland is a library providing support for the Resource Description
Framework (RDF) written in ANSI C with APIs in several other languages.
This manual page lists most of the redland public API functions but
does not claim to be a complete summary of the entire API. For the
complete API with full details of the function interface, see the HTML
API documentation either on the Redland web site at
or with the software release in the docs/api
directory.
FUNCTIONS
The functions defined by redland are all defined with the "librdf"
prefix
class world
librdfworld* librdfnewworld(void)
void librdffreeworld(librdfworld* world)
void librdfworldopen(librdfworld* world)
void librdfworldseterror(librdfworld* world, void* userdata, void
(*errorfn)(void* userdata, const char* msg, ...))
void librdfworldsetwarning(librdfworld* world, void* userdata,
void (*warningfn)(void* userdata, const char* msg, ...))
void librdfworldsetdigest(librdfworld*, const char* name)
void librdfworldseturishash(librdfworld* world, librdfhash*
urishash)
const char* librdfworldgetfeature(librdfworld* world, librdfuri*
feature)
int librdfworldsetfeature(librdfworld* world, librdfuri* feature,
const char* value)
class iterator
librdfiterator* librdfnewiterator(librdfworld* world, void*
context, int (*isend)(void*), void* (*getnext)(void*), void
(*finished)(void*))
void librdffreeiterator(librdfiterator*)
int librdfiteratorend(librdfiterator* iterator)
int librdfiteratorfinished(librdfiterator* iterator)
int librdfiteratornext(librdfiterator* iterator)
void* librdfiteratorgetobject(librdfiterator* iterator)
void* librdfiteratorgetcontext(librdfiterator* iterator)
void* librdfiteratorgetkey(librdfiterator* iterator)
void* librdfiteratorgetvalue(librdfiterator* iterator)
int librdfiteratoraddmap(librdfiterator* iterator, void*
(*fn)(void* context, void* item), void* context)
void* librdfiteratormapremoveduplicatenodes(void* item, void*
userdata)
class digest
void librdfdigestregisterfactory(librdfworld* world, const char*
name, void (*factory) (librdfdigestfactory*))
librdfdigestfactory* librdfgetdigestfactory(librdfworld* world,
const char* name)
librdfdigest* librdfnewdigest(librdfworld* world, char* name)
librdfdigest* librdfnewdigestfromfactory(librdfworld* world,
librdfdigestfactory* factory)
void librdffreedigest(librdfdigest* digest)
void librdfdigestinit(librdfdigest* digest)
void librdfdigestupdate(librdfdigest* digest, unsigned char* buf,
sizet length)
void librdfdigestfinal(librdfdigest* digest)
void* librdfdigestgetdigest(librdfdigest* digest)
char* librdfdigesttostring(librdfdigest* digest)
void librdfdigestprint(librdfdigest* digest, FILE* fh)
class uri
librdfuri* librdfnewuri(librdfworld* world, const unsigned char *
string)
librdfuri* librdfnewurifromuri(librdfuri* uri)
librdfuri* librdfnewurifromurilocalname(librdfuri* uri, const
unsigned char* localname)
void librdffreeuri(librdfuri* uri)
unsigned char* librdfuriasstring(librdfuri* uri)
unsigned char* librdfuriascountedstring(librdfuri* uri, sizet*
lenp)
librdfdigest* librdfurigetdigest(librdfuri* uri)
void librdfuriprint>(librdfuri* uri, FILE* fh)
unsigned char* librdfuritostring(librdfuri* uri)
unsigned char* librdfuritocountedstring(librdfuri* uri, sizet*
lenp)
int librdfuriequals(librdfuri* firsturi, librdfuri* seconduri)
int librdfuriisfileuri(librdfuri* uri)
const char* librdfuritofilename(librdfuri* uri)
librdfuri* librdfnewurinormalisedtobase(const unsigned char*
uristring, librdfuri* sourceuri, librdfuri* baseuri)
librdfuri* librdfnewurirelativetobase(librdfuri* baseuri, const
unsigned char* uristring)
librdfuri* librdfnewurifromfilename(librdfworld* world, const
char* filename)
class node
librdfnode* librdfnewnode(librdfworld* world)
librdfnode* librdfnewnodefromuristring(librdfworld* world, const
char* string)
librdfnode* librdfnewnodefromuri(librdfworld* world, librdfuri*
uri)
librdfnode* librdfnewnodefromurilocalname(librdfworld* world,
librdfuri* uri, const char* localname)
librdfnode* librdfnewnodefromnormaliseduristring(librdfworld*
world, const char* uristring, librdfuri* sourceuri, librdfuri*
baseuri)
librdfnode* librdfnewnodefromliteral(librdfworld* world, const
char* string, const char* xmllanguage, int xmlspace, int iswfxml)
librdfnode* librdfnewnodefromtypedliteral(librdfworld* world,
const unsigned char* string, const char* xmllanguage, librdfuri*
datatypeuri)
librdfnode* librdfnewnodefromblankidentifier(librdfworld* world,
const unsigned char* identifier)
librdfnode* librdfnewnodefromnode(librdfnode* node)
void librdfnodeinit(librdfworld* world, librdfnode* node)
void librdffreenode(librdfnode* r)
librdfuri* librdfnodegeturi(librdfnode* node)
librdfnodetype librdfnodegettype(librdfnode* node)
unsigned char* librdfnodegetliteralvalue(librdfnode* node)
unsigned char*
librdfnodegetliteralvalueascountedstring(librdfnode* node,
sizet* lenp)
char* librdfnodegetliteralvalueaslatin1(librdfnode* node)
char* librdfnodegetliteralvaluelanguage(librdfnode* node)
int librdfnodegetliteralvalueiswfxml(librdfnode* node)
librdfuri* librdfnodegetliteralvaluedatatypeuri(librdfnode*
node)
int librdfnodegetliordinal(librdfnode* node)
unsigned char* librdfnodegetblankidentifier(librdfnode* node)
int librdfnodeisresource(librdfnode* node)
int librdfnodeisliteral(librdfnode* node)
int librdfnodeisblank(librdfnode* node)
librdfdigest* librdfnodegetdigest(librdfnode* node)
sizet librdfnodeencode(librdfnode* node, unsigned char* buffer,
sizet length)
sizet librdfnodedecode(librdfnode* node, unsigned char* buffer,
sizet length)
unsigned char* librdfnodetostring(librdfnode* node)
unsigned char* librdfnodetocountedstring(librdfnode* node, sizet*
lenp)
void librdfnodeprint(librdfnode* node, FILE* fh)
int librdfnodeequals(librdfnode* firstnode, librdfnode*
secondnode)
class concepts
The library provides macros for all of the RDF and RDFS concepts -
nodes and URIs. For example, "LIBRDFMSAlt" for the librdfnode for
the rdf:Alt concept and "LIBRDFMSAltURI" for the librdfuri for the
URI reference of rdf:Alt.
"LIBRDFURIRDFMS" and "LIBRDFURIRDFSCHEMA" provide the librdfuri
objects for the RDF and RDFS namespace URIs. They must be copied using
librdfnewurifromuri to be shared correctly.
void librdfgetconceptbyname(librdfworld* world, int isms, const
char* name, librdfuri **urip, librdfnode **nodep)
class statement
librdfstatement* librdfnewstatement(librdfworld* world)
librdfstatement* librdfnewstatementfromstatement(librdfstatement*
statement)
librdfstatement* librdfnewstatementfromnodes(librdfworld* world,
librdfnode* subject, librdfnode* predicate, librdfnode* object)
void librdfstatementinit(librdfworld* world, librdfstatement*
statement)
void librdfstatementclear(librdfstatement* statement)
void librdffreestatement(librdfstatement* statement)
librdfnode* librdfstatementgetsubject(librdfstatement* statement)
void librdfstatementsetsubject(librdfstatement* statement,
librdfnode* subject)
librdfnode* librdfstatementgetpredicate(librdfstatement*
statement)
void librdfstatementsetpredicate(librdfstatement* statement,
librdfnode* predicate)
librdfnode* librdfstatementgetobject(librdfstatement* statement)
void librdfstatementsetobject(librdfstatement* statement,
librdfnode* object)
int librdfstatementiscomplete(librdfstatement* statement)
char* librdfstatementtostring(librdfstatement* statement)
void librdfstatementprint(librdfstatement* statement, FILE* fh)
int librdfstatementequals(librdfstatement* statement1,
librdfstatement* statement2)
int librdfstatementmatch(librdfstatement* statement,
librdfstatement* partialstatement)
sizet librdfstatementencode(librdfstatement* statement, unsigned
char* buffer, sizet length)
sizet librdfstatementencodeparts(librdfstatement* statement,
unsigned char* buffer, sizet length, librdfstatementpart fields)
sizet librdfstatementdecode(librdfstatement* statement, unsigned
char* buffer, sizet length)
sizet librdfstatementdecodeparts(librdfstatement* statement,
librdfnode** contextnode, unsigned char* buffer, sizet length)
class model
librdfmodel* librdfnewmodel(librdfworld* world, librdfstorage*
storage, char* optionsstring)
librdfmodel* librdfnewmodelwithoptions(librdfworld* world,
librdfstorage* storage, librdfhash* options)
librdfmodel* librdfnewmodelfrommodel(librdfmodel* model)
void librdffreemodel(librdfmodel* model)
int librdfmodelsize(librdfmodel* model)
int librdfmodeladd(librdfmodel* model, librdfnode* subject,
librdfnode* predicate, librdfnode* object)
int librdfmodeladdstringliteralstatement(librdfmodel* model,
librdfnode* subject, librdfnode* predicate, char* string, char*
xmllanguage, int xmlspace, int iswfxml)
int librdfmodeladdtypedliteralstatement(librdfmodel* model,
librdfnode* subject, librdfnode* predicate, const unsigned char*
string, char* xmllanguage, librdfuri* datatypeuri)
int librdfmodeladdstatement(librdfmodel* model, librdfstatement*
statement)
int librdfmodeladdstatements(librdfmodel* model, librdfstream*
statementstream)
int librdfmodelremovestatement(librdfmodel* model,
librdfstatement* statement)
int librdfmodelcontainsstatement(librdfmodel* model,
librdfstatement* statement)
int librdfmodelhasarcin(librdfmodel* model, librdfnode* node,
librdfnode* property)
int librdfmodelhasarcout(librdfmodel* model, librdfnode* node,
librdfnode* property)
librdfstream* librdfmodelasstream(librdfmodel* model)
librdfstream* librdfmodelfindstatements(librdfmodel* model,
librdfstatement* statement)
librdfstream* librdfmodelfindstatementsincontext(librdfmodel*
model, librdfstatement* statement, librdfnode* contextnode)
librdfstream* librdfmodelfindstatementswithoptions(librdfmodel*
model, librdfstatement* statement, librdfnode* contextnode,
librdfhash* options)
librdfiterator* librdfmodelgetcontexts(librdfmodel* model)
librdfiterator* librdfmodelgetsources(librdfmodel* model,
librdfnode* arc, librdfnode* target)
librdfiterator* librdfmodelgetarcs(librdfmodel* model,
librdfnode* source, librdfnode* target)
librdfiterator* librdfmodelgettargets(librdfmodel* model,
librdfnode* source, librdfnode* arc)
librdfnode* librdfmodelgetsource(librdfmodel* model, librdfnode*
arc, librdfnode* target)
librdfnode* librdfmodelgetarc(librdfmodel* model, librdfnode*
source, librdfnode* target)
librdfnode* librdfmodelgettarget(librdfmodel* model, librdfnode*
source, librdfnode* arc)
librdfiterator* librdfmodelgetarcsin(librdfmodel* model,
librdfnode* node)
librdfiterator* librdfmodelgetarcsout(librdfmodel* model,
librdfnode* node)
int librdfmodeladdsubmodel(librdfmodel* model, librdfmodel*
submodel)
int librdfmodelremovesubmodel(librdfmodel* model, librdfmodel*
submodel)
void librdfmodelprint(librdfmodel* model, FILE* fh)
int librdfmodelcontextaddstatement(librdfmodel* model,
librdfnode* context, librdfstatement* statement)
int librdfmodelcontextaddstatements(librdfmodel* model,
librdfnode* context, librdfstream* stream)
int librdfmodelcontextremovestatement(librdfmodel* model,
librdfnode* context, librdfstatement* statement)
int librdfmodelcontextremovestatements(librdfmodel* model,
librdfnode* context)
librdfstream* librdfmodelcontextasstream(librdfmodel* model,
librdfnode* context)
librdfstream* librdfmodelquery(librdfmodel* model, librdfquery*
query)
librdfstream* librdfmodelquerystring(librdfmodel* model, const
char* name, librdfuri* uri, const unsigned char* querystring)
void librdfmodelsync(librdfmodel* model)
librdfstorage* librdfmodelgetstorage(librdfmodel* model)
librdfnode* librdfmodelgetfeature(librdfmodel* model, librdfuri*
feature) =item int librdfmodelsetfeature(librdfmodel* model,
librdfuri* feature, librdfnode* value)
class storage
void librdfstorageregisterfactory(const char* name, void (*factory)
(librdfstoragefactory*))
librdfstorage* librdfnewstorage(librdfworld* world, char*
storagename, char* name, char* optionsstring)
librdfstorage* librdfnewstoragewithoptions(librdfworld* world,
char* storagename, char* name, librdfhash* options)
librdfstorage* librdfnewstoragefromstorage(librdfstorage*
oldstorage)
librdfstorage* librdfnewstoragefromfactory(librdfworld* world,
librdfstoragefactory* factory, char* name, librdfhash* options)
void librdffreestorage(librdfstorage* storage)
int librdfstorageopen(librdfstorage* storage, librdfmodel* model)
int librdfstorageclose(librdfstorage* storage)
int librdfstorageget(librdfstorage* storage, void* key, sizet
keylen, void **value, sizet* valuelen, unsigned int flags)
int librdfstoragesize(librdfstorage* storage)
int librdfstorageaddstatement(librdfstorage* storage,
librdfstatement* statement)
int librdfstorageaddstatements(librdfstorage* storage,
librdfstream* statementstream)
int librdfstorageremovestatement(librdfstorage* storage,
librdfstatement* statement)
int librdfstoragecontainsstatement(librdfstorage* storage,
librdfstatement* statement)
librdfstream* librdfstorageserialise(librdfstorage* storage)
librdfstream* librdfstoragefindstatements(librdfstorage* storage,
librdfstatement* statement)
librdfiterator* librdfstoragegetsources(librdfstorage* storage,
librdfnode* arc, librdfnode* target)
librdfiterator* librdfstoragegetarcs(librdfstorage* storage,
librdfnode* source, librdfnode* target)
librdfiterator* librdfstoragegettargets(librdfstorage* storage,
librdfnode* source, librdfnode* arc)
librdfiterator* librdfstoragegetarcsin(librdfstorage* storage,
librdfnode* node)
librdfiterator* librdfstoragegetarcsout(librdfstorage* storage,
librdfnode* node)
int librdfstoragehasarcin(librdfstorage* storage, librdfnode*
node, librdfnode* property)
int librdfstoragehasarcout(librdfstorage* storage, librdfnode*
node, librdfnode* property)
int librdfstoragecontextaddstatement(librdfstorage* storage,
librdfnode* context, librdfstatement* statement)
int librdfstoragecontextaddstatements(librdfstorage* storage,
librdfnode* context, librdfstream* stream)
int librdfstoragecontextremovestatement(librdfstorage* storage,
librdfnode* context, librdfstatement* statement)
int librdfstoragecontextremovestatements(librdfstorage* storage,
librdfnode* context)
librdfstream* librdfstoragecontextasstream(librdfstorage*
storage, librdfnode* context)
int librdfstoragesupportsquery(librdfstorage* storage,
librdfquery* query)
librdfstream* librdfstoragequery(librdfstorage* storage,
librdfquery* query)
void librdfstoragesync(librdfstorage* storage)
class parser
void librdfparserregisterfactory(librdfworld* world, const char*
name, const char* mimetype, const char* uristring, void (*factory)
(librdfparserfactory*))
librdfparser* librdfnewparser(librdfworld* world, const char* name,
const char* mimetype, librdfuri* typeuri)
librdfparser* librdfnewparserfromfactory(librdfworld* world,
librdfparserfactory* factory)
void librdffreeparser(librdfparser* parser)
librdfstream* librdfparserparseasstream(librdfparser* parser,
librdfuri* uri, librdfuri* baseuri)
int librdfparserparseintomodel(librdfparser* parser, librdfuri*
uri, librdfuri* baseuri, librdfmodel* model)
librdfstream* librdfparserparsestringasstream(librdfparser*
parser, const unsigned char* string, librdfuri* baseuri)
int librdfparserparsestringintomodel(librdfparser* parser, const
unsigned char* string, librdfuri* baseuri, librdfmodel* model)
void librdfparserseterror(librdfparser* parser, void* userdata,
void (*errorfn)(void* userdata, const char* msg, ...))
void librdfparsersetwarning(librdfparser* parser, void* userdata,
void (*warningfn)(void* userdata, const char* msg, ...))
librdfnode* librdfparsergetfeature(librdfparser* parser,
librdfuri* feature)
int librdfparsersetfeature(librdfparser* parser, librdfuri*
feature, librdfnode* value)
class serializer
librdfserializer* librdfnewserializer(librdfworld* world, const
char *name, const char *mimetype, librdfuri *typeuri)
librdfserializer* librdfnewserializerfromfactory(librdfworld*
world, librdfserializerfactory *factory)
void librdffreeserializer(librdfserializer *serializer)
int librdfserializerserializemodel(librdfserializer* serializer,
FILE* handle, librdfuri* baseuri, librdfmodel* model)
int librdfserializerserializemodeltofile(librdfserializer*
serializer, const char *name, librdfuri* baseuri, librdfmodel*
model)
void librdfserializerseterror(librdfserializer* serializer, void
*userdata, void (*errorfn)(void *userdata, const char *msg, ...))
void librdfserializersetwarning(librdfserializer* serializer, void
*userdata, void (*warningfn)(void *userdata, const char *msg, ...))
librdfnode* librdfserializergetfeature(librdfserializer*
serializer, librdfuri* feature)
int librdfserializersetfeature(librdfserializer* serializer,
librdfuri* feature, librdfnode* value)b
int librdfserializersetnamespace(librdfserializer* serializer,
librdfuri* uri, const char* prefix)
class stream
librdfstream* librdfnewstream(librdfworld* world, void* context,
int (*endofstream)(void*), librdfstatement*
(*nextstatement)(void*), void (*finished)(void*))
librdfstream* librdfnewstreamfromnodeiterator(librdfiterator*
iterator, librdfstatement* statement, librdfstatementpart field)
void librdffreestream(librdfstream* stream)
int librdfstreamend(librdfstream* stream)
int librdfstreamnext(librdfstream* stream)
librdfstatement* librdfstreamgetobject(librdfstream* stream)
void* librdfstreamgetcontext(librdfstream* stream)
void librdfstreamsetmap(librdfstream* stream, librdfstatement*
(*map)(void* context, librdfstatement* statement), void* mapcontext)
void librdfstreamprint(librdfstream* stream, FILE* fh)
EXAMPLES
#include
librdfstorage *storage;
librdfmodel* model;
librdfstatement* statement;
librdfworld* world
world=librdfnewworld();
librdfworldopen(world);
storage=librdfnewstorage(world, "hashes", "test", "hash-type='bdb',dir='.'");
model=librdfnewmodel(world, storage, NULL);
statement=librdfnewstatementfromnodes(world, librdfnewnodefromuristring(world, "http://purl.org/net/dajobe/"), librdfnewnodefromuristring(world, "http://purl.org/dc/elements/1.1/creator"), librdfnewnodefromliteral(world, "Dave Beckett", NULL, 0));
librdfmodeladdstatement(model, statement);
librdffreestatement(statement);
librdfmodelprint(model, stdout);
librdffreemodel(model);
librdffreestorage(storage);
librdffreeworld(world);
SEE ALSO
libraptor(3), libxml(4).
HISTORY
The redland RDF library was created by Dave Beckett in June 2000.
AUTHOR
Dave Beckett ,
28-Jun-2012 redland 1.0.16 redland(3)