--- name: "RDF::Redland::Model" section: "3pm" platform: "linux" package: "librdf-perl" version: "1.0.17.1+dfsg-6+b6" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/RDF::Redland::Model" --- # RDF::Redland::Model(3pm) Redland RDF Model Class ## NAME RDF::Redland::Model - Redland RDF Model Class ## SYNOPSIS ``` use RDF::Redland; my $storage=new RDF::Redland::Storage("hashes", "test", "new='yes',hash-type='memory'"); my $model=new RDF::Redland::Model($storage, ""); ... my(@sources)=$model->targets($predicate_node, $object_node); ... ``` ## DESCRIPTION Manipulate the RDF model. ## CONSTRUCTORS - new STORAGE OPTIONS\_STRING - new\_with\_options STORAGE OPTIONS\_HASH Create a new RDF::Redland::Model object using RDF::Redland::Storage object *STORAGE* with a options. The options can be given either as a string in the first form as *OPTIONS\_STRING*. The options take the form key1='value1',key2='value2'. The quotes are required. In the second case *OPTIONS\_HASH* is a reference to a Perl hash of options. - new\_from\_model MODEL Create a new model from an existing RDF::Redland::Model *MODEL* (copy constructor). ## METHODS - size Return the size of the model (number of statements). - sync Synchronise the model to the underlying storage. - add SUBJECT PREDICATE OBJECT Add a new statement to the model with *SUBJECT*, *PREDICATE* and *OBJECT*. These can be RDF::Redland::Node, RDF::Redland::URI or perl URI objects. - add\_typed\_literal\_statement SUBJECT PREDICATE STRING \[XML\_LANGUAGE \[DATATYPE\]\] Add a new statement to the model containing a typed literal string object *STRING* with (optional) XML language (xml:lang attribute) *XML\_LANGUAGE* and (optional) datatype URI *DATATYPE*. *XML\_LANGUAGE* or *DATATYPE* can either or both be set to undef. - add\_statement STATEMENT \[CONTEXT\] \| NODE NODE NODE \[CONTEXT\] Add RDF::Redland::Statement *STATEMENT* or the statement formed by *NODE NODE NODE* to the model. If the optional *CONTEXT* is given, associate it with that context. Any of *NODE* or *CONTEXT* can be a RDF::Redland::Node, RDF::Redland::URI or perl URI object. - add\_statements STREAM \[CONTEXT\] Add the statements from the RDF::Redland::Stream *STREAM* to the model. If the optional *CONTEXT* is given, associate it with that context. *CONTEXT* can be a RDF::Redland::Node, RDF::Redland::URI or perl URI object. - remove\_statement STATEMENT \[CONTEXT\] \| NODE NODE NODE \[CONTEXT\] Remove RDF::Redland::Statement *STATEMENT* or the statement formed by *NODE NODE NODE* from the model. If the optional *CONTEXT* is given, remove only the statement stored with that context. Any of *NODE* or *CONTEXT* can be a RDF::Redland::Node, RDF::Redland::URI or perl URI object. - remove\_context\_statements CONTEXT Remove all RDF::Redland::Statement *STATEMENT*s from the model with the given *CONTEXT* context. *CONTEXT* can be a RDF::Redland::Node, RDF::Redland::URI or perl URI object. - contains\_statement STATEMENT Return non 0 if the model contains RDF::Redland::Statement *STATEMENT*. - as\_stream \[CONTEXT\] Return a new RDF::Redland::Stream object seralising the entire model, or just those statements with *CONTEXT*, as RDF::Redland::Statement objects. If given, *CONTEXT* can be a RDF::Redland::Node, RDF::Redland::URI or perl URI object. - find\_statements STATEMENT \[CONTEXT\] Find all matching statements in the model matching partial RDF::Redland::Statement *STATEMENT* (any of the subject, predicate, object RDF::Redland::Node can be undef). If *CONTEXT* is given, finds statements only in that context. In an array context, returns an array of the matching RDF::Redland::Statement objects. In a scalar context, returns the RDF::Redland::Stream object representing the results. - sources ARC TARGET Get all source RDF::Redland::Node objects for a given arc *ARC*, target *TARGET*\> RDF::Redland::Node objects as a list of RDF::Redland::Node objects. - arcs SOURCE TARGET Get all arc RDF::Redland::Node objects for a given source *SOURCE*, target *TARGET* RDF::Redland::Node objects as a list of RDF::Redland::Node objects. - targets SOURCE ARC Get all target RDF::Redland::Node objects for a given source *SOURCE*, arc *ARC* RDF::Redland::Node objects as a list of RDF::Redland::Node objects. - sources\_iterator ARC TARGET Get all source RDF::Redland::Node objects for a given arc *ARC*, target *TARGET* RDF::Redland::Node objects as an RDF::Redland::Iterator or undef on failure. - arcs\_iterator SOURCE TARGET Get all arc RDF::Redland::Node objects for a given source *SOURCE*, target *TARGET* RDF::Redland::Node objects as an RDF::Redland::Iterator or undef on failure. - targets\_iterator SOURCE ARC Get all target RDF::Redland::Node objects for a given source *SOURCE*, arc *ARC* RDF::Redland::Node objects as an RDF::Redland::Iterator or undef on failure. - source ARC TARGET Get one source RDF::Redland::Node object that matches a given arc *ARC*, target *TARGET* RDF::Redland::Node objects or undef if there is no match. - arc SOURCE TARGET Get one arc RDF::Redland::Node object that matches a given source *SOURCE*, target *TARGET* RDF::Redland::Node objects or undef if there is no match. - target SOURCE ARC Get one target RDF::Redland::Node object that matches a given source *SOURCE*, arc *ARC* RDF::Redland::Node objects or undef if there is no match. - contexts Get all context RDF::Redland::Node objects in the model - feature URI \[VALUE\] Get/set a model feature. The feature is named via RDF::Redland::URI *URI* and the value is a RDF::Redland::Node. If *VALUE* is given, the feature is set to that value, otherwise the current value is returned. - query\_execute QUERY Execute the *QUERY* RDF::Redland::Query against the model returning a result set RDF::Redland::QueryResults or undef on failure. - load URI \[SYNTAX-NAME \[ MIME-TYPE \[SYNTAX-URI \[HANDLER \]\]\] Load content from *URI* into the model, guessing the parser. - to\_string \[BASE-URI \[SYNTAX-NAME \[ MIME-TYPE \[SYNTAX-URI\]\]\] Serialize the model to a syntax. If no serializer name is given, the default serializer RDF/XML is used. ## OLDER METHODS - serialise - serialize Return a new RDF::Redland::Stream object seralising the model as RDF::Redland::Statement objects. Replaced by as\_stream to reduce confusion with the RDF::Redland::Serializer class. ## SEE ALSO RDF::Redland::Storage, RDF::Redland::Node and RDF::Redland::Statement ## AUTHOR Dave Beckett - http://www.dajobe.org/