1
1
<?xml version="1.0"?>
2
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3
3
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
4
<refentry id="EFileCache">
4
<refentry id="libebackend-e-file-cache">
6
<refentrytitle role="top_of_page" id="EFileCache.top_of_page">EFileCache</refentrytitle>
6
<refentrytitle role="top_of_page" id="libebackend-e-file-cache.top_of_page">EFileCache</refentrytitle>
7
7
<manvolnum>3</manvolnum>
8
<refmiscinfo>LIBEBACKEND Library</refmiscinfo>
12
13
<refname>EFileCache</refname>
13
14
<refpurpose></refpurpose>
16
<refsynopsisdiv id="EFileCache.synopsis" role="synopsis">
17
<refsynopsisdiv id="libebackend-e-file-cache.synopsis" role="synopsis">
17
18
<title role="synopsis.title">Synopsis</title>
20
<link linkend="EFileCachePrivate">EFileCachePrivate</link>;
19
<anchor id="EFileCache"/>
20
<synopsis> <link linkend="EFileCachePrivate">EFileCachePrivate</link>;
21
21
<link linkend="EFileCache-struct">EFileCache</link>;
22
<link linkend="EFileCache">EFileCache</link> * <link linkend="e-file-cache-new">e_file_cache_new</link> (const <link linkend="gchar">gchar</link> *filename);
23
<link linkend="gboolean">gboolean</link> <link linkend="e-file-cache-remove">e_file_cache_remove</link> (<link linkend="EFileCache">EFileCache</link> *cache);
24
<link linkend="gboolean">gboolean</link> <link linkend="e-file-cache-clean">e_file_cache_clean</link> (<link linkend="EFileCache">EFileCache</link> *cache);
25
const <link linkend="gchar">gchar</link> * <link linkend="e-file-cache-get-object">e_file_cache_get_object</link> (<link linkend="EFileCache">EFileCache</link> *cache,
26
const <link linkend="gchar">gchar</link> *key);
27
<link linkend="GSList">GSList</link> * <link linkend="e-file-cache-get-objects">e_file_cache_get_objects</link> (<link linkend="EFileCache">EFileCache</link> *cache);
28
<link linkend="GSList">GSList</link> * <link linkend="e-file-cache-get-keys">e_file_cache_get_keys</link> (<link linkend="EFileCache">EFileCache</link> *cache);
29
<link linkend="gboolean">gboolean</link> <link linkend="e-file-cache-add-object">e_file_cache_add_object</link> (<link linkend="EFileCache">EFileCache</link> *cache,
30
const <link linkend="gchar">gchar</link> *key,
31
const <link linkend="gchar">gchar</link> *value);
32
<link linkend="gboolean">gboolean</link> <link linkend="e-file-cache-replace-object">e_file_cache_replace_object</link> (<link linkend="EFileCache">EFileCache</link> *cache,
33
const <link linkend="gchar">gchar</link> *key,
34
const <link linkend="gchar">gchar</link> *new_value);
35
<link linkend="gboolean">gboolean</link> <link linkend="e-file-cache-remove-object">e_file_cache_remove_object</link> (<link linkend="EFileCache">EFileCache</link> *cache,
36
const <link linkend="gchar">gchar</link> *key);
37
<link linkend="void">void</link> <link linkend="e-file-cache-freeze-changes">e_file_cache_freeze_changes</link> (<link linkend="EFileCache">EFileCache</link> *cache);
38
<link linkend="void">void</link> <link linkend="e-file-cache-thaw-changes">e_file_cache_thaw_changes</link> (<link linkend="EFileCache">EFileCache</link> *cache);
39
const <link linkend="gchar">gchar</link> * <link linkend="e-file-cache-get-filename">e_file_cache_get_filename</link> (<link linkend="EFileCache">EFileCache</link> *cache);
22
<link linkend="EFileCache"><returnvalue>EFileCache</returnvalue></link> * <link linkend="e-file-cache-new">e_file_cache_new</link> (<parameter>const <link linkend="gchar"><type>gchar</type></link> *filename</parameter>);
23
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> <link linkend="e-file-cache-remove">e_file_cache_remove</link> (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>);
24
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> <link linkend="e-file-cache-clean">e_file_cache_clean</link> (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>);
25
const <link linkend="gchar"><returnvalue>gchar</returnvalue></link> * <link linkend="e-file-cache-get-object">e_file_cache_get_object</link> (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>,
26
<parameter>const <link linkend="gchar"><type>gchar</type></link> *key</parameter>);
27
<link linkend="GSList"><returnvalue>GSList</returnvalue></link> * <link linkend="e-file-cache-get-objects">e_file_cache_get_objects</link> (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>);
28
<link linkend="GSList"><returnvalue>GSList</returnvalue></link> * <link linkend="e-file-cache-get-keys">e_file_cache_get_keys</link> (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>);
29
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> <link linkend="e-file-cache-add-object">e_file_cache_add_object</link> (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>,
30
<parameter>const <link linkend="gchar"><type>gchar</type></link> *key</parameter>,
31
<parameter>const <link linkend="gchar"><type>gchar</type></link> *value</parameter>);
32
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> <link linkend="e-file-cache-replace-object">e_file_cache_replace_object</link> (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>,
33
<parameter>const <link linkend="gchar"><type>gchar</type></link> *key</parameter>,
34
<parameter>const <link linkend="gchar"><type>gchar</type></link> *new_value</parameter>);
35
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> <link linkend="e-file-cache-remove-object">e_file_cache_remove_object</link> (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>,
36
<parameter>const <link linkend="gchar"><type>gchar</type></link> *key</parameter>);
37
<link linkend="void"><returnvalue>void</returnvalue></link> <link linkend="e-file-cache-freeze-changes">e_file_cache_freeze_changes</link> (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>);
38
<link linkend="void"><returnvalue>void</returnvalue></link> <link linkend="e-file-cache-thaw-changes">e_file_cache_thaw_changes</link> (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>);
39
const <link linkend="gchar"><returnvalue>gchar</returnvalue></link> * <link linkend="e-file-cache-get-filename">e_file_cache_get_filename</link> (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>);
43
<refsect1 id="EFileCache.object-hierarchy" role="object_hierarchy">
42
<refsect1 id="libebackend-e-file-cache.object-hierarchy" role="object_hierarchy">
44
43
<title role="object_hierarchy.title">Object Hierarchy</title>
46
45
<link linkend="GObject">GObject</link>
55
<refsect1 id="EFileCache.properties" role="properties">
49
<refsect1 id="libebackend-e-file-cache.properties" role="properties">
56
50
<title role="properties.title">Properties</title>
58
"<link linkend="EFileCache--filename">filename</link>" <link linkend="gchar">gchar</link>* : Read / Write / Construct Only
52
"<link linkend="EFileCache--filename">filename</link>" <link linkend="gchar"><type>gchar</type></link>* : Read / Write / Construct Only
64
<refsect1 id="EFileCache.description" role="desc">
56
<refsect1 id="libebackend-e-file-cache.description" role="desc">
65
57
<title role="desc.title">Description</title>
70
<refsect1 id="EFileCache.details" role="details">
61
<refsect1 id="libebackend-e-file-cache.details" role="details">
71
62
<title role="details.title">Details</title>
72
63
<refsect2 id="EFileCachePrivate" role="struct">
73
64
<title>EFileCachePrivate</title>
74
<indexterm zone="EFileCachePrivate"><primary sortas="EFileCachePrivate">EFileCachePrivate</primary></indexterm><programlisting>typedef struct _EFileCachePrivate EFileCachePrivate;</programlisting>
65
<indexterm zone="EFileCachePrivate"><primary>EFileCachePrivate</primary></indexterm>
66
<programlisting>typedef struct _EFileCachePrivate EFileCachePrivate;</programlisting>
77
69
<refsect2 id="EFileCache-struct" role="struct">
78
70
<title>EFileCache</title>
79
<indexterm zone="EFileCache-struct"><primary sortas="EFileCache">EFileCache</primary></indexterm><programlisting>typedef struct _EFileCache EFileCache;</programlisting>
71
<indexterm zone="EFileCache-struct"><primary>EFileCache</primary></indexterm>
72
<programlisting>typedef struct _EFileCache EFileCache;</programlisting>
82
75
<refsect2 id="e-file-cache-new" role="function">
83
76
<title>e_file_cache_new ()</title>
84
<indexterm zone="e-file-cache-new"><primary sortas="e_file_cache_new">e_file_cache_new</primary></indexterm><programlisting><link linkend="EFileCache">EFileCache</link> * e_file_cache_new (const <link linkend="gchar">gchar</link> *filename);</programlisting>
77
<indexterm zone="e-file-cache-new"><primary>e_file_cache_new</primary></indexterm>
78
<programlisting><link linkend="EFileCache"><returnvalue>EFileCache</returnvalue></link> * e_file_cache_new (<parameter>const <link linkend="gchar"><type>gchar</type></link> *filename</parameter>);</programlisting>
86
80
Creates a new <link linkend="EFileCache"><type>EFileCache</type></link> object, which implements a cache of
87
81
objects, very useful for remote backends.</para>
89
</para><variablelist role="params">
82
<variablelist role="params">
90
83
<varlistentry><term><parameter>filename</parameter> :</term>
91
<listitem><simpara> filename where the cache is kept.
84
<listitem><simpara>filename where the cache is kept.
92
85
</simpara></listitem></varlistentry>
93
86
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The newly created object.
94
87
</simpara></listitem></varlistentry>
95
88
</variablelist></refsect2>
96
89
<refsect2 id="e-file-cache-remove" role="function">
97
90
<title>e_file_cache_remove ()</title>
98
<indexterm zone="e-file-cache-remove"><primary sortas="e_file_cache_remove">e_file_cache_remove</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> e_file_cache_remove (<link linkend="EFileCache">EFileCache</link> *cache);</programlisting>
91
<indexterm zone="e-file-cache-remove"><primary>e_file_cache_remove</primary></indexterm>
92
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> e_file_cache_remove (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>);</programlisting>
100
94
Remove the cache from disk.</para>
102
</para><variablelist role="params">
95
<variablelist role="params">
103
96
<varlistentry><term><parameter>cache</parameter> :</term>
104
<listitem><simpara> A <link linkend="EFileCache"><type>EFileCache</type></link> object.
97
<listitem><simpara>A <link linkend="EFileCache"><type>EFileCache</type></link> object.
105
98
</simpara></listitem></varlistentry>
106
99
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE if successful, FALSE otherwise.
107
100
</simpara></listitem></varlistentry>
108
101
</variablelist></refsect2>
109
102
<refsect2 id="e-file-cache-clean" role="function">
110
103
<title>e_file_cache_clean ()</title>
111
<indexterm zone="e-file-cache-clean"><primary sortas="e_file_cache_clean">e_file_cache_clean</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> e_file_cache_clean (<link linkend="EFileCache">EFileCache</link> *cache);</programlisting>
104
<indexterm zone="e-file-cache-clean"><primary>e_file_cache_clean</primary></indexterm>
105
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link> e_file_cache_clean (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>);</programlisting>
113
107
Clean up the cache's contents.</para>
115
</para><variablelist role="params">
108
<variablelist role="params">
116
109
<varlistentry><term><parameter>cache</parameter> :</term>
117
<listitem><simpara> A <link linkend="EFileCache"><type>EFileCache</type></link> object.
110
<listitem><simpara>A <link linkend="EFileCache"><type>EFileCache</type></link> object.
118
111
</simpara></listitem></varlistentry>
119
112
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> TRUE if successful, FALSE otherwise.
120
113
</simpara></listitem></varlistentry>
121
114
</variablelist></refsect2>
122
115
<refsect2 id="e-file-cache-get-object" role="function">
123
116
<title>e_file_cache_get_object ()</title>
124
<indexterm zone="e-file-cache-get-object"><primary sortas="e_file_cache_get_object">e_file_cache_get_object</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> * e_file_cache_get_object (<link linkend="EFileCache">EFileCache</link> *cache,
125
const <link linkend="gchar">gchar</link> *key);</programlisting>
129
</para><variablelist role="params">
117
<indexterm zone="e-file-cache-get-object"><primary>e_file_cache_get_object</primary></indexterm>
118
<programlisting>const <link linkend="gchar"><returnvalue>gchar</returnvalue></link> * e_file_cache_get_object (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>,
119
<parameter>const <link linkend="gchar"><type>gchar</type></link> *key</parameter>);</programlisting>
120
<variablelist role="params">
130
121
<varlistentry><term><parameter>cache</parameter> :</term>
131
122
<listitem><simpara>
132
123
</simpara></listitem></varlistentry>
223
204
</variablelist></refsect2>
224
205
<refsect2 id="e-file-cache-freeze-changes" role="function">
225
206
<title>e_file_cache_freeze_changes ()</title>
226
<indexterm zone="e-file-cache-freeze-changes"><primary sortas="e_file_cache_freeze_changes">e_file_cache_freeze_changes</primary></indexterm><programlisting><link linkend="void">void</link> e_file_cache_freeze_changes (<link linkend="EFileCache">EFileCache</link> *cache);</programlisting>
207
<indexterm zone="e-file-cache-freeze-changes"><primary>e_file_cache_freeze_changes</primary></indexterm>
208
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link> e_file_cache_freeze_changes (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>);</programlisting>
228
210
Disables temporarily all writes to disk for the given cache object.</para>
230
</para><variablelist role="params">
211
<variablelist role="params">
231
212
<varlistentry><term><parameter>cache</parameter> :</term>
232
<listitem><simpara> An <link linkend="EFileCache"><type>EFileCache</type></link> object.
213
<listitem><simpara>An <link linkend="EFileCache"><type>EFileCache</type></link> object.
233
214
</simpara></listitem></varlistentry>
234
215
</variablelist></refsect2>
235
216
<refsect2 id="e-file-cache-thaw-changes" role="function">
236
217
<title>e_file_cache_thaw_changes ()</title>
237
<indexterm zone="e-file-cache-thaw-changes"><primary sortas="e_file_cache_thaw_changes">e_file_cache_thaw_changes</primary></indexterm><programlisting><link linkend="void">void</link> e_file_cache_thaw_changes (<link linkend="EFileCache">EFileCache</link> *cache);</programlisting>
218
<indexterm zone="e-file-cache-thaw-changes"><primary>e_file_cache_thaw_changes</primary></indexterm>
219
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link> e_file_cache_thaw_changes (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>);</programlisting>
239
221
Enables again writes to disk on every change.</para>
241
</para><variablelist role="params">
222
<variablelist role="params">
242
223
<varlistentry><term><parameter>cache</parameter> :</term>
243
<listitem><simpara> An <link linkend="EFileCache"><type>EFileCache</type></link> object.
224
<listitem><simpara>An <link linkend="EFileCache"><type>EFileCache</type></link> object.
244
225
</simpara></listitem></varlistentry>
245
226
</variablelist></refsect2>
246
227
<refsect2 id="e-file-cache-get-filename" role="function">
247
228
<title>e_file_cache_get_filename ()</title>
248
<indexterm zone="e-file-cache-get-filename"><primary sortas="e_file_cache_get_filename">e_file_cache_get_filename</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link> * e_file_cache_get_filename (<link linkend="EFileCache">EFileCache</link> *cache);</programlisting>
229
<indexterm zone="e-file-cache-get-filename"><primary>e_file_cache_get_filename</primary></indexterm>
230
<programlisting>const <link linkend="gchar"><returnvalue>gchar</returnvalue></link> * e_file_cache_get_filename (<parameter><link linkend="EFileCache"><type>EFileCache</type></link> *cache</parameter>);</programlisting>
250
232
Gets the name of the file where the cache is being stored.</para>
252
</para><variablelist role="params">
233
<variablelist role="params">
253
234
<varlistentry><term><parameter>cache</parameter> :</term>
254
<listitem><simpara> A <link linkend="EFileCache"><literal>EFileCache</literal></link> object.
235
<listitem><simpara>A <link linkend="EFileCache"><literal>EFileCache</literal></link> object.
255
236
</simpara></listitem></varlistentry>
256
237
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> The name of the cache.
257
238
</simpara></listitem></varlistentry>
258
239
</variablelist></refsect2>
261
<refsect1 id="EFileCache.property-details" role="property_details">
242
<refsect1 id="libebackend-e-file-cache.property-details" role="property_details">
262
243
<title role="property_details.title">Property Details</title>
263
244
<refsect2 id="EFileCache--filename" role="property"><title>The <literal>"filename"</literal> property</title>
264
<indexterm zone="EFileCache--filename"><primary sortas="EFileCache:filename">EFileCache:filename</primary></indexterm><programlisting> "filename" <link linkend="gchar">gchar</link>* : Read / Write / Construct Only</programlisting>
245
<indexterm zone="EFileCache--filename"><primary>EFileCache:filename</primary></indexterm>
246
<programlisting> "filename" <link linkend="gchar"><type>gchar</type></link>* : Read / Write / Construct Only</programlisting>
265
247
<para></para><para>Default value: ""</para>