.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "RDF::aREF::Decoder 3pm"
.TH RDF::aREF::Decoder 3pm "2016-12-15" "perl v5.24.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
RDF::aREF::Decoder \- decode another RDF Encoding Form (to RDF triples)
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&    use RDF::aREF::Decoder;
\&
\&    RDF::aREF::Decoder\->new( %options )\->decode( $aref );
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This module implements a decoder from another \s-1RDF\s0 Encoding Form (aREF), given
as in form of Perl arrays, hashes, and Unicode strings, to \s-1RDF\s0 triples.
.SH "OPTIONS"
.IX Header "OPTIONS"
.SS "ns"
.IX Subsection "ns"
A default namespace map, given either as hash reference or as version string of
module \s-1RDF::NS\s0. Set to the most recent version of \s-1RDF::NS\s0 by default, but relying
on a default value is not recommended!
.SS "callback"
.IX Subsection "callback"
A code reference that is called for each triple with a list of three to five
elements:
.IP "subject" 4
.IX Item "subject"
The subject \s-1IRI\s0 or subject blank node as string. Blank nodes always start with
\&\f(CW\*(C`_:\*(C'\fR.
.IP "predicate" 4
.IX Item "predicate"
The predicate \s-1IRI.\s0
.IP "object" 4
.IX Item "object"
The object \s-1IRI\s0 or object blank node or literal object as string. Blank nodes
always start with \f(CW\*(C`_:\*(C'\fR and literal objects can be detected by existence of the
(possibly empty) language or datatype element.
.IP "language" 4
.IX Item "language"
The language tag (possible the empty string) for literal objects.
.IP "datatype" 4
.IX Item "datatype"
The object's datatype if object is a literal and datatype is not
\&\f(CW\*(C`http://www.w3.org/2001/XMLSchema#string\*(C'\fR.
.PP
For convenience an instance of RDF::Trine::Model can also be used as
callback.
.SS "complain"
.IX Subsection "complain"
What to do on errors. Set to 1 be default (warn). Set to 0 to ignore. Other
values will die on errors.
.SS "strict"
.IX Subsection "strict"
Enables errors on undefined subjects, predicates, and objects. By default
the Perl value \f(CW\*(C`undef\*(C'\fR in any part of an encoded \s-1RDF\s0 triple will silently
ignore the triple, so aREF structures can easily be used as templates with
optional values.
.SS "null"
.IX Subsection "null"
A null object that is treated equivalent to \f(CW\*(C`undef\*(C'\fR if found as object.  For
instance setting this to the empty string will ignore all triples with the
empty string as literal value.
.SS "bnode_prefix"
.IX Subsection "bnode_prefix"
A prefix for blank node identifiers. Defaults to \*(L"b\*(R", so blank node identifiers
will be \*(L"b1\*(R", \*(L"b2\*(R", \*(L"b3\*(R" etc.
.SS "bnode_count"
.IX Subsection "bnode_count"
An integer to start creating blank node identifiers with. The default value \*(L"0\*(R"
results in blank node identifiers starting from \*(L"b1\*(R". 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.
.SH "METHODS"
.IX Header "METHODS"
.ie n .SS "decode( $aref [, keep_bnode_map => 1 ] )"
.el .SS "decode( \f(CW$aref\fP [, keep_bnode_map => 1 ] )"
.IX Subsection "decode( $aref [, keep_bnode_map => 1 ] )"
Encode \s-1RDF\s0 data given in aREF. Resets all blank node identifier mappings unless
option c<keep_bnode_map> is set.
.SS "clean_bnodes"
.IX Subsection "clean_bnodes"
Delete blank node identifier mapping and reset bnode_count.
.SH "EXPORTABLE CONSTANTS"
.IX Header "EXPORTABLE CONSTANTS"
On request this module exports the following regular expressions, as defined in the 
aREF specification <http://gbv.github.io/aREF/aREF.html>:
.IP "qName" 4
.IX Item "qName"
.PD 0
.IP "blankNode" 4
.IX Item "blankNode"
.IP "IRIlike" 4
.IX Item "IRIlike"
.IP "languageString" 4
.IX Item "languageString"
.IP "languageTag" 4
.IX Item "languageTag"
.IP "datatypeString" 4
.IX Item "datatypeString"
.PD
.SH "SEE ALSO"
.IX Header "SEE ALSO"
RDF::aREF::Encoder