icu_capi 2.0.2

C interface to ICU4X
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

// 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 ).

#[diplomat::bridge]
#[diplomat::abi_rename = "icu4x_{0}_mv1"]
#[diplomat::attr(auto, namespace = "icu4x")]
pub mod ffi {
    use alloc::boxed::Box;
    use diplomat_runtime::DiplomatStr;

    use crate::unstable::timezone::ffi::TimeZone;
    #[cfg(feature = "buffer_provider")]
    use crate::unstable::{errors::ffi::DataError, provider::ffi::DataProvider};

    /// A mapper between Windows time zone identifiers and BCP-47 time zone identifiers.
    ///
    /// This mapper supports two-way mapping, but it is optimized for the case of Windows to BCP-47.
    /// It also supports normalizing and canonicalizing the Windows strings.
    #[diplomat::opaque]
    #[diplomat::rust_link(icu::time::zone::windows::WindowsParser, Struct)]
    #[diplomat::rust_link(icu::time::zone::windows::WindowsParserBorrowed, Struct, hidden)]
    #[diplomat::rust_link(
        icu::time::zone::windows::WindowsParserBorrowed::new,
        FnInStruct,
        hidden
    )]
    pub struct WindowsParser(pub icu_time::zone::windows::WindowsParser);

    impl WindowsParser {
        /// Create a new [`WindowsParser`] using compiled data
        #[diplomat::rust_link(icu::time::zone::windows::WindowsParser::new, FnInStruct)]
        #[diplomat::attr(auto, constructor)]
        #[cfg(feature = "compiled_data")]
        pub fn create() -> Box<WindowsParser> {
            Box::new(WindowsParser(
                icu_time::zone::windows::WindowsParser::new().static_to_owned(),
            ))
        }

        /// Create a new [`WindowsParser`] using a particular data source
        #[diplomat::rust_link(icu::time::zone::windows::WindowsParser::new, FnInStruct)]
        #[diplomat::attr(all(supports = fallible_constructors, supports = named_constructors), named_constructor = "with_provider")]
        #[cfg(feature = "buffer_provider")]
        pub fn create_with_provider(
            provider: &DataProvider,
        ) -> Result<Box<WindowsParser>, DataError> {
            Ok(Box::new(WindowsParser(
                icu_time::zone::windows::WindowsParser::try_new_with_buffer_provider(
                    provider.get()?,
                )?,
            )))
        }

        #[diplomat::rust_link(icu::time::zone::windows::WindowsParserBorrowed::parse, FnInStruct)]
        #[diplomat::rust_link(
            icu::time::zone::windows::WindowsParserBorrowed::parse_from_utf8,
            FnInStruct,
            hidden
        )]
        pub fn parse(&self, value: &DiplomatStr, region: &DiplomatStr) -> Option<Box<TimeZone>> {
            self.0
                .as_borrowed()
                .parse_from_utf8(
                    value,
                    Some(icu_locale_core::subtags::Region::try_from_utf8(region).ok()?),
                )
                .map(TimeZone)
                .map(Box::new)
        }
    }
}