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.36.0                                       2022-12-07                            RDF::aREF::Decoder(3pm)