4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>CamelAddress</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
7
7
<link rel="home" href="index.html" title="Camel Reference Manual">
8
8
<link rel="up" href="Addresses.html" title="Addresses">
9
9
<link rel="prev" href="Addresses.html" title="Addresses">
10
10
<link rel="next" href="camel-CamelInternetAddress.html" title="CamelInternetAddress">
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.12 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="part" href="classes.html" title="Part I. Camel Classes">
14
14
<link rel="chapter" href="ClassTree.html" title="Class Hierarchy">
54
54
</tr></table></div>
55
55
<div class="refsynopsisdiv">
56
56
<a name="camel-CamelAddress.synopsis"></a><h2>Synopsis</h2>
57
<pre class="synopsis">
58
struct <a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a>;
57
<pre class="synopsis">struct <a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a>;
59
58
<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> * <a class="link" href="camel-CamelAddress.html#camel-address-new" title="camel_address_new ()">camel_address_new</a> (void);
60
59
<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> * <a class="link" href="camel-CamelAddress.html#camel-address-new-clone" title="camel_address_new_clone ()">camel_address_new_clone</a> (const <a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);
62
href="../glib/glib-Basic-Types.html#gint"
63
>gint</a> <a class="link" href="camel-CamelAddress.html#camel-address-length" title="camel_address_length ()">camel_address_length</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);
65
href="../glib/glib-Basic-Types.html#gint"
66
>gint</a> <a class="link" href="camel-CamelAddress.html#camel-address-decode" title="camel_address_decode ()">camel_address_decode</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr,
68
href="../glib/glib-Basic-Types.html#gchar"
71
href="../glib/glib-Basic-Types.html#gchar"
72
>gchar</a> * <a class="link" href="camel-CamelAddress.html#camel-address-encode" title="camel_address_encode ()">camel_address_encode</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);
74
href="../glib/glib-Basic-Types.html#gint"
75
>gint</a> <a class="link" href="camel-CamelAddress.html#camel-address-unformat" title="camel_address_unformat ()">camel_address_unformat</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr,
77
href="../glib/glib-Basic-Types.html#gchar"
80
href="../glib/glib-Basic-Types.html#gchar"
81
>gchar</a> * <a class="link" href="camel-CamelAddress.html#camel-address-format" title="camel_address_format ()">camel_address_format</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);
83
href="../glib/glib-Basic-Types.html#gint"
84
>gint</a> <a class="link" href="camel-CamelAddress.html#camel-address-cat" title="camel_address_cat ()">camel_address_cat</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *dest,
60
gint <a class="link" href="camel-CamelAddress.html#camel-address-length" title="camel_address_length ()">camel_address_length</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);
61
gint <a class="link" href="camel-CamelAddress.html#camel-address-decode" title="camel_address_decode ()">camel_address_decode</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr,
63
gchar * <a class="link" href="camel-CamelAddress.html#camel-address-encode" title="camel_address_encode ()">camel_address_encode</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);
64
gint <a class="link" href="camel-CamelAddress.html#camel-address-unformat" title="camel_address_unformat ()">camel_address_unformat</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr,
66
gchar * <a class="link" href="camel-CamelAddress.html#camel-address-format" title="camel_address_format ()">camel_address_format</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);
67
gint <a class="link" href="camel-CamelAddress.html#camel-address-cat" title="camel_address_cat ()">camel_address_cat</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *dest,
85
68
const <a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *source);
87
href="../glib/glib-Basic-Types.html#gint"
88
>gint</a> <a class="link" href="camel-CamelAddress.html#camel-address-copy" title="camel_address_copy ()">camel_address_copy</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *dest,
69
gint <a class="link" href="camel-CamelAddress.html#camel-address-copy" title="camel_address_copy ()">camel_address_copy</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *dest,
89
70
const <a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *source);
90
71
void <a class="link" href="camel-CamelAddress.html#camel-address-remove" title="camel_address_remove ()">camel_address_remove</a> (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr,
92
href="../glib/glib-Basic-Types.html#gint"
96
75
<div class="refsect1" lang="en">
158
133
<div class="refsect2" lang="en">
159
134
<a name="camel-address-length"></a><h3>camel_address_length ()</h3>
160
<pre class="programlisting"><a
161
href="../glib/glib-Basic-Types.html#gint"
162
>gint</a> camel_address_length (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);</pre>
135
<pre class="programlisting">gint camel_address_length (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);</pre>
164
137
Get the number of addresses stored in the address <em class="parameter"><code>addr</code></em>.</p>
167
138
<div class="variablelist"><table border="0">
168
139
<col align="left" valign="top">
184
155
<div class="refsect2" lang="en">
185
156
<a name="camel-address-decode"></a><h3>camel_address_decode ()</h3>
186
<pre class="programlisting"><a
187
href="../glib/glib-Basic-Types.html#gint"
188
>gint</a> camel_address_decode (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr,
190
href="../glib/glib-Basic-Types.html#gchar"
191
>gchar</a> *raw);</pre>
157
<pre class="programlisting">gint camel_address_decode (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr,
158
const gchar *raw);</pre>
193
160
Construct a new address from a raw address field.</p>
196
161
<div class="variablelist"><table border="0">
197
162
<col align="left" valign="top">
218
183
<div class="refsect2" lang="en">
219
184
<a name="camel-address-encode"></a><h3>camel_address_encode ()</h3>
220
<pre class="programlisting"><a
221
href="../glib/glib-Basic-Types.html#gchar"
222
>gchar</a> * camel_address_encode (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);</pre>
185
<pre class="programlisting">gchar * camel_address_encode (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);</pre>
224
187
Encode an address in a format suitable for a raw header.</p>
227
188
<div class="variablelist"><table border="0">
228
189
<col align="left" valign="top">
244
205
<div class="refsect2" lang="en">
245
206
<a name="camel-address-unformat"></a><h3>camel_address_unformat ()</h3>
246
<pre class="programlisting"><a
247
href="../glib/glib-Basic-Types.html#gint"
248
>gint</a> camel_address_unformat (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr,
250
href="../glib/glib-Basic-Types.html#gchar"
251
>gchar</a> *raw);</pre>
207
<pre class="programlisting">gint camel_address_unformat (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr,
208
const gchar *raw);</pre>
253
210
Attempt to convert a previously formatted and/or edited
254
211
address back into internal form.</p>
257
212
<div class="variablelist"><table border="0">
258
213
<col align="left" valign="top">
279
234
<div class="refsect2" lang="en">
280
235
<a name="camel-address-format"></a><h3>camel_address_format ()</h3>
281
<pre class="programlisting"><a
282
href="../glib/glib-Basic-Types.html#gchar"
283
>gchar</a> * camel_address_format (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);</pre>
236
<pre class="programlisting">gchar * camel_address_format (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr);</pre>
285
238
Format an address in a format suitable for display.</p>
288
239
<div class="variablelist"><table border="0">
289
240
<col align="left" valign="top">
305
256
<div class="refsect2" lang="en">
306
257
<a name="camel-address-cat"></a><h3>camel_address_cat ()</h3>
307
<pre class="programlisting"><a
308
href="../glib/glib-Basic-Types.html#gint"
309
>gint</a> camel_address_cat (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *dest,
258
<pre class="programlisting">gint camel_address_cat (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *dest,
310
259
const <a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *source);</pre>
312
261
Concatenate one address onto another. The addresses must
313
262
be of the same type.</p>
316
263
<div class="variablelist"><table border="0">
317
264
<col align="left" valign="top">
338
285
<div class="refsect2" lang="en">
339
286
<a name="camel-address-copy"></a><h3>camel_address_copy ()</h3>
340
<pre class="programlisting"><a
341
href="../glib/glib-Basic-Types.html#gint"
342
>gint</a> camel_address_copy (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *dest,
287
<pre class="programlisting">gint camel_address_copy (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *dest,
343
288
const <a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *source);</pre>
345
290
Copy the contents of one address into another.</p>
348
291
<div class="variablelist"><table border="0">
349
292
<col align="left" valign="top">
370
313
<div class="refsect2" lang="en">
371
314
<a name="camel-address-remove"></a><h3>camel_address_remove ()</h3>
372
315
<pre class="programlisting">void camel_address_remove (<a class="link" href="camel-CamelAddress.html#CamelAddress" title="struct CamelAddress">CamelAddress</a> *addr,
374
href="../glib/glib-Basic-Types.html#gint"
375
>gint</a> index);</pre>
377
318
Remove an address by index, or all addresses.</p>
380
319
<div class="variablelist"><table border="0">
381
320
<col align="left" valign="top">