glib/auto/
checksum.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// DO NOT EDIT

use crate::{ffi, translate::*, ChecksumType};

crate::wrapper! {
    /// GLib provides 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.
    ///
    /// To create a new `GChecksum`, use `GLib::Checksum::new()`. To free
    /// a `GChecksum`, use `GLib::Checksum::free()`.
    ///
    /// GLib supports incremental checksums using the `GChecksum` data
    /// structure, by calling [`update()`][Self::update()] as long as there’s data
    /// available and then using [`string()`][Self::string()] or
    /// [`digest()`][Self::digest()] 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 nul-terminated strings in
    /// one go, use the convenience functions [`compute_checksum_for_data()`][crate::compute_checksum_for_data()]
    /// and `compute_checksum_for_string()`, respectively.
    // rustdoc-stripper-ignore-next-stop
    /// GLib provides 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.
    ///
    /// To create a new `GChecksum`, use `GLib::Checksum::new()`. To free
    /// a `GChecksum`, use `GLib::Checksum::free()`.
    ///
    /// GLib supports incremental checksums using the `GChecksum` data
    /// structure, by calling [`update()`][Self::update()] as long as there’s data
    /// available and then using [`string()`][Self::string()] or
    /// [`digest()`][Self::digest()] 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 nul-terminated strings in
    /// one go, use the convenience functions [`compute_checksum_for_data()`][crate::compute_checksum_for_data()]
    /// and `compute_checksum_for_string()`, respectively.
    #[derive(Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
    pub struct Checksum(Boxed<ffi::GChecksum>);

    match fn {
        copy => |ptr| ffi::g_checksum_copy(ptr),
        free => |ptr| ffi::g_checksum_free(ptr),
        type_ => || ffi::g_checksum_get_type(),
    }
}

impl Checksum {
    /// Creates a new #GChecksum, using the checksum algorithm @checksum_type.
    /// If the @checksum_type is not known, [`None`] 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.
    /// ## `checksum_type`
    /// the desired type of checksum
    ///
    /// # Returns
    ///
    /// the newly created #GChecksum, or [`None`].
    ///   Use g_checksum_free() to free the memory allocated by it.
    // rustdoc-stripper-ignore-next-stop
    /// Creates a new #GChecksum, using the checksum algorithm @checksum_type.
    /// If the @checksum_type is not known, [`None`] 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.
    /// ## `checksum_type`
    /// the desired type of checksum
    ///
    /// # Returns
    ///
    /// the newly created #GChecksum, or [`None`].
    ///   Use g_checksum_free() to free the memory allocated by it.
    #[doc(alias = "g_checksum_new")]
    pub fn new(checksum_type: ChecksumType) -> Option<Checksum> {
        unsafe { from_glib_full(ffi::g_checksum_new(checksum_type.into_glib())) }
    }

    /// Resets the state of the @self back to its initial state.
    // rustdoc-stripper-ignore-next-stop
    /// Resets the state of the @self back to its initial state.
    #[doc(alias = "g_checksum_reset")]
    pub fn reset(&mut self) {
        unsafe {
            ffi::g_checksum_reset(self.to_glib_none_mut().0);
        }
    }

    /// 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 @self.
    /// ## `data`
    /// buffer used to compute the checksum
    // rustdoc-stripper-ignore-next-stop
    /// 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 @self.
    /// ## `data`
    /// buffer used to compute the checksum
    #[doc(alias = "g_checksum_update")]
    pub fn update(&mut self, data: &[u8]) {
        let length = data.len() as _;
        unsafe {
            ffi::g_checksum_update(self.to_glib_none_mut().0, data.to_glib_none().0, length);
        }
    }

    /// Gets the length in bytes of digests of type @checksum_type
    /// ## `checksum_type`
    /// a #GChecksumType
    ///
    /// # Returns
    ///
    /// the checksum length, or -1 if @checksum_type is
    /// not supported.
    // rustdoc-stripper-ignore-next-stop
    /// Gets the length in bytes of digests of type @checksum_type
    /// ## `checksum_type`
    /// a #GChecksumType
    ///
    /// # Returns
    ///
    /// the checksum length, or -1 if @checksum_type is
    /// not supported.
    #[doc(alias = "g_checksum_type_get_length")]
    pub fn type_get_length(checksum_type: ChecksumType) -> isize {
        unsafe { ffi::g_checksum_type_get_length(checksum_type.into_glib()) }
    }
}

unsafe impl Send for Checksum {}
unsafe impl Sync for Checksum {}