Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  XML::RAI::ITEM (3)

.ds Aq ’


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



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


$item->src Returns the XML::RSS::Parser::Element that the object is using as its source.
$item->parent Returns the parent of the RAI object.
$item->add_mapping(key, @xpaths) Creates or appends XPath mappings to the item object for extensibility and easier access of RAI.


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.
o dcterms:abstract
o description
o dc:description
o xhtml:body
o xhtml:div
o content:encoded
o description
o dc:description
o rss091:description
o xhtml:body
o xhtml:div
o content:encoded
o xhtml:body
o xhtml:div
o content:encoded
o dc:contributor
o dc:coverage
o dcterms:created
o dc:date
o pubDate
o rss091:pubDate
o dcterms:created
o dc:creator
o author
o description
o dc:description
o dcterms:abstract
o dc:format
o dc:identifier/@rdf:resource
o dc:identifier
o guid
o link
o dcterms:issued
o dc:date
o pubDate
o rss091:pubDate
o dcterms:issued
o @xml:lang
o dc:language
o /@xml:lang
o /channel/dc:language
o /channel/language
o /channel/rss091:language
o link
o @rdf:about
o guid[@isPermaLink=true]
o dcterms:modified
o dc:date
o pubDate
o rss091:pubDate
o dcterms:modified
o trackback:ping/@rdf:resource
o trackback:ping
o trackback:about/@rdf:resource
o trackback:about
o dc:publisher
o /channel/dc:publisher
o /channel/managingEditor
o /channel/rss091:managingEditor
o dc:relation/@rdf:resource
o dc:relation
o dc:rights
o /channel/copyright
o /channel/creativeCommons:license
o /channel/rss091:copyright
o dc:source
o source
o dc:subject
o category
o title
o dc:title
o dc:type
o dcterms:valid
o expirationDate

The ping and pinged methods have been moved into their own RAI plugin. See XML::RAI::TrackBack for more.


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


Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 99: =begin without a target?
Around line 112: ’=item’ outside of any ’=over’
Around line 128: You forgot a ’=back’ before ’=head2’
Around line 466: You forgot a ’=back’ before ’=head1’
Around line 473: ’=end’ without a target?
Search for    or go to Top of page |  Section 3 |  Main Index

perl v5.20.3 XML::RAI::ITEM (3) 2009-08-14

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.