1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>GMimeMessagePartial</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GMime 2.6 Reference Manual">
8 <link rel="up" href="MimeParts.html" title="MIME Messages and Parts">
9 <link rel="prev" href="GMimeMessagePart.html" title="GMimeMessagePart">
10 <link rel="next" href="gmime-GMimePartIter.html" title="GMimePartIter">
11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17 <td><a accesskey="p" href="GMimeMessagePart.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="MimeParts.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GMime 2.6 Reference Manual</th>
21 <td><a accesskey="n" href="gmime-GMimePartIter.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#GMimeMessagePartial.synopsis" class="shortcut">Top</a>
26 <a href="#GMimeMessagePartial.description" class="shortcut">Description</a>
28 <a href="#GMimeMessagePartial.object-hierarchy" class="shortcut">Object Hierarchy</a>
31 <div class="refentry">
32 <a name="GMimeMessagePartial"></a><div class="titlepage"></div>
33 <div class="refnamediv"><table width="100%"><tr>
35 <h2><span class="refentrytitle"><a name="GMimeMessagePartial.top_of_page"></a>GMimeMessagePartial</span></h2>
36 <p>GMimeMessagePartial — Partial MIME parts</p>
38 <td valign="top" align="right"></td>
40 <div class="refsynopsisdiv">
41 <a name="GMimeMessagePartial.synopsis"></a><h2>Synopsis</h2>
42 <pre class="synopsis">struct <a class="link" href="GMimeMessagePartial.html#GMimeMessagePartial-struct" title="struct GMimeMessagePartial">GMimeMessagePartial</a>;
43 <a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="returnvalue">GMimeMessagePartial</span></a> * <a class="link" href="GMimeMessagePartial.html#g-mime-message-partial-new" title="g_mime_message_partial_new ()">g_mime_message_partial_new</a> (<em class="parameter"><code>const <span class="type">char</span> *id</code></em>,
44 <em class="parameter"><code><span class="type">int</span> number</code></em>,
45 <em class="parameter"><code><span class="type">int</span> total</code></em>);
46 const <span class="returnvalue">char</span> * <a class="link" href="GMimeMessagePartial.html#g-mime-message-partial-get-id" title="g_mime_message_partial_get_id ()">g_mime_message_partial_get_id</a> (<em class="parameter"><code><a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="type">GMimeMessagePartial</span></a> *partial</code></em>);
47 <span class="returnvalue">int</span> <a class="link" href="GMimeMessagePartial.html#g-mime-message-partial-get-number" title="g_mime_message_partial_get_number ()">g_mime_message_partial_get_number</a> (<em class="parameter"><code><a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="type">GMimeMessagePartial</span></a> *partial</code></em>);
48 <span class="returnvalue">int</span> <a class="link" href="GMimeMessagePartial.html#g-mime-message-partial-get-total" title="g_mime_message_partial_get_total ()">g_mime_message_partial_get_total</a> (<em class="parameter"><code><a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="type">GMimeMessagePartial</span></a> *partial</code></em>);
49 <a class="link" href="GMimeMessage.html" title="GMimeMessage"><span class="returnvalue">GMimeMessage</span></a> * <a class="link" href="GMimeMessagePartial.html#g-mime-message-partial-reconstruct-message" title="g_mime_message_partial_reconstruct_message ()">g_mime_message_partial_reconstruct_message</a>
50 (<em class="parameter"><code><a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="type">GMimeMessagePartial</span></a> **partials</code></em>,
51 <em class="parameter"><code><span class="type">size_t</span> num</code></em>);
52 <a class="link" href="GMimeMessage.html" title="GMimeMessage"><span class="returnvalue">GMimeMessage</span></a> ** <a class="link" href="GMimeMessagePartial.html#g-mime-message-partial-split-message" title="g_mime_message_partial_split_message ()">g_mime_message_partial_split_message</a>
53 (<em class="parameter"><code><a class="link" href="GMimeMessage.html" title="GMimeMessage"><span class="type">GMimeMessage</span></a> *message</code></em>,
54 <em class="parameter"><code><span class="type">size_t</span> max_size</code></em>,
55 <em class="parameter"><code><span class="type">size_t</span> *nparts</code></em>);
58 <div class="refsect1">
59 <a name="GMimeMessagePartial.object-hierarchy"></a><h2>Object Hierarchy</h2>
60 <pre class="synopsis">
62 +----<a class="link" href="GMimeObject.html" title="GMimeObject">GMimeObject</a>
63 +----<a class="link" href="GMimePart.html" title="GMimePart">GMimePart</a>
64 +----GMimeMessagePartial
67 <div class="refsect1">
68 <a name="GMimeMessagePartial.description"></a><h2>Description</h2>
70 A <a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="type">GMimeMessagePartial</span></a> represents the message/partial MIME part.
73 <div class="refsect1">
74 <a name="GMimeMessagePartial.details"></a><h2>Details</h2>
75 <div class="refsect2">
76 <a name="GMimeMessagePartial-struct"></a><h3>struct GMimeMessagePartial</h3>
77 <pre class="programlisting">struct GMimeMessagePartial;</pre>
79 A message/partial MIME part.
81 <div class="variablelist"><table border="0">
82 <col align="left" valign="top">
87 <div class="refsect2">
88 <a name="g-mime-message-partial-new"></a><h3>g_mime_message_partial_new ()</h3>
89 <pre class="programlisting"><a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="returnvalue">GMimeMessagePartial</span></a> * g_mime_message_partial_new (<em class="parameter"><code>const <span class="type">char</span> *id</code></em>,
90 <em class="parameter"><code><span class="type">int</span> number</code></em>,
91 <em class="parameter"><code><span class="type">int</span> total</code></em>);</pre>
93 Creates a new MIME message/partial object.
95 <div class="variablelist"><table border="0">
96 <col align="left" valign="top">
99 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
100 <td>message/partial part id</td>
103 <td><p><span class="term"><em class="parameter"><code>number</code></em> :</span></p></td>
104 <td>message/partial part number</td>
107 <td><p><span class="term"><em class="parameter"><code>total</code></em> :</span></p></td>
108 <td>total number of message/partial parts</td>
111 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
112 <td>an empty MIME message/partial object.</td>
118 <div class="refsect2">
119 <a name="g-mime-message-partial-get-id"></a><h3>g_mime_message_partial_get_id ()</h3>
120 <pre class="programlisting">const <span class="returnvalue">char</span> * g_mime_message_partial_get_id (<em class="parameter"><code><a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="type">GMimeMessagePartial</span></a> *partial</code></em>);</pre>
122 Gets the message/partial id parameter value.
124 <div class="variablelist"><table border="0">
125 <col align="left" valign="top">
128 <td><p><span class="term"><em class="parameter"><code>partial</code></em> :</span></p></td>
129 <td>message/partial object</td>
132 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
133 <td>the message/partial id or <code class="literal">NULL</code> on fail.</td>
139 <div class="refsect2">
140 <a name="g-mime-message-partial-get-number"></a><h3>g_mime_message_partial_get_number ()</h3>
141 <pre class="programlisting"><span class="returnvalue">int</span> g_mime_message_partial_get_number (<em class="parameter"><code><a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="type">GMimeMessagePartial</span></a> *partial</code></em>);</pre>
143 Gets the message/partial part number.
145 <div class="variablelist"><table border="0">
146 <col align="left" valign="top">
149 <td><p><span class="term"><em class="parameter"><code>partial</code></em> :</span></p></td>
150 <td>message/partial object</td>
153 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
154 <td>the message/partial part number or <code class="literal">-1</code> on fail.</td>
160 <div class="refsect2">
161 <a name="g-mime-message-partial-get-total"></a><h3>g_mime_message_partial_get_total ()</h3>
162 <pre class="programlisting"><span class="returnvalue">int</span> g_mime_message_partial_get_total (<em class="parameter"><code><a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="type">GMimeMessagePartial</span></a> *partial</code></em>);</pre>
164 Gets the total number of message/partial parts needed to
165 reconstruct the original message.
167 <div class="variablelist"><table border="0">
168 <col align="left" valign="top">
171 <td><p><span class="term"><em class="parameter"><code>partial</code></em> :</span></p></td>
172 <td>message/partial object</td>
175 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
176 <td>the total number of message/partial parts needed to
177 reconstruct the original message or -1 on fail.</td>
183 <div class="refsect2">
184 <a name="g-mime-message-partial-reconstruct-message"></a><h3>g_mime_message_partial_reconstruct_message ()</h3>
185 <pre class="programlisting"><a class="link" href="GMimeMessage.html" title="GMimeMessage"><span class="returnvalue">GMimeMessage</span></a> * g_mime_message_partial_reconstruct_message
186 (<em class="parameter"><code><a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="type">GMimeMessagePartial</span></a> **partials</code></em>,
187 <em class="parameter"><code><span class="type">size_t</span> num</code></em>);</pre>
189 Reconstructs the GMimeMessage from the given message/partial parts
190 in <em class="parameter"><code>partials</code></em>.
192 <div class="variablelist"><table border="0">
193 <col align="left" valign="top">
196 <td><p><span class="term"><em class="parameter"><code>partials</code></em> :</span></p></td>
197 <td>an array of message/partial mime parts</td>
200 <td><p><span class="term"><em class="parameter"><code>num</code></em> :</span></p></td>
201 <td>the number of elements in <em class="parameter"><code>partials</code></em>
205 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
206 <td>a GMimeMessage object on success or <code class="literal">NULL</code> on fail.</td>
212 <div class="refsect2">
213 <a name="g-mime-message-partial-split-message"></a><h3>g_mime_message_partial_split_message ()</h3>
214 <pre class="programlisting"><a class="link" href="GMimeMessage.html" title="GMimeMessage"><span class="returnvalue">GMimeMessage</span></a> ** g_mime_message_partial_split_message
215 (<em class="parameter"><code><a class="link" href="GMimeMessage.html" title="GMimeMessage"><span class="type">GMimeMessage</span></a> *message</code></em>,
216 <em class="parameter"><code><span class="type">size_t</span> max_size</code></em>,
217 <em class="parameter"><code><span class="type">size_t</span> *nparts</code></em>);</pre>
219 Splits <em class="parameter"><code>message</code></em> into an array of <a class="link" href="GMimeMessage.html" title="GMimeMessage"><span class="type">GMimeMessage</span></a> objects each
220 containing a single <a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="type">GMimeMessagePartial</span></a> object containing
221 <em class="parameter"><code>max_size</code></em> bytes or fewer. <em class="parameter"><code>nparts</code></em> is set to the number of
222 <a class="link" href="GMimeMessagePartial.html" title="GMimeMessagePartial"><span class="type">GMimeMessagePartial</span></a> objects created.
224 <div class="variablelist"><table border="0">
225 <col align="left" valign="top">
228 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
229 <td>message object</td>
232 <td><p><span class="term"><em class="parameter"><code>max_size</code></em> :</span></p></td>
236 <td><p><span class="term"><em class="parameter"><code>nparts</code></em> :</span></p></td>
237 <td>number of parts</td>
240 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
241 <td>an array of <a class="link" href="GMimeMessage.html" title="GMimeMessage"><span class="type">GMimeMessage</span></a> objects and sets <em class="parameter"><code>nparts</code></em> to th
242 number of messages returned or <code class="literal">NULL</code> on fail.</td>
251 Generated by GTK-Doc V1.18</div>