4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>CamelFilterDriver</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
7
<link rel="home" href="index.html" title="Camel Reference Manual">
8
8
<link rel="up" href="Filters.html" title="Filters">
9
9
<link rel="prev" href="Filters.html" title="Filters">
26
26
<a href="#camel-CamelFilterDriver.description" class="shortcut">Description</a>
29
<div class="refentry" lang="en">
29
<div class="refentry" title="CamelFilterDriver">
30
30
<a name="camel-CamelFilterDriver"></a><div class="titlepage"></div>
31
31
<div class="refnamediv"><table width="100%"><tr>
36
36
<td valign="top" align="right"></td>
37
37
</tr></table></div>
38
<div class="refsynopsisdiv">
38
<div class="refsynopsisdiv" title="Synopsis">
39
39
<a name="camel-CamelFilterDriver.synopsis"></a><h2>Synopsis</h2>
40
40
<pre class="synopsis">struct <a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver">CamelFilterDriver</a>;
41
41
<a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="returnvalue">CamelFolder</span></a> * (<a class="link" href="camel-CamelFilterDriver.html#CamelFilterGetFolderFunc" title="CamelFilterGetFolderFunc ()">*CamelFilterGetFolderFunc</a>) (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *driver</code></em>,
92
92
<em class="parameter"><code><span class="type">GPtrArray</span> *uids</code></em>,
93
93
<em class="parameter"><code><span class="type">gboolean</span> remove</code></em>,
94
94
<em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);
95
<span class="returnvalue">void</span> <a class="link" href="camel-CamelFilterDriver.html#camel-filter-driver-expand-option" title="camel_filter_driver_expand_option ()">camel_filter_driver_expand_option</a> (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
96
<em class="parameter"><code><span class="type">GString</span> *s</code></em>,
97
<em class="parameter"><code><span class="type">GString</span> *action</code></em>,
98
<em class="parameter"><code><span class="type">struct filter_option</span> *op</code></em>);
99
<span class="returnvalue">gint</span> <a class="link" href="camel-CamelFilterDriver.html#camel-filter-driver-rule-count" title="camel_filter_driver_rule_count ()">camel_filter_driver_rule_count</a> (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>);
100
struct <span class="returnvalue">filter_option</span> * <a class="link" href="camel-CamelFilterDriver.html#camel-filter-driver-rule-get" title="camel_filter_driver_rule_get ()">camel_filter_driver_rule_get</a> (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
101
<em class="parameter"><code><span class="type">gint</span> n</code></em>);
104
<div class="refsect1" lang="en">
97
<div class="refsect1" title="Description">
105
98
<a name="camel-CamelFilterDriver.description"></a><h2>Description</h2>
109
<div class="refsect1" lang="en">
102
<div class="refsect1" title="Details">
110
103
<a name="camel-CamelFilterDriver.details"></a><h2>Details</h2>
111
<div class="refsect2" lang="en">
104
<div class="refsect2" title="struct CamelFilterDriver">
112
105
<a name="CamelFilterDriver"></a><h3>struct CamelFilterDriver</h3>
113
106
<pre class="programlisting">struct CamelFilterDriver {
114
107
CamelObject parent;
123
<div class="refsect2" lang="en">
116
<div class="refsect2" title="CamelFilterGetFolderFunc ()">
124
117
<a name="CamelFilterGetFolderFunc"></a><h3>CamelFilterGetFolderFunc ()</h3>
125
118
<pre class="programlisting"><a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="returnvalue">CamelFolder</span></a> * (*CamelFilterGetFolderFunc) (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *driver</code></em>,
126
119
<em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>,
163
<div class="refsect2" lang="en">
156
<div class="refsect2" title="camel_filter_driver_new ()">
164
157
<a name="camel-filter-driver-new"></a><h3>camel_filter_driver_new ()</h3>
165
158
<pre class="programlisting"><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="returnvalue">CamelFilterDriver</span></a> * camel_filter_driver_new (<em class="parameter"><code><a class="link" href="camel-CamelSession.html#CamelSession" title="struct CamelSession"><span class="type">CamelSession</span></a> *Param1</code></em>);</pre>
166
159
<div class="variablelist"><table border="0">
183
<div class="refsect2" lang="en">
176
<div class="refsect2" title="camel_filter_driver_set_logfile ()">
184
177
<a name="camel-filter-driver-set-logfile"></a><h3>camel_filter_driver_set_logfile ()</h3>
185
178
<pre class="programlisting"><span class="returnvalue">void</span> camel_filter_driver_set_logfile (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
186
179
<em class="parameter"><code><span class="type">FILE</span> *logfile</code></em>);</pre>
206
<div class="refsect2" lang="en">
199
<div class="refsect2" title="camel_filter_driver_set_status_func ()">
207
200
<a name="camel-filter-driver-set-status-func"></a><h3>camel_filter_driver_set_status_func ()</h3>
208
201
<pre class="programlisting"><span class="returnvalue">void</span> camel_filter_driver_set_status_func (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
209
202
<em class="parameter"><code><span class="type">CamelFilterStatusFunc</span> *func</code></em>,
235
<div class="refsect2" lang="en">
228
<div class="refsect2" title="camel_filter_driver_set_shell_func ()">
236
229
<a name="camel-filter-driver-set-shell-func"></a><h3>camel_filter_driver_set_shell_func ()</h3>
237
230
<pre class="programlisting"><span class="returnvalue">void</span> camel_filter_driver_set_shell_func (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
238
231
<em class="parameter"><code><span class="type">CamelFilterShellFunc</span> *func</code></em>,
264
<div class="refsect2" lang="en">
257
<div class="refsect2" title="camel_filter_driver_set_play_sound_func ()">
265
258
<a name="camel-filter-driver-set-play-sound-func"></a><h3>camel_filter_driver_set_play_sound_func ()</h3>
266
259
<pre class="programlisting"><span class="returnvalue">void</span> camel_filter_driver_set_play_sound_func
267
260
(<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
294
<div class="refsect2" lang="en">
287
<div class="refsect2" title="camel_filter_driver_set_system_beep_func ()">
295
288
<a name="camel-filter-driver-set-system-beep-func"></a><h3>camel_filter_driver_set_system_beep_func ()</h3>
296
289
<pre class="programlisting"><span class="returnvalue">void</span> camel_filter_driver_set_system_beep_func
297
290
(<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
324
<div class="refsect2" lang="en">
317
<div class="refsect2" title="camel_filter_driver_set_folder_func ()">
325
318
<a name="camel-filter-driver-set-folder-func"></a><h3>camel_filter_driver_set_folder_func ()</h3>
326
319
<pre class="programlisting"><span class="returnvalue">void</span> camel_filter_driver_set_folder_func (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
327
320
<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterGetFolderFunc" title="CamelFilterGetFolderFunc ()"><span class="type">CamelFilterGetFolderFunc</span></a> fetcher</code></em>,
353
<div class="refsect2" lang="en">
346
<div class="refsect2" title="camel_filter_driver_set_default_folder ()">
354
347
<a name="camel-filter-driver-set-default-folder"></a><h3>camel_filter_driver_set_default_folder ()</h3>
355
348
<pre class="programlisting"><span class="returnvalue">void</span> camel_filter_driver_set_default_folder
356
349
(<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
377
<div class="refsect2" lang="en">
370
<div class="refsect2" title="camel_filter_driver_add_rule ()">
378
371
<a name="camel-filter-driver-add-rule"></a><h3>camel_filter_driver_add_rule ()</h3>
379
372
<pre class="programlisting"><span class="returnvalue">void</span> camel_filter_driver_add_rule (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
380
373
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
412
<div class="refsect2" lang="en">
405
<div class="refsect2" title="camel_filter_driver_remove_rule_by_name ()">
413
406
<a name="camel-filter-driver-remove-rule-by-name"></a><h3>camel_filter_driver_remove_rule_by_name ()</h3>
414
407
<pre class="programlisting"><span class="returnvalue">gint</span> camel_filter_driver_remove_rule_by_name
415
408
(<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
441
<div class="refsect2" lang="en">
434
<div class="refsect2" title="camel_filter_driver_flush ()">
442
435
<a name="camel-filter-driver-flush"></a><h3>camel_filter_driver_flush ()</h3>
443
436
<pre class="programlisting"><span class="returnvalue">void</span> camel_filter_driver_flush (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *driver</code></em>,
444
437
<em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);</pre>
446
Flush all of the only-once filter actions.</p>
439
Flush all of the only-once filter actions.
449
<div class="refsect2" lang="en">
443
<div class="refsect2" title="camel_filter_driver_filter_message ()">
450
444
<a name="camel-filter-driver-filter-message"></a><h3>camel_filter_driver_filter_message ()</h3>
451
445
<pre class="programlisting"><span class="returnvalue">gint</span> camel_filter_driver_filter_message (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *driver</code></em>,
452
446
<em class="parameter"><code><a class="link" href="camel-CamelMimeMessage.html#CamelMimeMessage" title="struct CamelMimeMessage"><span class="type">CamelMimeMessage</span></a> *message</code></em>,
461
455
object. If the source folder (<em class="parameter"><code>source</code></em>) and the uid (<em class="parameter"><code>uid</code></em>) are
462
456
provided, the filter will operate on the CamelFolder (which in
463
457
certain cases is more efficient than using the default
464
<a class="link" href="camel-CamelFolder.html#camel-folder-append-message" title="camel_folder_append_message ()"><code class="function">camel_folder_append_message()</code></a> function).</p>
458
<a class="link" href="camel-CamelFolder.html#camel-folder-append-message" title="camel_folder_append_message ()"><code class="function">camel_folder_append_message()</code></a> function).
465
460
<div class="variablelist"><table border="0">
466
461
<col align="left" valign="top">
519
<div class="refsect2" lang="en">
514
<div class="refsect2" title="camel_filter_driver_filter_mbox ()">
520
515
<a name="camel-filter-driver-filter-mbox"></a><h3>camel_filter_driver_filter_mbox ()</h3>
521
516
<pre class="programlisting"><span class="returnvalue">gint</span> camel_filter_driver_filter_mbox (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *driver</code></em>,
522
517
<em class="parameter"><code>const <span class="type">gchar</span> *mbox</code></em>,
526
521
Filters an mbox file based on rules defined in the FilterDriver
527
522
object. Is more efficient as it doesn't need to open the folder
528
through Camel directly.</p>
523
through Camel directly.
529
525
<div class="variablelist"><table border="0">
530
526
<col align="left" valign="top">
558
<div class="refsect2" lang="en">
554
<div class="refsect2" title="camel_filter_driver_filter_folder ()">
559
555
<a name="camel-filter-driver-filter-folder"></a><h3>camel_filter_driver_filter_folder ()</h3>
560
556
<pre class="programlisting"><span class="returnvalue">gint</span> camel_filter_driver_filter_folder (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *driver</code></em>,
561
557
<em class="parameter"><code><a class="link" href="camel-CamelFolder.html#CamelFolder" title="struct CamelFolder"><span class="type">CamelFolder</span></a> *folder</code></em>,
565
561
<em class="parameter"><code><a class="link" href="camel-camel-exception.html#CamelException" title="struct CamelException"><span class="type">CamelException</span></a> *ex</code></em>);</pre>
567
563
Filters a folder based on rules defined in the FilterDriver
569
566
<div class="variablelist"><table border="0">
570
567
<col align="left" valign="top">
613
<div class="refsect2" lang="en">
614
<a name="camel-filter-driver-expand-option"></a><h3>camel_filter_driver_expand_option ()</h3>
615
<pre class="programlisting"><span class="returnvalue">void</span> camel_filter_driver_expand_option (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
616
<em class="parameter"><code><span class="type">GString</span> *s</code></em>,
617
<em class="parameter"><code><span class="type">GString</span> *action</code></em>,
618
<em class="parameter"><code><span class="type">struct filter_option</span> *op</code></em>);</pre>
621
<div class="variablelist"><table border="0">
622
<col align="left" valign="top">
625
<td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
630
<td><p><span class="term"><em class="parameter"><code>s</code></em> :</span></p></td>
635
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
640
<td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
648
<div class="refsect2" lang="en">
649
<a name="camel-filter-driver-rule-count"></a><h3>camel_filter_driver_rule_count ()</h3>
650
<pre class="programlisting"><span class="returnvalue">gint</span> camel_filter_driver_rule_count (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>);</pre>
653
<div class="variablelist"><table border="0">
654
<col align="left" valign="top">
657
<td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
662
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
670
<div class="refsect2" lang="en">
671
<a name="camel-filter-driver-rule-get"></a><h3>camel_filter_driver_rule_get ()</h3>
672
<pre class="programlisting">struct <span class="returnvalue">filter_option</span> * camel_filter_driver_rule_get (<em class="parameter"><code><a class="link" href="camel-CamelFilterDriver.html#CamelFilterDriver" title="struct CamelFilterDriver"><span class="type">CamelFilterDriver</span></a> *d</code></em>,
673
<em class="parameter"><code><span class="type">gint</span> n</code></em>);</pre>
676
<div class="variablelist"><table border="0">
677
<col align="left" valign="top">
680
<td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
685
<td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
690
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
699
611
<div class="footer">