Syndication

Syndication Namespace Reference

Namespaces

namespace  Atom
 
namespace  RDF
 
namespace  RSS2
 

Classes

class  AbstractParser
 
class  AtomMapper
 
class  Category
 
class  CategoryAtomImpl
 
class  CategoryRSS2Impl
 
class  DataRetriever
 
class  DocumentSource
 
class  DocumentVisitor
 
class  ElementWrapper
 
class  Enclosure
 
class  EnclosureAtomImpl
 
class  EnclosureRSS2Impl
 
class  Feed
 
class  FeedAtomImpl
 
class  FeedRDFImpl
 
class  FeedRSS2Impl
 
class  Image
 
class  ImageAtomImpl
 
class  ImageRDFImpl
 
class  ImageRSS2Impl
 
class  Item
 
class  ItemAtomImpl
 
class  ItemRDFImpl
 
class  ItemRSS2Impl
 
class  Loader
 
class  Mapper
 
class  ParserCollection
 
class  Person
 
class  RDFMapper
 
class  RSS2Mapper
 
class  SpecificDocument
 
class  SpecificItem
 
class  SpecificItemVisitor
 

Typedefs

typedef QSharedPointer< CategoryAtomImplCategoryAtomImplPtr
 
typedef QSharedPointer< CategoryCategoryPtr
 
typedef QSharedPointer< CategoryRSS2ImplCategoryRSS2ImplPtr
 
typedef QSharedPointer< EnclosureAtomImplEnclosureAtomImplPtr
 
typedef QSharedPointer< EnclosureRSS2ImplEnclosureRSS2ImplPtr
 
typedef QSharedPointer< FeedAtomImplFeedAtomImplPtr
 
typedef QSharedPointer< FeedRDFImplFeedRDFImplPtr
 
typedef QSharedPointer< FeedRSS2ImplFeedRSS2ImplPtr
 
typedef QSharedPointer< ImageAtomImplImageAtomImplPtr
 
typedef QSharedPointer< ImageImagePtr
 
typedef QSharedPointer< ImageRDFImplImageRDFImplPtr
 
typedef QSharedPointer< ImageRSS2ImplImageRSS2ImplPtr
 
typedef QSharedPointer< ItemAtomImplItemAtomImplPtr
 
typedef QSharedPointer< ItemRDFImplItemRDFImplPtr
 
typedef QSharedPointer< ItemRSS2ImplItemRSS2ImplPtr
 

Enumerations

enum  ErrorCode {
  Success = 0 , Aborted = 1 , Timeout = 2 , UnknownHost = 3 ,
  FileNotFound = 4 , OtherRetrieverError = 5 , InvalidXml = 6 , XmlNotAccepted = 7 ,
  InvalidFormat = 8
}
 

Functions

unsigned int calcHash (const QByteArray &array)
 
unsigned int calcHash (const QString &str)
 
QString calcMD5Sum (const QString &str)
 
QString commentApiNamespace ()
 
QString contentNameSpace ()
 
QString convertNewlines (const QString &strp)
 
QString dateTimeToString (uint date)
 
QString dublinCoreNamespace ()
 
QString escapeSpecialCharacters (const QString &strp)
 
QString htmlToPlainText (const QString &html)
 
bool isHtml (const QString &str)
 
QString itunesNamespace ()
 
QString normalize (const QString &str)
 
QString normalize (const QString &strp, bool isCDATA, bool containsMarkup)
 
FeedPtr parse (const DocumentSource &src, const QString &formatHint=QString())
 
uint parseDate (const QString &str, DateFormat hint)
 
uint parseISODate (const QString &str)
 
ParserCollection< Feed > * parserCollection ()
 
uint parseRFCDate (const QString &str)
 
PersonPtr personFromString (const QString &strp)
 
QString plainTextToHtml (const QString &plainText)
 
QString resolveEntities (const QString &str)
 
QString slashNamespace ()
 
bool stringContainsMarkup (const QString &str)
 
static QRegularExpression tagRegExp ()
 
static uint toTimeT (QDateTime &kdt)
 
QString xhtmlNamespace ()
 
QString xmlNamespace ()
 

Variables

QCryptographicHash md5Machine (QCryptographicHash::Md5)
 
static ParserCollectionImpl< Syndication::Feed > * parserColl = nullptr
 

Detailed Description

TODO.

Typedef Documentation

◆ CategoryAtomImplPtr

◆ CategoryPtr

Definition at line 19 of file category.h.

◆ CategoryRSS2ImplPtr

◆ EnclosureAtomImplPtr

◆ EnclosureRSS2ImplPtr

◆ FeedAtomImplPtr

◆ FeedRDFImplPtr

◆ FeedRSS2ImplPtr

◆ ImageAtomImplPtr

◆ ImagePtr

Definition at line 19 of file feedatomimpl.h.

◆ ImageRDFImplPtr

◆ ImageRSS2ImplPtr

◆ ItemAtomImplPtr

◆ ItemRDFImplPtr

◆ ItemRSS2ImplPtr

Enumeration Type Documentation

◆ ErrorCode

error code indicating fetching or parsing errors

Enumerator
Success 

No error occurred, feed was fetched and parsed successfully.

Aborted 

file downloading/parsing was aborted by the user

Timeout 

file download timed out

UnknownHost 

The hostname couldn't get resolved to an IP address.

FileNotFound 

the host was contacted successfully, but reported a 404 error

OtherRetrieverError 

retriever error not covered by the error codes above.

This is returned if a custom DataRetriever was used. See the retriever-specific status byte for more information on the occurred error.

InvalidXml 

The XML is invalid.

This is returned if no parser accepts the source and the DOM document can't be parsed. It is not returned if the source is not valid XML but a (non-XML) parser accepts it.

XmlNotAccepted 

The source is valid XML, but no parser accepted it.

InvalidFormat 

the source was accepted by a parser, but the actual parsing failed.

As our parser implementations currently do not validate the source ("parse what you can get"), this code will be rarely seen.

Definition at line 70 of file global.h.

Function Documentation

◆ calcHash() [1/2]

unsigned int Syndication::calcHash ( const QByteArray & array)

Definition at line 30 of file tools.cpp.

◆ calcHash() [2/2]

unsigned int Syndication::calcHash ( const QString & str)

Definition at line 25 of file tools.cpp.

◆ calcMD5Sum()

QString Syndication::calcMD5Sum ( const QString & str)

Definition at line 103 of file tools.cpp.

◆ commentApiNamespace()

SYNDICATION_EXPORT QString Syndication::commentApiNamespace ( )

wellformedweb.org's RSS namespace for comment functionality "http://wellformedweb.org/CommentAPI/"

Definition at line 39 of file constants.cpp.

◆ contentNameSpace()

SYNDICATION_EXPORT QString Syndication::contentNameSpace ( )

Definition at line 24 of file constants.cpp.

◆ convertNewlines()

QString Syndication::convertNewlines ( const QString & strp)

Definition at line 126 of file tools.cpp.

◆ dateTimeToString()

QString Syndication::dateTimeToString ( uint date)

Definition at line 91 of file tools.cpp.

◆ dublinCoreNamespace()

SYNDICATION_EXPORT QString Syndication::dublinCoreNamespace ( )

Definition at line 29 of file constants.cpp.

◆ escapeSpecialCharacters()

QString Syndication::escapeSpecialCharacters ( const QString & strp)

Definition at line 115 of file tools.cpp.

◆ htmlToPlainText()

QString Syndication::htmlToPlainText ( const QString & html)

Definition at line 144 of file tools.cpp.

◆ isHtml()

bool Syndication::isHtml ( const QString & str)

Definition at line 174 of file tools.cpp.

◆ itunesNamespace()

SYNDICATION_EXPORT QString Syndication::itunesNamespace ( )

Definition at line 34 of file constants.cpp.

◆ normalize() [1/2]

QString Syndication::normalize ( const QString & str)

Definition at line 189 of file tools.cpp.

◆ normalize() [2/2]

QString Syndication::normalize ( const QString & strp,
bool isCDATA,
bool containsMarkup )

Definition at line 194 of file tools.cpp.

◆ parse()

SYNDICATION_EXPORT FeedPtr Syndication::parse ( const DocumentSource & src,
const QString & formatHint = QString() )

parses a document from a source and returns a new Feed object wrapping the feed content.

Shortcut for parserCollection()->parse(). See ParserCollection::parse() for more details.

Parameters
srcthe document source to parse
formatHintan optional hint which format to test first

Definition at line 54 of file global.cpp.

◆ parseDate()

uint Syndication::parseDate ( const QString & str,
DateFormat hint )

Definition at line 76 of file tools.cpp.

◆ parseISODate()

uint Syndication::parseISODate ( const QString & str)

Definition at line 60 of file tools.cpp.

◆ parserCollection()

SYNDICATION_EXPORT ParserCollection< Feed > * Syndication::parserCollection ( )

The default ParserCollection instance parsing a DocumentSource into a Feed object.

Use this to parse a local file or a otherwise manually created DocumentSource object.

To retrieve a feed from the web, use Loader instead.

Example code:

...
QFile someFile(somePath);
...
DocumentSource src(someFile.readAll());
someFile.close();
FeedPtr feed = parserCollection()->parse(src);
if (feed)
{
QString title = feed->title();
QList<ItemPtr> items = feed->items();
...
}
ParserCollection< Feed > * parserCollection()
The default ParserCollection instance parsing a DocumentSource into a Feed object.
Definition global.cpp:41

Definition at line 41 of file global.cpp.

◆ parseRFCDate()

uint Syndication::parseRFCDate ( const QString & str)

Definition at line 66 of file tools.cpp.

◆ personFromString()

PersonPtr Syndication::personFromString ( const QString & strp)

Definition at line 213 of file tools.cpp.

◆ plainTextToHtml()

QString Syndication::plainTextToHtml ( const QString & plainText)

Definition at line 133 of file tools.cpp.

◆ resolveEntities()

QString Syndication::resolveEntities ( const QString & str)

Definition at line 110 of file tools.cpp.

◆ slashNamespace()

SYNDICATION_EXPORT QString Syndication::slashNamespace ( )

"slash" namespace http://purl.org/rss/1.0/modules/slash/

Definition at line 44 of file constants.cpp.

◆ stringContainsMarkup()

bool Syndication::stringContainsMarkup ( const QString & str)

Definition at line 159 of file tools.cpp.

◆ tagRegExp()

static QRegularExpression Syndication::tagRegExp ( )
static

Definition at line 153 of file tools.cpp.

◆ toTimeT()

static uint Syndication::toTimeT ( QDateTime & kdt)
static

Definition at line 45 of file tools.cpp.

◆ xhtmlNamespace()

SYNDICATION_EXPORT QString Syndication::xhtmlNamespace ( )

Definition at line 19 of file constants.cpp.

◆ xmlNamespace()

SYNDICATION_EXPORT QString Syndication::xmlNamespace ( )

Definition at line 14 of file constants.cpp.

Variable Documentation

◆ parserColl

ParserCollectionImpl<Syndication::Feed>* Syndication::parserColl = nullptr
static

Definition at line 28 of file global.cpp.

This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Mon Nov 18 2024 12:09:18 by doxygen 1.12.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.