RDF::aREF::Decoder(3pm) User Contributed Perl Documentation RDF::aREF::Decoder(3pm)
NAME
RDF::aREF::Decoder - decode another RDF Encoding Form (to RDF triples)
SYNOPSIS
use RDF::aREF::Decoder;
RDF::aREF::Decoder->new( %options )->decode( $aref );
DESCRIPTION
This module implements a decoder from another RDF Encoding Form (aREF), given as in form
of Perl arrays, hashes, and Unicode strings, to RDF triples.
OPTIONS
ns
A default namespace map, given either as hash reference or as version string of module
RDF::NS. Set to the most recent version of RDF::NS by default, but relying on a default
value is not recommended!
callback
A code reference that is called for each triple with a list of three to five elements:
subject
The subject IRI or subject blank node as string. Blank nodes always start with "_:".
predicate
The predicate IRI.
object
The object IRI or object blank node or literal object as string. Blank nodes always
start with "_:" and literal objects can be detected by existence of the (possibly
empty) language or datatype element.
language
The language tag (possible the empty string) for literal objects.
datatype
The object's datatype if object is a literal and datatype is not
"http://www.w3.org/2001/XMLSchema#string".
For convenience an instance of RDF::Trine::Model can also be used as callback.
complain
What to do on errors. Set to 1 be default (warn). Set to 0 to ignore. Other values will
die on errors.
strict
Enables errors on undefined subjects, predicates, and objects. By default the Perl value
"undef" in any part of an encoded RDF triple will silently ignore the triple, so aREF
structures can easily be used as templates with optional values.
null
A null object that is treated equivalent to "undef" if found as object. For instance
setting this to the empty string will ignore all triples with the empty string as literal
value.
bnode_prefix
A prefix for blank node identifiers. Defaults to "b", so blank node identifiers will be
"b1", "b2", "b3" etc.
bnode_count
An integer to start creating blank node identifiers with. The default value "0" results in
blank node identifiers starting from "b1". This option can be useful to avoid collision of
blank node identifiers when merging multiple aREF instances. The current counter value is
accessible as accessor.
METHODS
decode( $aref [, keep_bnode_map => 1 ] )
Encode RDF data given in aREF. Resets all blank node identifier mappings unless option
c<keep_bnode_map> is set.
clean_bnodes
Delete blank node identifier mapping and reset bnode_count.
EXPORTABLE CONSTANTS
On request this module exports the following regular expressions, as defined in the aREF
specification <http://gbv.github.io/aREF/aREF.html>:
qName
blankNode
IRIlike
languageString
languageTag
datatypeString
SEE ALSO
RDF::aREF::Encoder
perl v5.24.1 2016-12-15 RDF::aREF::Decoder(3pm)