pango/
attr_list.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
// Take a look at the license at the top of the repository in the LICENSE file.

use std::mem;

use glib::translate::*;

use crate::{ffi, AttrList, Attribute};

impl AttrList {
    /// Insert the given attribute into the [`AttrList`][crate::AttrList].
    ///
    /// It will replace any attributes of the same type
    /// on that segment and be merged with any adjoining
    /// attributes that are identical.
    ///
    /// This function is slower than [`insert()`][Self::insert()]
    /// for creating an attribute list in order (potentially
    /// much slower for large lists). However,
    /// [`insert()`][Self::insert()] is not suitable for
    /// continually changing a set of attributes since it
    /// never removes or combines existing attributes.
    /// ## `attr`
    /// the attribute to insert
    #[doc(alias = "pango_attr_list_change")]
    pub fn change(&self, attr: impl Into<Attribute>) {
        unsafe {
            let attr = attr.into();
            ffi::pango_attr_list_change(self.to_glib_none().0, attr.to_glib_none().0);
            mem::forget(attr); //As attr transferred fully
        }
    }

    #[cfg(feature = "v1_46")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v1_46")))]
    #[doc(alias = "pango_attr_list_equal")]
    fn equal(&self, other_list: &AttrList) -> bool {
        unsafe {
            from_glib(ffi::pango_attr_list_equal(
                self.to_glib_none().0,
                other_list.to_glib_none().0,
            ))
        }
    }

    /// Insert the given attribute into the [`AttrList`][crate::AttrList].
    ///
    /// It will be inserted after all other attributes with a
    /// matching @start_index.
    /// ## `attr`
    /// the attribute to insert
    #[doc(alias = "pango_attr_list_insert")]
    pub fn insert(&self, attr: impl Into<Attribute>) {
        unsafe {
            let attr = attr.into();
            ffi::pango_attr_list_insert(self.to_glib_none().0, attr.to_glib_none().0);
            mem::forget(attr); //As attr transferred fully
        }
    }

    /// Insert the given attribute into the [`AttrList`][crate::AttrList].
    ///
    /// It will be inserted before all other attributes with a
    /// matching @start_index.
    /// ## `attr`
    /// the attribute to insert
    #[doc(alias = "pango_attr_list_insert_before")]
    pub fn insert_before(&self, attr: impl Into<Attribute>) {
        unsafe {
            let attr = attr.into();
            ffi::pango_attr_list_insert_before(self.to_glib_none().0, attr.to_glib_none().0);
            mem::forget(attr); //As attr transferred fully
        }
    }
}

#[cfg(feature = "v1_46")]
#[cfg_attr(docsrs, doc(cfg(feature = "v1_46")))]
impl PartialEq for AttrList {
    #[inline]
    fn eq(&self, other: &Self) -> bool {
        self.equal(other)
    }
}

#[cfg(feature = "v1_46")]
#[cfg_attr(docsrs, doc(cfg(feature = "v1_46")))]
impl Eq for AttrList {}

#[cfg(feature = "v1_50")]
#[cfg_attr(docsrs, doc(cfg(feature = "v1_50")))]
impl std::str::FromStr for AttrList {
    type Err = glib::BoolError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        Self::from_string(s)
    }
}