GSP
Quick Navigator

Search Site

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

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XML::FEED::ENTRY (3)

.ds Aq ’

NAME

XML::Feed::Entry - Entry/item in a syndication feed

CONTENTS

SYNOPSIS



    ## $feed is an XML::Feed object.
    for my $entry ($feed->entries) {
        print $entry->title, "\n", $entry->summary, "\n\n";
    }



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.

CW$entry->convert($format)

Converts the XML::Feed::Entry object into the $format format, and returns the new object.

CW$entry->title([ CW$title ])

The title of the entry.

CW$entry->base([ CW$base ])

The url base of the entry.

CW$entry->link([ CW$uri ])

The permalink of the entry, in most cases, except in cases where it points instead to an offsite URI referenced in the entry.

CW$entry->content([ CW$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.

CW$entry->summary([ CW$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 <B>andB> 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.

CW$entry->category([ CW$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.

<B>WARNINGB> It’s possible this API might change to have an add_category instead.

CW$entry->tags([ CW$tag ])

A synonym (alias) for category;

CW$entry->author([ CW$author ])

The name or email address of the person who posted the entry.

CW$entry->id([ CW$id ])

The unique ID of the entry.

CW$entry->issued([ CW$issued ])

A DateTime object representing the date and time at which the entry was posted.

If present, $issued should be a DateTime object.

CW$entry->modified([ CW$modified ])

A DateTime object representing the last-modified date of the entry.

If present, $modified should be a DateTime object.

CW$entry->wrap

Take an entry in its native format and turn it into an XML::Feed::Entry object.

CW$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.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 XML::FEED::ENTRY (3) 2015-12-14

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