icu_experimental 0.5.0

ICU4X pre-release components under active development; all code in this crate is unstable.
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

// This file is part of ICU4X. For terms of use, please see the file
// called LICENSE at the top level of the ICU4X source tree
// (online at: https://github.com/unicode-org/icu4x/blob/main/LICENSE ).

//! Options for [`UnitsFormatter`](crate::dimension::units::formatter::UnitsFormatter).

/// A collection of configuration options that determine the formatting behavior of
/// [`UnitsFormatter`](crate::dimension::units::formatter::UnitsFormatter).
#[derive(Copy, Debug, Eq, PartialEq, Clone, Default)]
#[non_exhaustive]
pub struct UnitsFormatterOptions {
    /// The width of the units format.
    pub width: Width,
}

impl From<Width> for UnitsFormatterOptions {
    fn from(width: Width) -> Self {
        Self { width }
    }
}

#[derive(Debug, Eq, PartialEq, Clone, Copy, Default)]
#[non_exhaustive]
pub enum Width {
    /// Format the units with the long units format.
    ///
    /// For example, 1 hour formats as "1 hour" in en-US.
    Long,

    /// Format the units with the short units format.
    ///
    /// For example, 1 hour formats as "1 hr" in en-US.
    #[default]
    Short,

    /// Format the units with the narrow units format.
    ///
    /// The narrow symbol may be ambiguous, so it should be evident from context which
    /// units is being represented.
    ///
    /// For example, 1 hour formats as "1 h" in most locales.
    Narrow,
}

impl From<Width> for tinystr::TinyStr8 {
    fn from(width: Width) -> Self {
        match width {
            Width::Long => "long".parse().unwrap(),
            Width::Short => "short".parse().unwrap(),
            Width::Narrow => "narrow".parse().unwrap(),
        }
    }
}