man XML::Atom::Entry () - Atom entry


XML::Atom::Entry - Atom entry


    use XML::Atom::Entry;
    my $entry = XML::Atom::Entry->new;
    $entry->title('My Post');
    $entry->content('The content of my post.');
    my $xml = $entry->as_xml;
    my $dc = XML::Atom::Namespace->new(dc => '');
    $entry->set($dc, 'subject', 'Food & Drink');


Creates a new entry object, and if $stream is supplied, fills it with the data specified by $stream.

Automatically handles autodiscovery if $stream is a URI (see below).

Returns the new XML::Atom::Entry object. On failure, returns CWundef.

$stream can be any one of the following:

* Reference to a scalar
This is treated as the XML body of the entry.
* Scalar
This is treated as the name of a file containing the entry XML.
* Filehandle
This is treated as an open filehandle from which the entry XML can be read. Returns the content of the entry. If $content is given, sets the content of the entry. Automatically handles all necessary escaping. Returns an XML::Atom::Person object representing the author of the entry, or CWundef if there is no author information present.

If $author is supplied, it should be an XML::Atom::Person object representing the author. For example:

    my $author = XML::Atom::Person->new;
    $author->name('Foo Bar');


If called in scalar context, returns an XML::Atom::Link object corresponding to the first <link> tag found in the entry.

If called in list context, returns a list of XML::Atom::Link objects corresponding to all of the <link> tags found in the entry.


Adds the link $link, which must be an XML::Atom::Link object, to the entry as a new <link> tag. For example:

    my $link = XML::Atom::Link->new;


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