icalset.h

Go to the documentation of this file.

/*
 SPDX-FileCopyrightText: 2000, Eric Busboom <eric@civicknowledge.com>
 SPDX-License-Identifier: LGPL-2.1-only OR MPL-2.0

 The Original Code is eric. The Initial Developer of the Original
 Code is Eric Busboom
*/

#ifndef ICALSET_H
#define ICALSET_H

#include "libical_icalss_export.h"
#include "icalgauge.h"
#include "icalcomponent.h"
#include "icalerror.h"

typedef struct icalset_impl icalset;

typedef enum icalset_kind
{
    ICAL_FILE_SET, 
    ICAL_DIR_SET,  
    ICAL_BDB_SET   
} icalset_kind;

struct icalcompiter;
typedef struct icalsetiter {
    icalcompiter iter; /* icalcomponent_kind, icalpvl_elem iter */
    icalgauge *gauge;
    icalrecur_iterator *ritr;      /*the last iterator */
    icalcomponent *last_component; /*the pending recurring component to be processed  */
    const char *tzid;              /* the calendar's timezone id */
} icalsetiter;

struct icalset_impl {
    icalset_kind kind;
    size_t size;
    char *dsn;
    icalset *(*init)(icalset *set, const char *dsn, void *options);
    void (*free)(icalset *set);
    const char *(*path)(icalset *set);
    void (*mark)(icalset *set);
    icalerrorenum (*commit)(icalset *set);
    icalerrorenum (*add_component)(icalset *set, icalcomponent *comp);
    icalerrorenum (*remove_component)(icalset *set, icalcomponent *comp);
    int (*count_components)(icalset *set, icalcomponent_kind kind);
    icalerrorenum (*select)(icalset *set, icalgauge *gauge);
    void (*clear)(icalset *set);
    icalcomponent *(*fetch)(icalset *set, icalcomponent_kind kind, const char *uid);
    icalcomponent *(*fetch_match)(icalset *set, const icalcomponent *comp);
    int (*has_uid)(icalset *set, const char *uid);
    icalerrorenum (*modify)(icalset *set, icalcomponent *old, icalcomponent *newc);
    icalcomponent *(*get_current_component)(icalset *set);
    icalcomponent *(*get_first_component)(icalset *set);
    icalcomponent *(*get_next_component)(icalset *set);
    icalsetiter (*icalset_begin_component)(icalset *set,
                                           icalcomponent_kind kind, icalgauge *gauge,
                                           const char *tzid);
    icalcomponent *(*icalsetiter_to_next)(icalset *set, icalsetiter *i);
    icalcomponent *(*icalsetiter_to_prior)(icalset *set, icalsetiter *i);
};

LIBICAL_ICALSS_EXPORT bool icalset_register_class(icalset *set);

LIBICAL_ICALSS_EXPORT icalset *icalset_new(icalset_kind kind, const char *dsn, void *options);

LIBICAL_ICALSS_EXPORT icalset *icalset_new_file(const char *path);

LIBICAL_ICALSS_EXPORT icalset *icalset_new_file_reader(const char *path);

LIBICAL_ICALSS_EXPORT icalset *icalset_new_file_writer(const char *path);

LIBICAL_ICALSS_EXPORT icalset *icalset_new_dir(const char *path);

LIBICAL_ICALSS_EXPORT void icalset_free(icalset *set);

LIBICAL_ICALSS_EXPORT const char *icalset_path(icalset *set);

LIBICAL_ICALSS_EXPORT void icalset_mark(icalset *set);

LIBICAL_ICALSS_EXPORT icalerrorenum icalset_commit(icalset *set);

LIBICAL_ICALSS_EXPORT icalerrorenum icalset_add_component(icalset *set, icalcomponent *comp);

LIBICAL_ICALSS_EXPORT icalerrorenum icalset_remove_component(icalset *set, icalcomponent *comp);

LIBICAL_ICALSS_EXPORT int icalset_count_components(icalset *set, icalcomponent_kind kind);

LIBICAL_ICALSS_EXPORT icalerrorenum icalset_select(icalset *set, icalgauge *gauge);

LIBICAL_ICALSS_EXPORT icalcomponent *icalset_fetch(icalset *set, const char *uid);

LIBICAL_ICALSS_EXPORT int icalset_has_uid(icalset *set, const char *uid);

LIBICAL_ICALSS_EXPORT icalcomponent *icalset_fetch_match(icalset *set, const icalcomponent *c);

LIBICAL_ICALSS_EXPORT icalerrorenum icalset_modify(icalset *set,
                                                   icalcomponent *oldc, icalcomponent *newc);

LIBICAL_ICALSS_EXPORT icalcomponent *icalset_get_current_component(icalset *set);

LIBICAL_ICALSS_EXPORT icalcomponent *icalset_get_first_component(icalset *set);

LIBICAL_ICALSS_EXPORT icalcomponent *icalset_get_next_component(icalset *set);

LIBICAL_ICALSS_EXPORT extern icalsetiter icalsetiter_null;

LIBICAL_ICALSS_EXPORT icalsetiter icalset_begin_component(icalset *set,
                                                          icalcomponent_kind kind,
                                                          icalgauge *gauge, const char *tzid);

LIBICAL_ICALSS_EXPORT icalcomponent *icalsetiter_next(icalsetiter *i);

LIBICAL_ICALSS_EXPORT icalcomponent *icalsetiter_prior(icalsetiter *i);

LIBICAL_ICALSS_EXPORT icalcomponent *icalsetiter_deref(icalsetiter *i);

LIBICAL_ICALSS_EXPORT icalcomponent *icalsetiter_to_next(icalset *set, icalsetiter *i);

LIBICAL_ICALSS_EXPORT icalcomponent *icalsetiter_to_prior(icalset *set, icalsetiter *i);

#endif /* !ICALSET_H */