Syndication::RDF::SyndicationInfo

Search for usage in LXR

Syndication::RDF::SyndicationInfo Class Reference

#include <syndicationinfo.h>

Inheritance diagram for Syndication::RDF::SyndicationInfo:

Public Types

enum  Period {
  Hourly , Daily , Weekly , Monthly ,
  Yearly
}
 

Public Member Functions

 SyndicationInfo ()
 
 SyndicationInfo (ResourcePtr resource)
 
 ~SyndicationInfo () override
 
QString debugInfo () const
 
time_t updateBase () const
 
int updateFrequency () const
 
Period updatePeriod () const
 
- Public Member Functions inherited from Syndication::RDF::ResourceWrapper
 ResourceWrapper ()
 
 ResourceWrapper (const ResourceWrapper &other)
 
 ResourceWrapper (ResourcePtr resource)
 
virtual ~ResourceWrapper ()
 
bool isNull () const
 
ResourceWrapperoperator= (const ResourceWrapper &other)
 
bool operator== (const ResourceWrapper &other) const
 
ResourcePtr resource () const
 

Static Protected Member Functions

static QString periodToString (Period period)
 
static Period stringToPeriod (const QString &str)
 

Detailed Description

Wrapper to access syndication information for a feed.

The RSS 1.0 syndication module provides syndication hints to aggregators regarding how often it is updated.

The specification can be found at http://web.resource.org/rss/1.0/modules/syndication/

Author
Frank Osterfeld

Definition at line 31 of file syndicationinfo.h.

Member Enumeration Documentation

◆ Period

update period enum as used by updatePeriod().

Enumerator
Hourly 

the feed is updated hourly

Daily 

the feed is updated daily

Weekly 

the feed is updated weekly

Monthly 

the feed is updated monthly

Yearly 

the feed is updated yearly

Definition at line 37 of file syndicationinfo.h.

Constructor & Destructor Documentation

◆ SyndicationInfo() [1/2]

Syndication::RDF::SyndicationInfo::SyndicationInfo ( )

creates a wrapper wrapping a null resource.

isNull() will be true.

◆ SyndicationInfo() [2/2]

Syndication::RDF::SyndicationInfo::SyndicationInfo ( ResourcePtr resource)
explicit

creates a wrapper from a resource

Parameters
resourcethe feed resource to read syndication information from

Definition at line 21 of file syndicationinfo.cpp.

◆ ~SyndicationInfo()

Syndication::RDF::SyndicationInfo::~SyndicationInfo ( )
override

virtual destructor

Definition at line 26 of file syndicationinfo.cpp.

Member Function Documentation

◆ debugInfo()

QString Syndication::RDF::SyndicationInfo::debugInfo ( ) const

description of the syndication information for debugging purposes

Returns
debug string

Definition at line 60 of file syndicationinfo.cpp.

◆ periodToString()

QString Syndication::RDF::SyndicationInfo::periodToString ( Period period)
staticprotected

returns Period value as string.

Parameters
periodperiod enum to convert to a string
Returns
the enum name in lower case, "daily", "hourly", etc.

Definition at line 76 of file syndicationinfo.cpp.

◆ stringToPeriod()

SyndicationInfo::Period Syndication::RDF::SyndicationInfo::stringToPeriod ( const QString & str)
staticprotected

parses a Period value from a string.

Parameters
stra period string as defined in the syndication module
Returns
the parsed period, Daily (the default) if the parsed string is empty or invalid

Definition at line 94 of file syndicationinfo.cpp.

◆ updateBase()

time_t Syndication::RDF::SyndicationInfo::updateBase ( ) const

Defines a base date to be used in concert with updatePeriod and updateFrequency to calculate the publishing schedule.

Returns
the base date in seconds since epoch. Default value is 0 (epoch).

Definition at line 53 of file syndicationinfo.cpp.

◆ updateFrequency()

int Syndication::RDF::SyndicationInfo::updateFrequency ( ) const

Used to describe the frequency of updates in relation to the update period.

A positive integer indicates how many times in that period the channel is updated. For example, an updatePeriod of daily, and an updateFrequency of 2 indicates the channel format is updated twice daily. If omitted a value of 1 is assumed.

Returns
update frequency, default is 1

Definition at line 35 of file syndicationinfo.cpp.

◆ updatePeriod()

SyndicationInfo::Period Syndication::RDF::SyndicationInfo::updatePeriod ( ) const

Describes the period over which the channel format is updated.

Acceptable values are: hourly, daily, weekly, monthly, yearly. If omitted, daily is assumed.

Returns
update period, daily is default

Definition at line 30 of file syndicationinfo.cpp.


The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Fri Dec 6 2024 12:02:22 by doxygen 1.12.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.