#include <vcalformat.h>

Public Member Functions | |
VCalFormat () | |
virtual | ~VCalFormat () |
bool | fromRawString (const Calendar::Ptr &calendar, const QByteArray &string, bool deleted=false, const QString ¬ebook=QString()) |
bool | fromString (const Calendar::Ptr &calendar, const QString &string, bool deleted=false, const QString ¬ebook=QString()) |
bool | load (const Calendar::Ptr &calendar, const QString &fileName) |
bool | save (const Calendar::Ptr &calendar, const QString &fileName) |
QString | toString (const Calendar::Ptr &calendar, const QString ¬ebook=QString(), bool deleted=false) |
Protected Member Functions | |
const char * | dayFromNum (int day) |
VObject * | eventToVEvent (const Event::Ptr &event) |
VObject * | eventToVTodo (const Todo::Ptr &todo) |
KDateTime | ISOToKDateTime (const QString &dtStr) |
QDate | ISOToQDate (const QString &dtStr) |
QString | kDateTimeToISO (const KDateTime &date, bool zulu=true) |
int | numFromDay (const QString &day) |
QString | parseDst (QByteArray &timezone) const |
QString | parseTZ (const QByteArray &timezone) const |
bool | parseTZOffsetISO8601 (const QString &s, int &result) |
void | populate (VObject *vcal, bool deleted=false, const QString ¬ebook=QString()) |
QString | qDateToISO (const QDate &date) |
void | readCustomProperties (VObject *o, const Incidence::Ptr &i) |
Attendee::PartStat | readStatus (const char *s) const |
Event::Ptr | VEventToEvent (VObject *vevent) |
virtual void | virtual_hook (int id, void *data) |
Todo::Ptr | VTodoToEvent (VObject *vtodo) |
void | writeCustomProperties (VObject *o, const Incidence::Ptr &i) |
QByteArray | writeStatus (Attendee::PartStat status) const |
Detailed Description
vCalendar format implementation.
This class implements the vCalendar format. It provides methods for loading/saving/converting vCalendar format data into the internal representation as Calendar and Incidences.
Definition at line 69 of file vcalformat.h.
Constructor & Destructor Documentation
Constructor a new vCalendar Format object.
Private class that helps to provide binary compatibility between releases.
Definition at line 77 of file vcalformat.cpp.
VCalFormat::~VCalFormat | ( | ) | [virtual] |
Destructor.
Definition at line 87 of file vcalformat.cpp.
Member Function Documentation
const char * VCalFormat::dayFromNum | ( | int | day | ) | [protected] |
Takes a number 0 - 6 and returns the two letter string of that day, i.e.
MO, TU, WE, etc.
- Parameters:
-
day number of the day to get a two letter name for. Range 0
-6
- See also:
- numFromDay().
Definition at line 2541 of file vcalformat.cpp.
VObject * VCalFormat::eventToVEvent | ( | const Event::Ptr & | event | ) | [protected] |
Translates an Event into a VEvent-type VObject and returns a pointer to it.
- Parameters:
-
event is a pointer to a valid Event object.
Definition at line 645 of file vcalformat.cpp.
VObject * VCalFormat::eventToVTodo | ( | const Todo::Ptr & | todo | ) | [protected] |
Translates a Todo into a VTodo-type VObject and return pointer.
- Parameters:
-
todo is a pointer to a valid Todo object.
Definition at line 303 of file vcalformat.cpp.
bool VCalFormat::fromRawString | ( | const Calendar::Ptr & | calendar, |
const QByteArray & | string, | ||
bool | deleted = false , |
||
const QString & | notebook = QString() |
||
) | [virtual] |
Parses a utf8 encoded string, returning the first iCal component encountered in that string.
This is an overload used for efficient reading to avoid utf8 conversions, which are expensive when reading from disk.
- Parameters:
-
calendar is the Calendar to be loaded. string is the QByteArray containing the Calendar data. deleted use deleted incidences notebook notebook uid
- Returns:
- true if successful; false otherwise.
- See also:
- fromString(), toString().
Implements KCalCore::CalFormat.
Definition at line 195 of file vcalformat.cpp.
bool VCalFormat::fromString | ( | const Calendar::Ptr & | calendar, |
const QString & | string, | ||
bool | deleted = false , |
||
const QString & | notebook = QString() |
||
) | [virtual] |
Loads a calendar from a string.
- Parameters:
-
calendar is the Calendar to be loaded. string is the QString containing the Calendar data. deleted use deleted incidences notebook notebook uid
- Returns:
- true if successful; false otherwise.
- See also:
- fromRawString(), toString().
Implements KCalCore::CalFormat.
Definition at line 189 of file vcalformat.cpp.
KDateTime VCalFormat::ISOToKDateTime | ( | const QString & | dtStr | ) | [protected] |
Takes a string in YYYYMMDDTHHMMSS format and returns a valid KDateTime.
- Parameters:
-
dtStr is a QString containing the date to convert. If this value is invalid, then KDateTime() is returned.
Definition at line 2154 of file vcalformat.cpp.
QDate VCalFormat::ISOToQDate | ( | const QString & | dtStr | ) | [protected] |
Takes a string in the YYYYMMDD format and returns a valid QDate.
- Parameters:
-
dtStr is a QString containing the date to convert. If this value is invalid, then KDateTime() is returned.
Definition at line 2183 of file vcalformat.cpp.
QString VCalFormat::kDateTimeToISO | ( | const KDateTime & | date, |
bool | zulu = true |
||
) | [protected] |
Takes a KDateTime and returns a string in format YYYYMMDDTHHMMSS.
- Parameters:
-
date is the date to format. zulu if true, then shift the date to UTC.
Definition at line 2126 of file vcalformat.cpp.
bool VCalFormat::load | ( | const Calendar::Ptr & | calendar, |
const QString & | fileName | ||
) | [virtual] |
Loads a calendar on disk into the calendar associated with this format.
- Parameters:
-
calendar is the Calendar to be loaded. fileName is the name of the disk file containing the Calendar data.
- Returns:
- true if successful; false otherwise.
Implements KCalCore::CalFormat.
Definition at line 92 of file vcalformat.cpp.
int VCalFormat::numFromDay | ( | const QString & | day | ) | [protected] |
Converts a two letter representation of the day (i.e.
MO, TU, WE, etc) and returns a number 0-6 corresponding to that ordinal day of the week.
- Parameters:
-
day is the QString containing the two letter day representation.
- See also:
- dayFromNum().
Definition at line 2548 of file vcalformat.cpp.
QString VCalFormat::parseDst | ( | QByteArray & | timezone | ) | const [protected] |
Parse DAYLIGHT tag from vtimezone.
Definition at line 2092 of file vcalformat.cpp.
QString VCalFormat::parseTZ | ( | const QByteArray & | timezone | ) | const [protected] |
Parse TZ tag from vtimezone.
Definition at line 2085 of file vcalformat.cpp.
bool VCalFormat::parseTZOffsetISO8601 | ( | const QString & | s, |
int & | result | ||
) | [protected] |
Parse one of the myriad of ISO8601 timezone offset formats, e.g.
+- hh : mm +- hh mm +- hh
- Parameters:
-
s string to be parsed. result timezone offset in seconds, if parse succeeded.
- Returns:
- Whether the parse succeeded or not.
Definition at line 2194 of file vcalformat.cpp.
void VCalFormat::populate | ( | VObject * | vcal, |
bool | deleted = false , |
||
const QString & | notebook = QString() |
||
) | [protected] |
Takes a vCalendar tree of VObjects, and puts all of them that have the "event" property into the dictionary, todos in the todo-list, etc.
Definition at line 2256 of file vcalformat.cpp.
QString VCalFormat::qDateToISO | ( | const QDate & | date | ) | [protected] |
Takes a QDate and returns a string in the format YYYYMMDDTHHMMSS.
- Parameters:
-
date is the date to format.
Definition at line 2113 of file vcalformat.cpp.
Attendee::PartStat VCalFormat::readStatus | ( | const char * | s | ) | const [protected] |
Converts a status string into an Attendee::PartStat.
- Parameters:
-
s is a null-terminated character string containing the status to convert.
- Returns:
- a valid Attendee::PartStat. If the string provided is empty, null, or the contents are unrecognized, then Attendee::NeedsAction is returned.
Definition at line 2575 of file vcalformat.cpp.
bool VCalFormat::save | ( | const Calendar::Ptr & | calendar, |
const QString & | fileName | ||
) | [virtual] |
Writes the calendar to disk.
- Parameters:
-
calendar is the Calendar containing the data to be saved. fileName is the name of the file to write the calendar data.
- Returns:
- true if successful; false otherwise.
Implements KCalCore::CalFormat.
Definition at line 123 of file vcalformat.cpp.
QString VCalFormat::toString | ( | const Calendar::Ptr & | calendar, |
const QString & | notebook = QString() , |
||
bool | deleted = false |
||
) | [virtual] |
Returns the calendar as a string.
- Parameters:
-
calendar is the Calendar containing the data to be saved. notebook uid use only incidences with given notebook deleted use deleted incidences
- Returns:
- a QString containing the Calendar data if successful; an empty string otherwise.
- See also:
- fromString(), fromRawString().
Implements KCalCore::CalFormat.
Definition at line 224 of file vcalformat.cpp.
Event::Ptr VCalFormat::VEventToEvent | ( | VObject * | vevent | ) | [protected] |
Translates a VObject into a Event and returns a pointer to it.
- Parameters:
-
vevent is a pointer to a valid VObject object.
Definition at line 1509 of file vcalformat.cpp.
void VCalFormat::virtual_hook | ( | int | id, |
void * | data | ||
) | [protected, virtual] |
Standard trick to add virtuals later.
- Parameters:
-
id is any integer unique to this class which we will use to identify the method to be called. data is a pointer to some glob of data, typically a struct.
Reimplemented from KCalCore::CalFormat.
Definition at line 2671 of file vcalformat.cpp.
Todo::Ptr VCalFormat::VTodoToEvent | ( | VObject * | vtodo | ) | [protected] |
Translates a VObject of the TODO type into an Event.
- Parameters:
-
vtodo is a pointer to a valid VObject object.
Definition at line 1018 of file vcalformat.cpp.
QByteArray VCalFormat::writeStatus | ( | Attendee::PartStat | status | ) | const [protected] |
Converts an Attendee::PartStat into a QByteArray string.
- Parameters:
-
status is the Attendee::PartStat to convert.
- Returns:
- a QByteArray containing the status string.
Definition at line 2607 of file vcalformat.cpp.
The documentation for this class was generated from the following files: