glib-base64-encoding.html

最新gtk中文资料集

                                                         <a class="link" href="glib-Basic-Types.html#gint">gint</a> *save);</pre>
<p>
Flush the status from a sequence of calls to <a class="link" href="glib-Base64-Encoding.html#g-base64-encode-step"><code class="function">g_base64_encode_step()</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>break_lines</code></em>&#160;:</span></p></td>
<td> whether to break long lines
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>out</code></em>&#160;:</span></p></td>
<td> pointer to destination buffer
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>state</code></em>&#160;:</span></p></td>
<td> Saved state from <a class="link" href="glib-Base64-Encoding.html#g-base64-encode-step"><code class="function">g_base64_encode_step()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>save</code></em>&#160;:</span></p></td>
<td> Saved state from <a class="link" href="glib-Base64-Encoding.html#g-base64-encode-step"><code class="function">g_base64_encode_step()</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The number of bytes of output that was written

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.12
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3025515"></a><h3>
<a name="g-base64-encode"></a>g_base64_encode ()</h3>
<a class="indexterm" name="id3025530"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_base64_encode                     (const <a class="link" href="glib-Basic-Types.html#guchar">guchar</a> *data,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> len);</pre>
<p>
Encode a sequence of binary data into its Base-64 stringified
representation.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> the binary data to encode
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
<td> the length of <em class="parameter"><code>data</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a newly allocated, zero-terminated Base-64 encoded
              string representing <em class="parameter"><code>data</code></em>. The returned string must 
              be freed with <a class="link" href="glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.12
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3025644"></a><h3>
<a name="g-base64-decode-step"></a>g_base64_decode_step ()</h3>
<a class="indexterm" name="id3025659"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gsize">gsize</a>               g_base64_decode_step                (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *in,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> len,
                                                         <a class="link" href="glib-Basic-Types.html#guchar">guchar</a> *out,
                                                         <a class="link" href="glib-Basic-Types.html#gint">gint</a> *state,
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> *save);</pre>
<p>
Incrementally decode a sequence of binary data from its Base-64 stringified
representation. By calling this function multiple times you can convert 
data in chunks to avoid having to have the full encoded data in memory.
</p>
<p>
The output buffer must be large enough to fit all the data that will
be written to it. Since base64 encodes 3 bytes in 4 chars you need
at least: <em class="parameter"><code>len</code></em> * 3 / 4 bytes.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>in</code></em>&#160;:</span></p></td>
<td> binary input data
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
<td> max length of <em class="parameter"><code>in</code></em> data to decode
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>out</code></em>&#160;:</span></p></td>
<td> output buffer
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>state</code></em>&#160;:</span></p></td>
<td> Saved state between steps, initialize to 0
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>save</code></em>&#160;:</span></p></td>
<td> Saved state between steps, initialize to 0
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The number of bytes of output that was written

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.12
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3025836"></a><h3>
<a name="g-base64-decode"></a>g_base64_decode ()</h3>
<a class="indexterm" name="id3025850"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guchar">guchar</a>*             g_base64_decode                     (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *text,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> *out_len);</pre>
<p>
Decode a sequence of Base-64 encoded text into binary data</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></p></td>
<td> zero-terminated string with base64 text to decode
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>out_len</code></em>&#160;:</span></p></td>
<td> The length of the decoded data is written here
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a newly allocated buffer containing the binary data
              that <em class="parameter"><code>text</code></em> represents. The returned buffer must
              be freed with <a class="link" href="glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.12
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3025960"></a><div class="refsect2" lang="en"><a name="id3025961"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id3025962"></a></div>
</div>
</div>
</body>
</html>