glib-data-checksums.html

最新gtk中文资料集

<td> the <a class="link" href="glib-Data-Checksums.html#GChecksum"><span class="type">GChecksum</span></a> to copy
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the copy of the passed <a class="link" href="glib-Data-Checksums.html#GChecksum"><span class="type">GChecksum</span></a>. Use <a class="link" href="glib-Data-Checksums.html#g-checksum-free"><code class="function">g_checksum_free()</code></a>
  when finished using it.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.16
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3028295"></a><h3>
<a name="g-checksum-free"></a>g_checksum_free ()</h3>
<a class="indexterm" name="id3028310"></a><pre class="programlisting">void                g_checksum_free                     (<a class="link" href="glib-Data-Checksums.html#GChecksum">GChecksum</a> *checksum);</pre>
<p>
Frees the memory allocated for <em class="parameter"><code>checksum</code></em>.</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>checksum</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Data-Checksums.html#GChecksum"><span class="type">GChecksum</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.16
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3028381"></a><h3>
<a name="g-checksum-update"></a>g_checksum_update ()</h3>
<a class="indexterm" name="id3028396"></a><pre class="programlisting">void                g_checksum_update                   (<a class="link" href="glib-Data-Checksums.html#GChecksum">GChecksum</a> *checksum,
                                                         const <a class="link" href="glib-Basic-Types.html#guchar">guchar</a> *data,
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> length);</pre>
<p>
Feeds <em class="parameter"><code>data</code></em> into an existing <a class="link" href="glib-Data-Checksums.html#GChecksum"><span class="type">GChecksum</span></a>. The checksum must still be
open, that is <a class="link" href="glib-Data-Checksums.html#g-checksum-get-string"><code class="function">g_checksum_get_string()</code></a> or <a class="link" href="glib-Data-Checksums.html#g-checksum-get-digest"><code class="function">g_checksum_get_digest()</code></a> must
not have been called on <em class="parameter"><code>checksum</code></em>.</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>checksum</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Data-Checksums.html#GChecksum"><span class="type">GChecksum</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> buffer used to compute the checksum
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></p></td>
<td> size of the buffer, or -1 if it is a null-terminated string.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.16
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3028548"></a><h3>
<a name="g-checksum-get-string"></a>g_checksum_get_string ()</h3>
<a class="indexterm" name="id3028563"></a><pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*        g_checksum_get_string               (<a class="link" href="glib-Data-Checksums.html#GChecksum">GChecksum</a> *checksum);</pre>
<p>
Gets the digest as an hexadecimal string.
</p>
<p>
Once this function has been called the <a class="link" href="glib-Data-Checksums.html#GChecksum"><span class="type">GChecksum</span></a> can no longer be
updated with <a class="link" href="glib-Data-Checksums.html#g-checksum-update"><code class="function">g_checksum_update()</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>checksum</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Data-Checksums.html#GChecksum"><span class="type">GChecksum</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the hexadecimal representation of the checksum. The
  returned string is owned by the checksum and should not be modified
  or freed.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.16
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3028665"></a><h3>
<a name="g-checksum-get-digest"></a>g_checksum_get_digest ()</h3>
<a class="indexterm" name="id3028680"></a><pre class="programlisting">void                g_checksum_get_digest               (<a class="link" href="glib-Data-Checksums.html#GChecksum">GChecksum</a> *checksum,
                                                         <a class="link" href="glib-Basic-Types.html#guint8">guint8</a> *buffer,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> *digest_len);</pre>
<p>
Gets the digest from <em class="parameter"><code>checksum</code></em> as a raw binary vector and places it
into <em class="parameter"><code>buffer</code></em>. The size of the digest depends on the type of checksum.
</p>
<p>
Once this function has been called, the <a class="link" href="glib-Data-Checksums.html#GChecksum"><span class="type">GChecksum</span></a> is closed and can
no longer be updated with <a class="link" href="glib-Data-Checksums.html#g-checksum-update"><code class="function">g_checksum_update()</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>checksum</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Data-Checksums.html#GChecksum"><span class="type">GChecksum</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>buffer</code></em>&#160;:</span></p></td>
<td> output buffer
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>digest_len</code></em>&#160;:</span></p></td>
<td> an inout parameter. The caller initializes it to the size of <em class="parameter"><code>buffer</code></em>.
  After the call it contains the length of the digest.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.16
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3028833"></a><h3>
<a name="g-compute-checksum-for-data"></a>g_compute_checksum_for_data ()</h3>
<a class="indexterm" name="id3028849"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_compute_checksum_for_data         (<a class="link" href="glib-Data-Checksums.html#GChecksumType">GChecksumType</a> checksum_type,
                                                         const <a class="link" href="glib-Basic-Types.html#guchar">guchar</a> *data,
                                                         <a class="link" href="glib-Basic-Types.html#gsize">gsize</a> length);</pre>
<p>
Computes the checksum for a binary <em class="parameter"><code>data</code></em> of <em class="parameter"><code>length</code></em>. This is a
convenience wrapper for <a class="link" href="glib-Data-Checksums.html#g-checksum-new"><code class="function">g_checksum_new()</code></a>, <a class="link" href="glib-Data-Checksums.html#g-checksum-get-string"><code class="function">g_checksum_get_string()</code></a>
and <a class="link" href="glib-Data-Checksums.html#g-checksum-free"><code class="function">g_checksum_free()</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>checksum_type</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Data-Checksums.html#GChecksumType"><span class="type">GChecksumType</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> binary blob to compute the digest of
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></p></td>
<td> 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> the digest of the binary data as a string in hexadecimal.
  The returned string should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when done using it.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.16
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3029031"></a><h3>
<a name="g-compute-checksum-for-string"></a>g_compute_checksum_for_string ()</h3>
<a class="indexterm" name="id3029047"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_compute_checksum_for_string       (<a class="link" href="glib-Data-Checksums.html#GChecksumType">GChecksumType</a> checksum_type,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *str,
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> length);</pre>
<p>
Computes the checksum of a string.</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>checksum_type</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Data-Checksums.html#GChecksumType"><span class="type">GChecksumType</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></p></td>
<td> the string to compute the checksum of
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></p></td>
<td> the length of the string, or -1 if the string is null-terminated.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the checksum as a hexadecimal string. The returned string
  should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when done using it.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.16
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3029181"></a><div class="refsect2" lang="en"><a name="id3029182"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id3029183"></a></div>
</div>
</div>
</body>
</html>