KCalCore::ICalTimeZones Class Reference

#include <icaltimezones.h>

Public Types
typedef QMap< QString, ICalTimeZone >	ZoneMap

Public Member Functions
	ICalTimeZones ()
	ICalTimeZones (const ICalTimeZones &rhs)
	~ICalTimeZones ()
bool	add (const ICalTimeZone &zone)
void	clear ()
int	count ()
ICalTimeZones &	operator= (const ICalTimeZones &rhs)
ICalTimeZone	remove (const ICalTimeZone &zone)
ICalTimeZone	remove (const QString &name)
ICalTimeZone	zone (const QString &name) const
ICalTimeZone	zone (const ICalTimeZone &zone) const
const ZoneMap	zones () const

Detailed Description

The ICalTimeZones class represents a time zone database which consists of a collection of individual iCalendar time zone definitions.

Each individual time zone is defined in a ICalTimeZone instance. The time zones in the collection are indexed by name, which must be unique within the collection.

Different calendars could define the same time zone differently. As a result, to avoid conflicting definitions, each calendar should normally have its own ICalTimeZones collection.

This class is analogous to KTimeZones, but holds ICalTimeZone instances rather than generic KTimeZone instances.

Represents a collection of iCalendar time zones

Author

David Jarvie djarv.nosp@m.ie@k.nosp@m.de.or.nosp@m.g

Definition at line 65 of file icaltimezones.h.

Constructor & Destructor Documentation

KCalCore::ICalTimeZones::ICalTimeZones

(

)

Constructs an empty time zone collection.

Definition at line 104 of file icaltimezones.cpp.

KCalCore::ICalTimeZones::ICalTimeZones

(

const ICalTimeZones &

rhs

)

Copy constructor.

Parameters

rhs	is the ICalTimeZones instance to copy.

Definition at line 109 of file icaltimezones.cpp.

KCalCore::ICalTimeZones::~ICalTimeZones

(

)

Destructor.

Definition at line 125 of file icaltimezones.cpp.

Member Function Documentation

bool KCalCore::ICalTimeZones::add

(

const ICalTimeZone &

zone

)

Adds a time zone to the collection.

The time zone's name must be unique within the collection.

Parameters

zone	time zone to add

Returns

true if successful, false if zone's name duplicates one already in the collection

Definition at line 135 of file icaltimezones.cpp.

void KCalCore::ICalTimeZones::clear

(

)

Clears the collection.

Definition at line 174 of file icaltimezones.cpp.

int KCalCore::ICalTimeZones::count

(

)

Returns the number of zones kept in memory.

Returns

The number of zones

Definition at line 179 of file icaltimezones.cpp.

ICalTimeZones & KCalCore::ICalTimeZones::operator=

(

const ICalTimeZones &

rhs

)

Assignment operator.

Parameters

rhs	is the ICalTimeZones instance to assign to this one.

Definition at line 115 of file icaltimezones.cpp.

ICalTimeZone KCalCore::ICalTimeZones::remove

(

const ICalTimeZone &

zone

)

Removes a time zone from the collection.

Parameters

zone	time zone to remove

Returns

the time zone which was removed, or invalid if not found

Definition at line 148 of file icaltimezones.cpp.

ICalTimeZone KCalCore::ICalTimeZones::remove

(

const QString &

name

)

Removes a time zone from the collection.

Parameters

name	name of time zone to remove

Returns

the time zone which was removed, or invalid if not found

Definition at line 161 of file icaltimezones.cpp.

ICalTimeZone KCalCore::ICalTimeZones::zone

(

const QString &

name

)

const

Returns the time zone with the given name.

Note that the ICalTimeZone returned remains a member of the ICalTimeZones collection, and should not be deleted without calling remove() first.

Parameters

name	name of time zone

Returns

time zone, or invalid if not found

Definition at line 184 of file icaltimezones.cpp.

ICalTimeZone KCalCore::ICalTimeZones::zone

(

const ICalTimeZone &

zone

)

const

Returns the time zone with similar zone information regardless of the time zone names.

This feature was added for Microsoft ActiveSync which may have the same timezone specification separately for every incidence. Note that the ICalTimeZone returned remains a member of the ICalTimeZones collection, and should not be deleted without calling remove() first.

See also

ICalTimeZone parse( MSTimeZone *tz, ICalTimeZones &zones );

Parameters

zone	zone information to look for

Returns

time zone, or invalid if not found

Definition at line 195 of file icaltimezones.cpp.

const ICalTimeZones::ZoneMap KCalCore::ICalTimeZones::zones

(

)

const

Returns all the time zones defined in this collection.

Returns

time zone collection

Definition at line 130 of file icaltimezones.cpp.

---

The documentation for this class was generated from the following files:

• icaltimezones.h
• icaltimezones.cpp