.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.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.  | will give a
.\" real vertical bar.  \*(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-|\(bv\*(Tr
.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" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" 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 "XML::RAI::Item 3pm"
.TH XML::RAI::Item 3pm "2005-01-15" "perl v5.8.4" "User Contributed Perl Documentation"
.SH "NAME"
XML::RAI::Item \- An interface to the item elements of a RSS feed.
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
A subclass of XML::RAI::Object, XML::RAI::Item handles the
mapping function and retrieval of \s-1RSS\s0 item elements.
.SH "METHODS"
.IX Header "METHODS"
.RE
.IP "$item\->src"
.IX Item "$item->src"
Returns the XML::RSS::Parser::Element that the object is using
as its source. 
.RE
.IP "$item\->parent"
.IX Item "$item->parent"
Returns the parent of the \s-1RAI\s0 object.
.Sh "\s-1META\s0 \s-1DATA\s0 \s-1ACCESSORS\s0"
.IX Subsection "META DATA ACCESSORS"
These accessor methods attempt to retrieve meta data from the
source XML::RSS::Parser element by checking a list of potential
tag names until one returns a value.  They are generally based on
Dublin Core terminology and \s-1RSS\s0 elements that are common across the
many formats. If called in a \s-1SCALAR\s0 context, the value of the first
element of the tag being matched is returned. If called in an \s-1ARRAY\s0
context it will return all of the values to the tag being matched
\&\*(-- it does not return all of the values for all of the tags that
have been mapped to the method. (Note that some mappings only allow
one value to be returned.) Returns \f(CW\*(C`undef\*(C'\fR if nothing could be
found.
.PP
The following are the tags (listed in XPath notation) mapped to
each method and the order in which they are checked.
.RE
.IP "$item\->abstract"
.IX Item "$item->abstract"
.PD 0
.IP "* dcterms:abstract" 4
.IX Item "dcterms:abstract"
.IP "* description" 4
.IX Item "description"
.IP "* dc:description" 4
.IX Item "dc:description"
.RE
.IP "$item\->content"
.IX Item "$item->content"
.IP "* xhtml:body" 4
.IX Item "xhtml:body"
.IP "* xhtml:div" 4
.IX Item "xhtml:div"
.IP "* content:encoded" 4
.IX Item "content:encoded"
.IP "* description" 4
.IX Item "description"
.IP "* dc:description" 4
.IX Item "dc:description"
.IP "* rss091:description" 4
.IX Item "rss091:description"
.RE
.IP "$item\->content_strict"
.IX Item "$item->content_strict"
.IP "* xhtml:body" 4
.IX Item "xhtml:body"
.IP "* xhtml:div" 4
.IX Item "xhtml:div"
.IP "* content:encoded" 4
.IX Item "content:encoded"
.ie n .IP "* description/@type=""text/html""" 4
.el .IP "* description/@type=``text/html''" 4
.IX Item "description/@type=text/html"
.RE
.IP "$item\->contributor"
.IX Item "$item->contributor"
.IP "* dc:contributor" 4
.IX Item "dc:contributor"
.RE
.IP "$item\->coverage"
.IX Item "$item->coverage"
.IP "* dc:coverage" 4
.IX Item "dc:coverage"
.RE
.IP "$item\->created"
.IX Item "$item->created"
.IP "* dcterms:created" 4
.IX Item "dcterms:created"
.IP "* dc:date" 4
.IX Item "dc:date"
.IP "* pubDate" 4
.IX Item "pubDate"
.IP "* rss091:pubDate" 4
.IX Item "rss091:pubDate"
.RE
.IP "$item\->created_strict"
.IX Item "$item->created_strict"
.IP "* dcterms:created" 4
.IX Item "dcterms:created"
.RE
.IP "$item\->creator"
.IX Item "$item->creator"
.IP "* dc:creator" 4
.IX Item "dc:creator"
.IP "* author" 4
.IX Item "author"
.RE
.IP "$item\->description"
.IX Item "$item->description"
.IP "* description" 4
.IX Item "description"
.IP "* dc:description" 4
.IX Item "dc:description"
.IP "* dcterms:abstract" 4
.IX Item "dcterms:abstract"
.RE
.IP "$item\->format"
.IX Item "$item->format"
.IP "* dc:format" 4
.IX Item "dc:format"
.RE
.IP "$item\->identifier"
.IX Item "$item->identifier"
.IP "* dc:identifier/@rdf:resource" 4
.IX Item "dc:identifier/@rdf:resource"
.IP "* dc:identifier" 4
.IX Item "dc:identifier"
.IP "* guid" 4
.IX Item "guid"
.IP "* link" 4
.IX Item "link"
.RE
.IP "$item\->issued"
.IX Item "$item->issued"
.IP "* dcterms:issued" 4
.IX Item "dcterms:issued"
.IP "* dc:date" 4
.IX Item "dc:date"
.IP "* pubDate" 4
.IX Item "pubDate"
.IP "* rss091:pubDate" 4
.IX Item "rss091:pubDate"
.IP "* /channel/lastBuildDate" 4
.IX Item "/channel/lastBuildDate"
.IP "* /channel/rss091:lastBuildDate" 4
.IX Item "/channel/rss091:lastBuildDate"
.RE
.IP "$item\->issued_strict"
.IX Item "$item->issued_strict"
.IP "* dcterms:issued" 4
.IX Item "dcterms:issued"
.RE
.IP "$item\->language"
.IX Item "$item->language"
.ie n .IP "* @xml:lang" 4
.el .IP "* \f(CW@xml:lang\fR" 4
.IX Item "@xml:lang"
.IP "* dc:language" 4
.IX Item "dc:language"
.IP "* /@xml:lang" 4
.IX Item "/@xml:lang"
.IP "* /channel/dc:language" 4
.IX Item "/channel/dc:language"
.IP "* /channel/language" 4
.IX Item "/channel/language"
.IP "* /channel/rss091:language" 4
.IX Item "/channel/rss091:language"
.RE
.IP "$item\->link"
.IX Item "$item->link"
.IP "* link" 4
.IX Item "link"
.ie n .IP "* @rdf:about" 4
.el .IP "* \f(CW@rdf:about\fR" 4
.IX Item "@rdf:about"
.ie n .IP "* guid[@isPermaLink=""true""]" 4
.el .IP "* guid[@isPermaLink=``true'']" 4
.IX Item "guid[@isPermaLink=true]"
.RE
.IP "$item\->modified"
.IX Item "$item->modified"
.IP "* dcterms:modified" 4
.IX Item "dcterms:modified"
.IP "* dc:date" 4
.IX Item "dc:date"
.IP "* pubDate" 4
.IX Item "pubDate"
.IP "* rss091:pubDate" 4
.IX Item "rss091:pubDate"
.RE
.IP "$item\->modified_strict"
.IX Item "$item->modified_strict"
.IP "* dcterms:modified" 4
.IX Item "dcterms:modified"
.RE
.IP "$item\->ping"
.IX Item "$item->ping"
.IP "* trackback:ping/@rdf:resource" 4
.IX Item "trackback:ping/@rdf:resource"
.IP "* trackback:ping" 4
.IX Item "trackback:ping"
.RE
.IP "$item\->pinged"
.IX Item "$item->pinged"
.IP "* trackback:about/@rdf:resource" 4
.IX Item "trackback:about/@rdf:resource"
.IP "* trackback:about" 4
.IX Item "trackback:about"
.RE
.IP "$item\->publisher"
.IX Item "$item->publisher"
.IP "* dc:publisher" 4
.IX Item "dc:publisher"
.IP "* /channel/dc:publisher" 4
.IX Item "/channel/dc:publisher"
.IP "* /channel/managingEditor" 4
.IX Item "/channel/managingEditor"
.RE
.IP "$item\->relation"
.IX Item "$item->relation"
.IP "* dc:relation/@rdf:resource" 4
.IX Item "dc:relation/@rdf:resource"
.IP "* dc:relation" 4
.IX Item "dc:relation"
.RE
.IP "$item\->rights"
.IX Item "$item->rights"
.IP "* dc:rights" 4
.IX Item "dc:rights"
.IP "* /channel/copyright" 4
.IX Item "/channel/copyright"
.IP "* /channel/creativeCommons:license" 4
.IX Item "/channel/creativeCommons:license"
.IP "* /channel/rss091:copyright" 4
.IX Item "/channel/rss091:copyright"
.RE
.IP "$item\->source"
.IX Item "$item->source"
.IP "* dc:source" 4
.IX Item "dc:source"
.IP "* source" 4
.IX Item "source"
.RE
.IP "$item\->subject"
.IX Item "$item->subject"
.IP "* dc:subject" 4
.IX Item "dc:subject"
.IP "* category" 4
.IX Item "category"
.RE
.IP "$item\->title"
.IX Item "$item->title"
.IP "* title" 4
.IX Item "title"
.IP "* dc:title" 4
.IX Item "dc:title"
.RE
.IP "$item\->type"
.IX Item "$item->type"
.IP "* dc:type" 4
.IX Item "dc:type"
.RE
.IP "$item\->valid"
.IX Item "$item->valid"
.IP "* dcterms:valid" 4
.IX Item "dcterms:valid"
.IP "* expirationDate" 4
.IX Item "expirationDate"
.PD
.SH "AUTHOR & COPYRIGHT"
.IX Header "AUTHOR & COPYRIGHT"
Please see the \s-1XML::RAI\s0 manpage for author, copyright, and license
information.