libyaml 0.2.0

High-level bindings for the LibYAML library
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

use crate::sys;

/// Stream encoding.
#[derive(Copy, Clone, Debug, Eq, Hash, Ord, PartialEq, PartialOrd)]
#[repr(u8)]
pub enum Encoding {
    /// UTF-8.
    Utf8 = sys::YAML_UTF8_ENCODING as _,

    /// UTF-16-LE with BOM.
    Utf16Le = sys::YAML_UTF16LE_ENCODING as _,

    /// UTF-16-BE with BOM.
    Utf16Be = sys::YAML_UTF16BE_ENCODING as _,
}

impl Encoding {
    /// Convert from `yaml_encoding_t`; `YAML_ANY_ENCODING` becomes `None`.
    pub fn from_raw(raw: sys::yaml_encoding_t) -> Option<Self> {
        match raw {
            sys::YAML_UTF8_ENCODING => Some(Self::Utf8),
            sys::YAML_UTF16LE_ENCODING => Some(Self::Utf16Le),
            sys::YAML_UTF16BE_ENCODING => Some(Self::Utf16Be),
            _ => None,
        }
    }

    /// Convert to `yaml_encoding_t`.
    pub fn into_raw(self) -> sys::yaml_encoding_t {
        match self {
            Self::Utf8 => sys::YAML_UTF8_ENCODING,
            Self::Utf16Le => sys::YAML_UTF16LE_ENCODING,
            Self::Utf16Be => sys::YAML_UTF16BE_ENCODING,
        }
    }

    /// Convert to `yaml_encoding_t`; `None` becomes `YAML_ANY_ENCODING`.
    pub fn option_into_raw(value: Option<Self>) -> sys::yaml_encoding_t {
        value.map_or(sys::YAML_ANY_ENCODING, Self::into_raw)
    }
}