1
<refentry id="camel-CamelIMAPPStream">
3
<refentrytitle role="top_of_page" id="camel-CamelIMAPPStream.top_of_page">CamelIMAPPStream</refentrytitle>
4
<manvolnum>3</manvolnum>
5
<refmiscinfo>CAMEL Library</refmiscinfo>
9
<refname>CamelIMAPPStream</refname>
10
<refpurpose></refpurpose>
13
<refsynopsisdiv id="camel-CamelIMAPPStream.synopsis" role="synopsis">
14
<title role="synopsis.title">Synopsis</title>
17
<link linkend="CamelIMAPPStream">CamelIMAPPStream</link>;
18
enum <link linkend="camel-imapp-token-t">camel_imapp_token_t</link>;
19
<link linkend="CamelStream">CamelStream</link> * <link linkend="camel-imapp-stream-new">camel_imapp_stream_new</link> (<link linkend="CamelStream">CamelStream</link> *source);
20
<link linkend="camel-imapp-token-t">camel_imapp_token_t</link> <link linkend="camel-imapp-stream-token">camel_imapp_stream_token</link> (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
21
<link linkend="guchar">guchar</link> **start,
22
<link linkend="guint">guint</link> *len);
23
<link linkend="void">void</link> <link linkend="camel-imapp-stream-ungettoken">camel_imapp_stream_ungettoken</link> (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
24
<link linkend="camel-imapp-token-t">camel_imapp_token_t</link> tok,
25
<link linkend="guchar">guchar</link> *token,
26
<link linkend="guint">guint</link> len);
27
<link linkend="void">void</link> <link linkend="camel-imapp-stream-set-literal">camel_imapp_stream_set_literal</link> (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
28
<link linkend="guint">guint</link> literal);
29
<link linkend="gint">gint</link> <link linkend="camel-imapp-stream-gets">camel_imapp_stream_gets</link> (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
30
<link linkend="guchar">guchar</link> **start,
31
<link linkend="guint">guint</link> *len);
32
<link linkend="gint">gint</link> <link linkend="camel-imapp-stream-getl">camel_imapp_stream_getl</link> (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
33
<link linkend="guchar">guchar</link> **start,
34
<link linkend="guint">guint</link> *len);
35
<link linkend="gint">gint</link> <link linkend="camel-imapp-stream-atom">camel_imapp_stream_atom</link> (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
36
<link linkend="guchar">guchar</link> **start,
37
<link linkend="guint">guint</link> *len);
38
<link linkend="gint">gint</link> <link linkend="camel-imapp-stream-astring">camel_imapp_stream_astring</link> (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
39
<link linkend="guchar">guchar</link> **start);
40
<link linkend="gint">gint</link> <link linkend="camel-imapp-stream-nstring">camel_imapp_stream_nstring</link> (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
41
<link linkend="guchar">guchar</link> **start);
42
<link linkend="gint">gint</link> <link linkend="camel-imapp-stream-nstring-stream">camel_imapp_stream_nstring_stream</link> (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
43
<link linkend="CamelStream">CamelStream</link> **stream);
44
<link linkend="gint">gint</link> <link linkend="camel-imapp-stream-text">camel_imapp_stream_text</link> (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
45
<link linkend="guchar">guchar</link> **text);
46
<link linkend="guint32">guint32</link> <link linkend="camel-imapp-stream-number">camel_imapp_stream_number</link> (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is);
58
<refsect1 id="camel-CamelIMAPPStream.description" role="desc">
59
<title role="desc.title">Description</title>
64
<refsect1 id="camel-CamelIMAPPStream.details" role="details">
65
<title role="details.title">Details</title>
66
<refsect2 id="CamelIMAPPStream" role="struct">
67
<title>CamelIMAPPStream</title>
68
<indexterm zone="CamelIMAPPStream"><primary sortas="CamelIMAPPStream">CamelIMAPPStream</primary></indexterm><programlisting>typedef struct {
74
guchar *buf, *ptr, *end;
78
camel_imapp_token_t unget_tok;
82
guchar *tokenbuf, *tokenptr, *tokenend;
87
<refsect2 id="camel-imapp-token-t" role="enum">
88
<title>enum camel_imapp_token_t</title>
89
<indexterm zone="camel-imapp-token-t"><primary sortas="camel_imapp_token_t">camel_imapp_token_t</primary></indexterm><programlisting>typedef enum {
90
IMAP_TOK_PROTOCOL = -2,
96
} camel_imapp_token_t;
100
<refsect2 id="camel-imapp-stream-new" role="function">
101
<title>camel_imapp_stream_new ()</title>
102
<indexterm zone="camel-imapp-stream-new"><primary sortas="camel_imapp_stream_new">camel_imapp_stream_new</primary></indexterm><programlisting><link linkend="CamelStream">CamelStream</link> * camel_imapp_stream_new (<link linkend="CamelStream">CamelStream</link> *source);</programlisting>
104
Returns a NULL stream. A null stream is always at eof, and
105
always returns success for all reads and writes.</para>
107
</para><variablelist role="params">
108
<varlistentry><term><parameter>source</parameter> :</term>
110
</simpara></listitem></varlistentry>
111
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the stream
112
</simpara></listitem></varlistentry>
113
</variablelist></refsect2>
114
<refsect2 id="camel-imapp-stream-token" role="function">
115
<title>camel_imapp_stream_token ()</title>
116
<indexterm zone="camel-imapp-stream-token"><primary sortas="camel_imapp_stream_token">camel_imapp_stream_token</primary></indexterm><programlisting><link linkend="camel-imapp-token-t">camel_imapp_token_t</link> camel_imapp_stream_token (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
117
<link linkend="guchar">guchar</link> **start,
118
<link linkend="guint">guint</link> *len);</programlisting>
120
</para><variablelist role="params">
121
<varlistentry><term><parameter>is</parameter> :</term>
123
</simpara></listitem></varlistentry>
124
<varlistentry><term><parameter>start</parameter> :</term>
126
</simpara></listitem></varlistentry>
127
<varlistentry><term><parameter>len</parameter> :</term>
129
</simpara></listitem></varlistentry>
130
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
131
</simpara></listitem></varlistentry>
132
</variablelist></refsect2>
133
<refsect2 id="camel-imapp-stream-ungettoken" role="function">
134
<title>camel_imapp_stream_ungettoken ()</title>
135
<indexterm zone="camel-imapp-stream-ungettoken"><primary sortas="camel_imapp_stream_ungettoken">camel_imapp_stream_ungettoken</primary></indexterm><programlisting><link linkend="void">void</link> camel_imapp_stream_ungettoken (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
136
<link linkend="camel-imapp-token-t">camel_imapp_token_t</link> tok,
137
<link linkend="guchar">guchar</link> *token,
138
<link linkend="guint">guint</link> len);</programlisting>
140
</para><variablelist role="params">
141
<varlistentry><term><parameter>is</parameter> :</term>
143
</simpara></listitem></varlistentry>
144
<varlistentry><term><parameter>tok</parameter> :</term>
146
</simpara></listitem></varlistentry>
147
<varlistentry><term><parameter>token</parameter> :</term>
149
</simpara></listitem></varlistentry>
150
<varlistentry><term><parameter>len</parameter> :</term>
152
</simpara></listitem></varlistentry>
153
</variablelist></refsect2>
154
<refsect2 id="camel-imapp-stream-set-literal" role="function">
155
<title>camel_imapp_stream_set_literal ()</title>
156
<indexterm zone="camel-imapp-stream-set-literal"><primary sortas="camel_imapp_stream_set_literal">camel_imapp_stream_set_literal</primary></indexterm><programlisting><link linkend="void">void</link> camel_imapp_stream_set_literal (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
157
<link linkend="guint">guint</link> literal);</programlisting>
159
</para><variablelist role="params">
160
<varlistentry><term><parameter>is</parameter> :</term>
162
</simpara></listitem></varlistentry>
163
<varlistentry><term><parameter>literal</parameter> :</term>
165
</simpara></listitem></varlistentry>
166
</variablelist></refsect2>
167
<refsect2 id="camel-imapp-stream-gets" role="function">
168
<title>camel_imapp_stream_gets ()</title>
169
<indexterm zone="camel-imapp-stream-gets"><primary sortas="camel_imapp_stream_gets">camel_imapp_stream_gets</primary></indexterm><programlisting><link linkend="gint">gint</link> camel_imapp_stream_gets (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
170
<link linkend="guchar">guchar</link> **start,
171
<link linkend="guint">guint</link> *len);</programlisting>
173
</para><variablelist role="params">
174
<varlistentry><term><parameter>is</parameter> :</term>
176
</simpara></listitem></varlistentry>
177
<varlistentry><term><parameter>start</parameter> :</term>
179
</simpara></listitem></varlistentry>
180
<varlistentry><term><parameter>len</parameter> :</term>
182
</simpara></listitem></varlistentry>
183
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
184
</simpara></listitem></varlistentry>
185
</variablelist></refsect2>
186
<refsect2 id="camel-imapp-stream-getl" role="function">
187
<title>camel_imapp_stream_getl ()</title>
188
<indexterm zone="camel-imapp-stream-getl"><primary sortas="camel_imapp_stream_getl">camel_imapp_stream_getl</primary></indexterm><programlisting><link linkend="gint">gint</link> camel_imapp_stream_getl (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
189
<link linkend="guchar">guchar</link> **start,
190
<link linkend="guint">guint</link> *len);</programlisting>
192
</para><variablelist role="params">
193
<varlistentry><term><parameter>is</parameter> :</term>
195
</simpara></listitem></varlistentry>
196
<varlistentry><term><parameter>start</parameter> :</term>
198
</simpara></listitem></varlistentry>
199
<varlistentry><term><parameter>len</parameter> :</term>
201
</simpara></listitem></varlistentry>
202
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
203
</simpara></listitem></varlistentry>
204
</variablelist></refsect2>
205
<refsect2 id="camel-imapp-stream-atom" role="function">
206
<title>camel_imapp_stream_atom ()</title>
207
<indexterm zone="camel-imapp-stream-atom"><primary sortas="camel_imapp_stream_atom">camel_imapp_stream_atom</primary></indexterm><programlisting><link linkend="gint">gint</link> camel_imapp_stream_atom (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
208
<link linkend="guchar">guchar</link> **start,
209
<link linkend="guint">guint</link> *len);</programlisting>
211
</para><variablelist role="params">
212
<varlistentry><term><parameter>is</parameter> :</term>
214
</simpara></listitem></varlistentry>
215
<varlistentry><term><parameter>start</parameter> :</term>
217
</simpara></listitem></varlistentry>
218
<varlistentry><term><parameter>len</parameter> :</term>
220
</simpara></listitem></varlistentry>
221
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
222
</simpara></listitem></varlistentry>
223
</variablelist></refsect2>
224
<refsect2 id="camel-imapp-stream-astring" role="function">
225
<title>camel_imapp_stream_astring ()</title>
226
<indexterm zone="camel-imapp-stream-astring"><primary sortas="camel_imapp_stream_astring">camel_imapp_stream_astring</primary></indexterm><programlisting><link linkend="gint">gint</link> camel_imapp_stream_astring (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
227
<link linkend="guchar">guchar</link> **start);</programlisting>
229
</para><variablelist role="params">
230
<varlistentry><term><parameter>is</parameter> :</term>
232
</simpara></listitem></varlistentry>
233
<varlistentry><term><parameter>start</parameter> :</term>
235
</simpara></listitem></varlistentry>
236
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
237
</simpara></listitem></varlistentry>
238
</variablelist></refsect2>
239
<refsect2 id="camel-imapp-stream-nstring" role="function">
240
<title>camel_imapp_stream_nstring ()</title>
241
<indexterm zone="camel-imapp-stream-nstring"><primary sortas="camel_imapp_stream_nstring">camel_imapp_stream_nstring</primary></indexterm><programlisting><link linkend="gint">gint</link> camel_imapp_stream_nstring (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
242
<link linkend="guchar">guchar</link> **start);</programlisting>
244
</para><variablelist role="params">
245
<varlistentry><term><parameter>is</parameter> :</term>
247
</simpara></listitem></varlistentry>
248
<varlistentry><term><parameter>start</parameter> :</term>
250
</simpara></listitem></varlistentry>
251
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
252
</simpara></listitem></varlistentry>
253
</variablelist></refsect2>
254
<refsect2 id="camel-imapp-stream-nstring-stream" role="function">
255
<title>camel_imapp_stream_nstring_stream ()</title>
256
<indexterm zone="camel-imapp-stream-nstring-stream"><primary sortas="camel_imapp_stream_nstring_stream">camel_imapp_stream_nstring_stream</primary></indexterm><programlisting><link linkend="gint">gint</link> camel_imapp_stream_nstring_stream (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
257
<link linkend="CamelStream">CamelStream</link> **stream);</programlisting>
259
</para><variablelist role="params">
260
<varlistentry><term><parameter>is</parameter> :</term>
262
</simpara></listitem></varlistentry>
263
<varlistentry><term><parameter>stream</parameter> :</term>
265
</simpara></listitem></varlistentry>
266
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
267
</simpara></listitem></varlistentry>
268
</variablelist></refsect2>
269
<refsect2 id="camel-imapp-stream-text" role="function">
270
<title>camel_imapp_stream_text ()</title>
271
<indexterm zone="camel-imapp-stream-text"><primary sortas="camel_imapp_stream_text">camel_imapp_stream_text</primary></indexterm><programlisting><link linkend="gint">gint</link> camel_imapp_stream_text (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is,
272
<link linkend="guchar">guchar</link> **text);</programlisting>
274
</para><variablelist role="params">
275
<varlistentry><term><parameter>is</parameter> :</term>
277
</simpara></listitem></varlistentry>
278
<varlistentry><term><parameter>text</parameter> :</term>
280
</simpara></listitem></varlistentry>
281
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
282
</simpara></listitem></varlistentry>
283
</variablelist></refsect2>
284
<refsect2 id="camel-imapp-stream-number" role="function">
285
<title>camel_imapp_stream_number ()</title>
286
<indexterm zone="camel-imapp-stream-number"><primary sortas="camel_imapp_stream_number">camel_imapp_stream_number</primary></indexterm><programlisting><link linkend="guint32">guint32</link> camel_imapp_stream_number (<link linkend="CamelIMAPPStream">CamelIMAPPStream</link> *is);</programlisting>
288
</para><variablelist role="params">
289
<varlistentry><term><parameter>is</parameter> :</term>
291
</simpara></listitem></varlistentry>
292
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara>
293
</simpara></listitem></varlistentry>
294
</variablelist></refsect2>