/ 
XML-RAI-0.2
River stage one • 2 direct dependents • 2 total dependents
/ XML::RAI::Item

NAME

XML::RAI::Item - An interface to the item elements of a RSS feed.

DESCRIPTION

A subclass of XML::RAI::Object, XML::RAI::Item handles the mapping function and retrieval of RSS item elements.

METHODS

$item->source

Returns the XML::RSS::Parser::Element that the object is using as its source.

$item->parent

Returns the parent of the RAI object.

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 RSS elements that are common across the many formats. If called in a SCALAR context, the value of the first element of the tag being matched is returned. If called in an ARRAY 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 undef if nothing could be found.

The following are the tags (listed in XPath notation) mapped to each method and the order in which they are checked.

$item->abstract
description
dc:description
dcterms:abstract
$item->content
xhtml:body
content:encoded
description
dc:description
rss091:description
$item->contentstrict
xhtml:body
content:encoded
$item->contributor
dc:contributor
$item->coverage
dc:coverage
$item->created
dcterms:created
dc:date
pubDate
rss091:pubDate
/channel/lastBuildDate
/channel/rss091:lastBuildDate
$item->creator
dc:creator
$item->description
description
dc:description
dcterms:abstract
$item->format
dc:format
$item->identifier
dc:identifier
guid
$item->issued
dc:date
pubDate
rss091:pubDate
/channel/lastBuildDate
/channel/rss091:lastBuildDate
$item->language
dc:language
@xml:lang
/channel/dc:language
/channel/language
/channel/rss091:language
link
@rdf:about
guid[@isPermalink="true"]
$item->modified
dcterms:modified
dc:date
pubDate
rss091:pubDate
/channel/lastBuildDate
/channel/rss091:lastBuildDate
$item->ping
trackback:ping/@rdf:resource
$item->publisher
dc:publisher
/channel/dc:publisher
/channel/managingEditor
$item->relation
dc:relation
trackback:about/@rdf:resource
$item->rights
dc:rights
/channel/copyright
/channel/creativeCommons:license
/channel/rss091:copyright
$item->source
dc:source
source
/channel/title
$item->subject
dc:subject
category
$item->title
title
dc:title
$item->type
dc:type
$item->valid
dcterms:valid
expirationDate

AUTHOR & COPYRIGHT

Please see the XML::RAI manpage for author, copyright, and license information.

6 POD Errors

The following errors were encountered while parsing the POD:

Around line 47:

=begin without a target?

Around line 60:

'=item' outside of any '=over'

Around line 69:

You forgot a '=back' before '=head2'

Around line 86:

'=item' outside of any '=over'

Around line 354:

You forgot a '=back' before '=head1'

Around line 361:

'=end' without a target?