umya-spreadsheet 3.0.0

umya-spreadsheet is a library written in pure Rust to read and write xlsx file.
Documentation 
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

use std::{
    borrow::Cow,
    fmt::Write,
    io::Cursor,
};

use md5::Digest;
use quick_xml::Writer;

use super::TextElement;

#[derive(Clone, Default, Debug, PartialEq, PartialOrd)]
pub struct RichText {
    rich_text_elements: Vec<TextElement>,
}

impl RichText {
    #[inline]
    #[must_use]
    pub fn text(&self) -> Cow<'static, str> {
        let mut text = String::new();
        for rich_text_elements in &self.rich_text_elements {
            text = format!("{}{}", text, rich_text_elements.text());
        }
        text.into()
    }

    #[inline]
    #[must_use]
    #[deprecated(since = "3.0.0", note = "Use text()")]
    pub fn get_text(&self) -> Cow<'static, str> {
        self.text()
    }

    #[inline]
    pub fn set_text<S: Into<String>>(&mut self, value: S) -> &mut Self {
        self.rich_text_elements.clear();
        let mut text_element = TextElement::default();
        text_element.set_text(value);
        self.add_rich_text_elements(text_element);
        self
    }

    #[inline]
    #[must_use]
    pub fn rich_text_elements(&self) -> &[TextElement] {
        &self.rich_text_elements
    }

    #[inline]
    #[must_use]
    #[deprecated(since = "3.0.0", note = "Use rich_text_elements()")]
    pub fn get_rich_text_elements(&self) -> &[TextElement] {
        self.rich_text_elements()
    }

    #[inline]
    pub fn rich_text_elements_mut(&mut self) -> &mut Vec<TextElement> {
        &mut self.rich_text_elements
    }

    #[inline]
    #[deprecated(since = "3.0.0", note = "Use rich_text_elements_mut()")]
    pub fn get_rich_text_elements_mut(&mut self) -> &mut Vec<TextElement> {
        self.rich_text_elements_mut()
    }

    #[inline]
    pub fn set_rich_text_elements(&mut self, value: impl Into<Vec<TextElement>>) -> &mut Self {
        self.rich_text_elements = value.into();
        self
    }

    #[inline]
    pub fn add_rich_text_elements(&mut self, value: TextElement) -> &mut Self {
        self.rich_text_elements.push(value);
        self
    }

    pub(crate) fn hash_code(&self) -> String {
        let mut value = String::new();
        for ele in &self.rich_text_elements {
            write!(value, "{}", ele.hash_code()).unwrap();
        }
        format!("{:x}", md5::Md5::digest(&value))
    }

    #[deprecated(since = "3.0.0", note = "Use hash_code()")]
    pub(crate) fn get_hash_code(&self) -> String {
        self.hash_code()
    }

    #[inline]
    pub(crate) fn write_to(&self, writer: &mut Writer<Cursor<Vec<u8>>>) {
        // r
        for obj in &self.rich_text_elements {
            obj.write_to(writer);
        }
    }
}