g_checksum_type_get_length ()

gssize
g_checksum_type_get_length (GChecksumType checksum_type);

Gets the length in bytes of digests of type checksum_type

Since: 2.16

g_checksum_new ()

GChecksum *
g_checksum_new (GChecksumType checksum_type);

Creates a new GChecksum, using the checksum algorithm checksum_type . If the checksum_type is not known, NULL is returned. A GChecksum can be used to compute the checksum, or digest, of an arbitrary binary blob, using different hashing algorithms.

A GChecksum works by feeding a binary blob through g_checksum_update() until there is data to be checked; the digest can then be extracted using g_checksum_get_string(), which will return the checksum as a hexadecimal string; or g_checksum_get_digest(), which will return a vector of raw bytes. Once either g_checksum_get_string() or g_checksum_get_digest() have been called on a GChecksum, the checksum will be closed and it won't be possible to call g_checksum_update() on it anymore.

Since: 2.16

g_checksum_copy ()

GChecksum *
g_checksum_copy (const GChecksum *checksum);

Copies a GChecksum. If checksum has been closed, by calling g_checksum_get_string() or g_checksum_get_digest(), the copied checksum will be closed as well.

Since: 2.16

g_checksum_free ()

void
g_checksum_free (GChecksum *checksum);

Frees the memory allocated for checksum .

Since: 2.16

g_checksum_reset ()

void
g_checksum_reset (GChecksum *checksum);

Resets the state of the checksum back to its initial state.

Since: 2.18

g_checksum_update ()

void
g_checksum_update (GChecksum *checksum,
                   const guchar *data,
                   gssize length);

Feeds data into an existing GChecksum. The checksum must still be open, that is g_checksum_get_string() or g_checksum_get_digest() must not have been called on checksum .

Since: 2.16

g_checksum_get_string ()

const gchar *
g_checksum_get_string (GChecksum *checksum);

Gets the digest as a hexadecimal string.

Once this function has been called the GChecksum can no longer be updated with g_checksum_update().

The hexadecimal characters will be lower case.

Since: 2.16

g_checksum_get_digest ()

void
g_checksum_get_digest (GChecksum *checksum,
                       guint8 *buffer,
                       gsize *digest_len);

Gets the digest from checksum as a raw binary vector and places it into buffer . The size of the digest depends on the type of checksum.

Once this function has been called, the GChecksum is closed and can no longer be updated with g_checksum_update().

[skip]

Since: 2.16

g_compute_checksum_for_data ()

gchar *
g_compute_checksum_for_data (GChecksumType checksum_type,
                             const guchar *data,
                             gsize length);

Computes the checksum for a binary data of length . This is a convenience wrapper for g_checksum_new(), g_checksum_get_string() and g_checksum_free().

The hexadecimal string returned will be in lower case.

Since: 2.16

g_compute_checksum_for_string ()

gchar *
g_compute_checksum_for_string (GChecksumType checksum_type,
                               const gchar *str,
                               gssize length);

Computes the checksum of a string.

The hexadecimal string returned will be in lower case.

Since: 2.16

g_compute_checksum_for_bytes ()

gchar *
g_compute_checksum_for_bytes (GChecksumType checksum_type,
                              GBytes *data);

Computes the checksum for a binary data . This is a convenience wrapper for g_checksum_new(), g_checksum_get_string() and g_checksum_free().

The hexadecimal string returned will be in lower case.

Since: 2.34

enum GChecksumType

The hashing algorithm to be used by GChecksum when performing the digest of some data.

Note that the GChecksumType enumeration may be extended at a later date to include new hashing algorithm types.

Since: 2.16

GChecksum

typedef struct _GChecksum GChecksum;

An opaque structure representing a checksumming operation.

To create a new GChecksum, use g_checksum_new(). To free a GChecksum, use g_checksum_free().

Since: 2.16