escpos 0.17.0

ESC/POS printer driver
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

//! Encoder used to encode text

use crate::errors::Result;
use encoding_rs::{Encoding, UTF_8};

/// Encoder
#[derive(Clone)]
pub struct Encoder {
    codec: &'static Encoding,
    allow_unencodable: bool,
}

impl Default for Encoder {
    fn default() -> Self {
        Encoder {
            codec: UTF_8,
            allow_unencodable: false,
        }
    }
}

impl Encoder {
    /// Create a new encoder
    pub fn new(codec: &'static Encoding) -> Self {
        Self {
            codec,
            allow_unencodable: false,
        }
    }

    /// Allow this encoder to succeed if the Unicode text that it's encoding
    /// can't be fully mapped to the output encoding.
    ///
    /// Defaults to `false`.
    ///
    /// The unmappable characters will be replaced with HTML numeric character
    /// references, as per the implementation of [`encoding_rs::Encoding::encode()`].
    pub fn allow_unencodable(mut self, yes: bool) -> Self {
        self.allow_unencodable = yes;
        self
    }

    /// Encode string into the right codec
    pub(crate) fn encode(&self, data: &str) -> Result<Vec<u8>> {
        let (output, _, unmappable) = self.codec.encode(data);
        if unmappable && !self.allow_unencodable {
            return Err(crate::errors::PrinterError::Input(format!(
                "invalid {}",
                self.codec.name()
            )));
        }
        Ok(output.into())
    }
}