.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "XML::RSS::LibXML::MagicElement 3"
.TH XML::RSS::LibXML::MagicElement 3 2023-01-20 "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
XML::RSS::LibXML::MagicElement \- Represent A Non\-Trivial RSS Element
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 5
\&  us XML::RS::LibXML::MagicElement;
\&  my $xml = XML::RSS::LibXML::MagicElement\->new(
\&    content => $textContent,
\&    attributes => \e@attributes
\&  );
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This module is a handy object that allows users to access non-trivial
RSS elements in XML::RSS style. For example, suppose you have an RSS
feed with an element like the following:
.PP
.Vb 5
\&  <channel>
\&    <title>Example</title>
\&    <tag attr1="foo" attr2="bar">baz</tag>
\&    ...
\&  </channel>
.Ve
.PP
While it is simple to access the title element like this:
.PP
.Vb 1
\&  $rss\->{channel}\->{title};
.Ve
.PP
It was slightly non-trivial for the second tag. With this module, <tag>
is parsed as a XML::RSS::LibXML::MagicElement object and then you can access
all the elements like so:
.PP
.Vb 3
\&  $rss\->{channel}\->{tag};  # "baz"
\&  $rss\->{channel}\->{tag}\->{attr1}; # "foo"
\&  $rss\->{channel}\->{tag}\->{attr2}; # "bar"
.Ve
.SH METHODS
.IX Header "METHODS"
.SS new
.IX Subsection "new"
Create a new MagicElement object.
.SS attributes
.IX Subsection "attributes"
Returns the list of attributes associated with this element
.SS toString
.IX Subsection "toString"
Returns the string representation of this object. 
By default we use the "text content" of the found tag, but for XML::RSS 
compatibility, we use the concatenation of the attributes if no content is
found.
.SH AUTHOR
.IX Header "AUTHOR"
Copyright 2005 Daisuke Maki <dmaki@cpan.org>. All rights reserved.
.PP
Development partially funded by Brazil, Ltd. <http://b.razil.jp>