vcalformat.h

Go to the documentation of this file.

/*
  This file is part of the kcalcore library.

  SPDX-FileCopyrightText: 1998 Preston Brown <[email protected]>
  SPDX-FileCopyrightText: 2001-2003 Cornelius Schumacher <[email protected]>

  SPDX-License-Identifier: LGPL-2.0-or-later
*/
#ifndef KCALCORE_VCALFORMAT_H
#define KCALCORE_VCALFORMAT_H

#include "kcalendarcore_export.h"
#include "attendee.h"
#include "calformat.h"
#include "event.h"
#include "todo.h"
#include "journal.h"

struct VObject;

class QDate;

#define _VCAL_VERSION "1.0"

/* extensions for iMIP / iTIP */
#define ICOrganizerProp       "X-ORGANIZER"
#define ICMethodProp          "X-METHOD"
#define ICRequestStatusProp   "X-REQUEST-STATUS"

namespace KCalendarCore
{

class Event;
class Todo;

class KCALENDARCORE_EXPORT VCalFormat : public CalFormat
{
public:
    VCalFormat();

    ~VCalFormat() override;

    bool load(const Calendar::Ptr &calendar, const QString &fileName) override;

    bool save(const Calendar::Ptr &calendar, const QString &fileName) override;

    Q_REQUIRED_RESULT bool fromString(const Calendar::Ptr &calendar, const QString &string,
                    bool deleted = false, const QString &notebook = QString()) override;

    Q_REQUIRED_RESULT QString toString(const Calendar::Ptr &calendar, const QString &notebook = QString(),
                     bool deleted = false) override;

    Q_REQUIRED_RESULT bool fromRawString(const Calendar::Ptr &calendar, const QByteArray &string,
                       bool deleted = false, const QString &notebook = QString()) override;

protected:
    Todo::Ptr VTodoToEvent(VObject *vtodo);

    Event::Ptr VEventToEvent(VObject *vevent);

    QString parseTZ(const QByteArray &timezone) const;

    QString parseDst(QByteArray &timezone) const;

    QString qDateToISO(const QDate &date);

    QString qDateTimeToISO(const QDateTime &date, bool zulu = true);

    QDateTime ISOToQDateTime(const QString &dtStr);

    QDate ISOToQDate(const QString &dtStr);

    bool parseTZOffsetISO8601(const QString &s, int &result);

    void populate(VObject *vcal, bool deleted = false, const QString &notebook = QString());

    int numFromDay(const QString &day);

    Attendee::PartStat readStatus(const char *s) const;

    QByteArray writeStatus(Attendee::PartStat status) const;

    void readCustomProperties(VObject *o, const Incidence::Ptr &i);
    void writeCustomProperties(VObject *o, const Incidence::Ptr &i);

protected:
    void virtual_hook(int id, void *data) override;

private:
    //@cond PRIVATE
    Q_DISABLE_COPY(VCalFormat)
    class Private;
    Private *const d;
    //@endcond
};

}

#endif