#include <item.h>
Inherits ElementWrapper, and SpecificItem.
List of all members.
Detailed Description
An Item, representing an entry in an RSS feed.
- Author:
- Frank Osterfeld
Definition at line 52 of file item.h.
Constructor & Destructor Documentation
Default constructor, creates a null object, for which isNull() is true
.
Definition at line 47 of file item.cpp.
Creates an Item object wrapping an <item>
XML element.
- Parameters:
-
element | The <item> element to wrap |
doc | the document this item is part of |
Definition at line 52 of file item.cpp.
creates a copy of an item.
As the d pointer is shared, this is a cheap operation.
- Parameters:
-
Definition at line 61 of file item.cpp.
destructor
Definition at line 57 of file item.cpp.
Member Function Documentation
Used by visitors for double dispatch.
See SpecificItemVisitor for more information.
- Parameters:
-
visitor | the visitor calling the method |
Definition at line 293 of file item.cpp.
The email address of the author of this item.
For newspapers and magazines syndicating via RSS, the author is the person who wrote the article that this item describes. For collaborative weblogs, the author of the item might be different from the managing editor or webmaster. This method returns the content of the <author>
element. If <author>
is not available, the method returns <dc:creator>
instead, if available.
- Returns:
- an email address of the author, or a null string if not specified
Definition at line 140 of file item.cpp.
Set of categories this item is included in.
- Returns:
- a list of categories, possibly empty.
Definition at line 120 of file item.cpp.
URL of a page for comments relating to the item.
- Returns:
- an URL to the comments, or a null string if not set
Definition at line 135 of file item.cpp.
Returns the actual content of the item.
In RSS2, this can be stored in various elements, e.g. in content:encoded, xhtml:body or xhtml:div. If this is not set, description() might also contain the content of the item.
- Returns:
- the content in HTML format (whitespace is irrelevant, <br/> is used for newlines, "&", "<", ">" are escaped) If no content is specified, a null string is returned.
Definition at line 114 of file item.cpp.
Returns a description of the object and its children for debugging purposes.
- Returns:
- debug string
Definition at line 224 of file item.cpp.
The item synopsis.
This might contain a short summary of the item, but also the full content. If content() is set, that usually contains the full content instead.
- Returns:
- a string in HTML format (whitespace is irrelevant,
<br/>
is used for newlines, "&", "<", ">" are escaped) summarizing the item. A null string if no description was specified.
Definition at line 102 of file item.cpp.
Descriptions of media objects that are attached to the item.
Note that the RSS2 spec is a bit unclear about whether an item can have multiple enclosures or not. Originally it was not intended, but in reality, some tools out there specify multiple enclosures. So most of the time, this list be either empty or contains a single item, but don't take that for granted
Definition at line 156 of file item.cpp.
expiration date, specifying a date when the item is not longer available.
Only available in RSS 0.93.
- Returns:
- the expiration date, or 0 if no date was specified or parsing failed
Definition at line 208 of file item.cpp.
"guid stands for globally unique identifier.
It's a string that uniquely identifies the item. When present, an aggregator may choose to use this string to determine if an item is new. There are no rules for the syntax of a guid. Aggregators must view them as a string. It's up to the source of the feed to establish the uniqueness of the string."
- Returns:
- a guid string, or a null string if none specified in the feed
Definition at line 171 of file item.cpp.
If true
, it can be assumed that the guid is a permalink to the item, that is, a url that can be opened in a Web browser, that points to the full item.
- Returns:
true
if the guid is a permalink and can be interpreted as URL
Definition at line 176 of file item.cpp.
The URL of the item.
This usually links to the web representation of the item, e.g. the full news article.
- Returns:
- an URL, or a null string if not set
Definition at line 97 of file item.cpp.
Item & Syndication::RSS2::Item::operator= |
( |
const Item & |
other | ) |
|
assigns another item.
As the d pointer is shared, this is a cheap operation.
- Parameters:
-
Definition at line 66 of file item.cpp.
Indicates when the item was published.
If it's a date in the future, you may choose to not display the item until that date. This returns the content of the <pubDate>
element. If <pubDate>
is not available, the method returns <dc:date>
instead, if available.
- Returns:
- the publication date, or 0 if no date was specified or parsing failed
Definition at line 194 of file item.cpp.
A Platform for Internet Content Selection (PICS) rating tag.
More information on the format of the rating tag can be found here: http://www.w3.org/PICS/
- Returns:
- PICS rating information, or a null string if not specified
Definition at line 219 of file item.cpp.
The RSS channel that the item came from.
See Source class for more information.
- Returns:
- a Source object, or a null object (see Source.isNull()) if not set.
Definition at line 214 of file item.cpp.
The title of the item.
- Returns:
- The title in plain text. Note that e.g. characters like <, >, & are not escaped! (TODO: this might change, check what makes more sense)
Definition at line 74 of file item.cpp.
returns all child elements of this item not covered by this class.
You can use this to access additional metadata from RSS extensions.
Definition at line 261 of file item.cpp.
The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2012 The KDE developers.
Generated on Mon Apr 30 2012 21:48:58 by
doxygen 1.8.0 written
by
Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.