|
|
Tim Bray provides a bridge between Sun and developers
|
|
XML::Feed::Entry(3pm) User Contributed Perl Documentation XML::Feed::Entry(3pm) NAME
XML::Feed::Entry - Entry/item in a syndication feed SYNOPSIS
## $feed is an XML::Feed object. for my $entry ($feed->entries) { print $entry->title, " ", $entry->summary, " "; } DESCRIPTION
XML::Feed::Entry represents an entry/item in an XML::Feed syndication feed. USAGE
XML::Feed::Entry->new($format) Creates a new XML::Feed::Entry object in the format $format, which should be either RSS or Atom. $entry->convert($format) Converts the XML::Feed::Entry object into the $format format, and returns the new object. $entry->title([ $title ]) The title of the entry. $entry->base([ $base ]) The url base of the entry. $entry->link([ $uri ]) The permalink of the entry, in most cases, except in cases where it points instead to an offsite URI referenced in the entry. $entry->content([ $content ]) An XML::Feed::Content object representing the full entry body, or as much as is available in the feed. In RSS feeds, this method will look first for <http://purl.org/rss/1.0/modules/content/#encoded> and <http://www.w3.org/1999/xhtml#body> elements, then fall back to a <description> element. $entry->summary([ $summary ]) An XML::Feed::Content object representing a short summary of the entry. Possibly. Since RSS feeds do not have the idea of a summary separate from the entry body, this may not always be what you want. If the entry contains both a <description> element and another element typically used for the full content of the entry--either http://www.w3.org/1999/xhtml/body or <http://purl.org/rss/1.0/modules/content/#encoded>--we treat that as the summary. Otherwise, we assume that there isn't a summary, and return an XML::Feed::Content object with an empty string in the body. $entry->category([ $category ]) The category in which the entry was posted. Returns a list of categories if called in array context or the first category if called in scalar context. WARNING It's possible this API might change to have an add_category instead. $entry->tags([ $tag ]) A synonym (alias) for category; $entry->author([ $author ]) The name or email address of the person who posted the entry. $entry->id([ $id ]) The unique ID of the entry. $entry->issued([ $issued ]) A DateTime object representing the date and time at which the entry was posted. If present, $issued should be a DateTime object. $entry->modified([ $modified ]) A DateTime object representing the last-modified date of the entry. If present, $modified should be a DateTime object. $entry->wrap Take an entry in its native format and turn it into an XML::Feed::Entry object. $entry->unwrap Take an XML::Feed::Entry object and turn it into its native format. AUTHOR &; COPYRIGHT Please see the XML::Feed manpage for author, copyright, and license information. perl v5.14.2 2012-03-21 XML::Feed::Entry(3pm)
