← Back to branch summary

~kklimonda/ubuntu/natty/glibmm2.4/update

« back to all changes in this revision

Viewing changes to docs/reference/html/classGlib_1_1Checksum.html

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Moog
  • Date: 2009-07-15 13:45:53 UTC
  • mfrom: (1.2.36 upstream)
  • Revision ID: james.westby@ubuntu.com-20090715134553-beb700qg38132w31
Tags: 2.21.2-0ubuntu1
https://launchpad.net/bugs/399018
* New Upstream release: (LP: #399018):
  - 2.21.2:
    - Add OptionGroup::add_entry(.., double&)
    - Remove stray semicolons
    - Fix build with glib from master
    - wrap a couple added GDrive methods
    - Wrap g_drive_eject_with_operation() and related functions
    - implement GDrive::stop-button signal
    - implement Gio::InetAddress::get_native_size()
    - Implement Gio::Mount::mount/eject_with_operation()
    - implement Gio::Volume::eject_with_operation()
    - fix accidental bug in Gio::Drive::eject() that the compiler warned me about
    - implement Gio::VolumeMonitor::drive-stop-button
  - 2.21.1 (unstable):
    Glib:
     - Date: Constructor: Check for invalid dates.
     - Added Glib::ValueArray, for use in gstreamermm.
     - Added Glib::file_set_contents().
     - gmmproc:
       - Avoid problems with spaces in _DEFS() calls.
       - Improve guessing of the *_get_type() function names from enum names.
    Gio:
     - Cancellable: Added connect() and disconnect().
     - Added FileIOStream.
     - Added InetAddress.
     - Added Initable.
     - Added IOStream.
     - Added NetworkAddress.
     - Added NetworkService.
     - Added Resolver
     - Added Socket.
     - Added SocketAddress.
     - Added SocketConnectable.
     - Added SrvTarget.
     - File::load_contents() Added overload without the etag_out parameter.
* debian/control{.in}:
  - bump build-dep on libglib2.0-dev to >= 2.21.1
* debian/rules
  - bump SHVER-value to 2.21.2
* debian/watch
  - also look for unstable versions

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/html/classGlib_1_1Checksum.html
19
19
 
20
20
<!-- begin main content -->
21
21
<div id="content">
22
 
<!-- Generated by Doxygen 1.5.8 -->
 
22
<!-- Generated by Doxygen 1.5.9 -->
23
23
  <div class="navpath"><a class="el" href="namespaceGlib.html">Glib</a>::<a class="el" href="classGlib_1_1Checksum.html">Checksum</a>
24
24
  </div>
25
25
<div class="contents">
103
103
<p>
104
104
This is a generic API for computing checksums (or "digests") for a sequence of arbitrary bytes, using various hashing algorithms like MD5, SHA-1 and SHA-256. Checksums are commonly used in various environments and specifications.<p>
105
105
glibmm supports incremental checksums by calling <a class="el" href="classGlib_1_1Checksum.html#49c961d3ecf8a4c62bd2177c2e32ac79" title="Feeds data into an existing Checksum.">update()</a> as long as there's data available and then using <a class="el" href="classGlib_1_1Checksum.html#139a8bb447bb6617ffd0b3a2ef38808b" title="Gets the digest as an hexadecimal string.">get_string()</a> or <a class="el" href="classGlib_1_1Checksum.html#2dab438a05d0c74f25daea6c19af8f30" title="Gets the digest from checksum as a raw binary vector and places it into buffer.">get_digest()</a> to compute the checksum and return it either as a string in hexadecimal form, or as a raw sequence of bytes. To compute the checksum for binary blobs and NULL-terminated strings in one go, use the static <a class="el" href="classGlib_1_1Checksum.html#902b8dade7ce569804fa1819aaaa04d0" title="Computes the checksum for a binary data of length.">compute_checksum()</a> convenience functions().<p>
106
 
<dl compact><dt><b><a class="el" href="newin2p16s.html#_newin2p16s000001">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
 
106
<dl class="newin2p16s" compact><dt><b><a class="el" href="newin2p16s.html#_newin2p16s000001">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
107
107
<hr><h2>Constructor &amp; Destructor Documentation</h2>
108
108
<a class="anchor" name="218ef89e5467d6cb8b2687813b286ced"></a><!-- doxytag: member="Glib::Checksum::Checksum" ref="218ef89e5467d6cb8b2687813b286ced" args="()" -->
109
109
<div class="memitem">
301
301
  </table>
302
302
</dl>
303
303
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The digest of the binary data as a string in hexadecimal. The returned string should be freed with g_free() when done using it.</dd></dl>
304
 
<dl compact><dt><b><a class="el" href="newin2p16s.html#_newin2p16s000006">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
 
304
<dl class="newin2p16s" compact><dt><b><a class="el" href="newin2p16s.html#_newin2p16s000006">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
305
305
 
306
306
</div>
307
307
</div><p>
335
335
<p>
336
336
The size of the digest depends on the type of checksum.<p>
337
337
Once this function has been called, the <a class="el" href="classGlib_1_1Checksum.html" title="Computes the checksum for data.">Checksum</a> is closed and can no longer be updated with g_checksum_update().<p>
338
 
<dl compact><dt><b><a class="el" href="newin2p16s.html#_newin2p16s000004">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
 
338
<dl class="newin2p16s" compact><dt><b><a class="el" href="newin2p16s.html#_newin2p16s000004">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
339
339
<dl compact><dt><b>Parameters:</b></dt><dd>
340
340
  <table border="0" cellspacing="2" cellpadding="0">
341
341
    <tr><td valign="top"></td><td valign="top"><em>buffer</em>&nbsp;</td><td>Output buffer. </td></tr>
392
392
Gets the digest as an hexadecimal string. 
393
393
<p>
394
394
Once this function has been called the <a class="el" href="classGlib_1_1Checksum.html" title="Computes the checksum for data.">Checksum</a> can no longer be updated with g_checksum_update(). <dl class="return" compact><dt><b>Returns:</b></dt><dd>The hexadecimal representation of the checksum. The returned string is owned by the checksum and should not be modified or freed.</dd></dl>
395
 
<dl compact><dt><b><a class="el" href="newin2p16s.html#_newin2p16s000005">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
 
395
<dl class="newin2p16s" compact><dt><b><a class="el" href="newin2p16s.html#_newin2p16s000005">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
396
396
 
397
397
</div>
398
398
</div><p>
413
413
 
414
414
<p>
415
415
 
416
 
<p>References <a class="el" href="checksum_8h-source.html#l00072">gobject_</a>.</p>
 
416
<p>References <a class="el" href="checksum_8h_source.html#l00072">gobject_</a>.</p>
417
417
 
418
418
</div>
419
419
</div><p>
434
434
 
435
435
<p>
436
436
 
437
 
<p>References <a class="el" href="checksum_8h-source.html#l00072">gobject_</a>.</p>
 
437
<p>References <a class="el" href="checksum_8h_source.html#l00072">gobject_</a>.</p>
438
438
 
439
439
</div>
440
440
</div><p>
518
518
<p>
519
519
Resets the state of the <em>checksum</em> back to it's initial state. 
520
520
<p>
521
 
<dl compact><dt><b><a class="el" href="newin2p18s.html#_newin2p18s000001">Since glibmm 2.18:</a></b></dt><dd></dd></dl>
 
521
<dl class="newin2p18s" compact><dt><b><a class="el" href="newin2p18s.html#_newin2p18s000001">Since glibmm 2.18:</a></b></dt><dd></dd></dl>
522
522
 
523
523
</div>
524
524
</div><p>
579
579
Feeds <em>data</em> into an existing <a class="el" href="classGlib_1_1Checksum.html" title="Computes the checksum for data.">Checksum</a>. 
580
580
<p>
581
581
The checksum must still be open, that is g_checksum_get_string() or g_checksum_get_digest() must not have been called on <em>checksum</em>.<p>
582
 
<dl compact><dt><b><a class="el" href="newin2p16s.html#_newin2p16s000003">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
 
582
<dl class="newin2p16s" compact><dt><b><a class="el" href="newin2p16s.html#_newin2p16s000003">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
583
583
<dl compact><dt><b>Parameters:</b></dt><dd>
584
584
  <table border="0" cellspacing="2" cellpadding="0">
585
585
    <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>Buffer used to compute the checksum. </td></tr>
642
642
 
643
643
<p>
644
644
 
645
 
<p>Referenced by <a class="el" href="checksum_8h-source.html#l00065">gobj()</a>.</p>
 
645
<p>Referenced by <a class="el" href="checksum_8h_source.html#l00065">gobj()</a>.</p>
646
646
 
647
647
</div>
648
648
</div><p>
653
653
 
654
654
<hr><address><small>
655
655
Generated for glibmm 2.4 by <a href="http://www.doxygen.org/index.html">
656
 
Doxygen</a> 1.5.8 &copy;&nbsp;1997-2001</small></address>
 
656
Doxygen</a> 1.5.9 &copy;&nbsp;1997-2001</small></address>
657
657
</body>
658
658
</html>