Libical API Documentation  3.0
icalfileset.h
1 /*======================================================================
2  FILE: icalfileset.h
3  CREATOR: eric 23 December 1999
4 
5  (C) COPYRIGHT 2000, Eric Busboom <eric@softwarestudio.org>
6 
7  This library is free software; you can redistribute it and/or modify
8  it under the terms of either:
9 
10  The LGPL as published by the Free Software Foundation, version
11  2.1, available at: http://www.gnu.org/licenses/lgpl-2.1.html
12 
13  Or:
14 
15  The Mozilla Public License Version 2.0. You may obtain a copy of
16  the License at http://www.mozilla.org/MPL/
17 
18  The Original Code is eric. The Initial Developer of the Original
19  Code is Eric Busboom
20 ======================================================================*/
21 
22 #ifndef ICALFILESET_H
23 #define ICALFILESET_H
24 
25 #include "libical_icalss_export.h"
26 #include "icalcluster.h"
27 #include "icalset.h"
28 
29 typedef struct icalfileset_impl icalfileset;
30 
31 LIBICAL_ICALSS_EXPORT icalset *icalfileset_new(const char *path);
32 
33 LIBICAL_ICALSS_EXPORT icalset *icalfileset_new_reader(const char *path);
34 
35 LIBICAL_ICALSS_EXPORT icalset *icalfileset_new_writer(const char *path);
36 
37 LIBICAL_ICALSS_EXPORT icalset *icalfileset_init(icalset *set, const char *dsn, void *options);
38 
39 LIBICAL_ICALSS_EXPORT icalcluster *icalfileset_produce_icalcluster(const char *path);
40 
41 LIBICAL_ICALSS_EXPORT void icalfileset_free(icalset *cluster);
42 
43 LIBICAL_ICALSS_EXPORT const char *icalfileset_path(icalset *cluster);
44 
45 /* Mark the cluster as changed, so it will be written to disk when it
46  is freed. Commit writes to disk immediately. */
47 LIBICAL_ICALSS_EXPORT void icalfileset_mark(icalset *set);
48 
49 LIBICAL_ICALSS_EXPORT icalerrorenum icalfileset_commit(icalset *set);
50 
51 LIBICAL_ICALSS_EXPORT icalerrorenum icalfileset_add_component(icalset *set, icalcomponent *child);
52 
53 LIBICAL_ICALSS_EXPORT icalerrorenum icalfileset_remove_component(icalset *set,
54  icalcomponent *child);
55 
56 LIBICAL_ICALSS_EXPORT int icalfileset_count_components(icalset *set, icalcomponent_kind kind);
57 
62 LIBICAL_ICALSS_EXPORT icalerrorenum icalfileset_select(icalset *set, icalgauge *gauge);
63 
65 LIBICAL_ICALSS_EXPORT void icalfileset_clear(icalset *set);
66 
68 LIBICAL_ICALSS_EXPORT icalcomponent *icalfileset_fetch(icalset *set,
69  icalcomponent_kind kind, const char *uid);
70 
71 LIBICAL_ICALSS_EXPORT int icalfileset_has_uid(icalset *set, const char *uid);
72 
73 LIBICAL_ICALSS_EXPORT icalcomponent *icalfileset_fetch_match(icalset *set, icalcomponent *c);
74 
79 LIBICAL_ICALSS_EXPORT icalerrorenum icalfileset_modify(icalset *set,
80  icalcomponent *oldcomp,
81  icalcomponent *newcomp);
82 
83 /* Iterate through components. If a gauge has been defined, these
84  will skip over components that do not pass the gauge */
85 
86 LIBICAL_ICALSS_EXPORT icalcomponent *icalfileset_get_current_component(icalset *cluster);
87 
88 LIBICAL_ICALSS_EXPORT icalcomponent *icalfileset_get_first_component(icalset *cluster);
89 
90 LIBICAL_ICALSS_EXPORT icalcomponent *icalfileset_get_next_component(icalset *cluster);
91 
92 /* External iterator for thread safety */
93 LIBICAL_ICALSS_EXPORT icalsetiter icalfileset_begin_component(icalset *set,
94  icalcomponent_kind kind,
95  icalgauge *gauge, const char *tzid);
96 
97 LIBICAL_ICALSS_EXPORT icalcomponent *icalfilesetiter_to_next(icalset *set, icalsetiter *iter);
98 
99 LIBICAL_ICALSS_EXPORT icalcomponent *icalfileset_form_a_matched_recurrence_component(icalsetiter *
100  itr);
101 
105 LIBICAL_ICALSS_EXPORT icalcomponent *icalfileset_get_component(icalset *cluster);
106 
113 typedef struct icalfileset_options
114 {
115  int flags;
116  int mode;
120 
121 extern icalfileset_options icalfileset_options_default;
122 
123 #endif /* !ICALFILESET_H */
Definition: icalgaugeimpl.h:55
int safe_saves
Definition: icalfileset.h:117
icalcluster * cluster
Definition: icalfileset.h:118
icalfileset_options options
Definition: icalfilesetimpl.h:32
Definition: icalset.h:51
icalerrorenum
Represents the different types of errors that can be triggered in libical.
Definition: icalerror.h:74
options for opening an icalfileset.
Definition: icalfileset.h:113
icalcomponent * cluster
Definition: icalfilesetimpl.h:34
char * path
Definition: icalfilesetimpl.h:31
int mode
Definition: icalfileset.h:116
icalgauge * gauge
Definition: icalfilesetimpl.h:35
Definition: icalcomponent.c:33
Definition: icalfilesetimpl.h:28
Definition: icalset.h:60
int flags
Definition: icalfileset.h:115
Definition: icalclusterimpl.h:27