summaryrefslogtreecommitdiffstats
path: root/intl/icu_capi/src/properties_iter.rs
blob: e0095789f545a3fb0018b7a54f648be64a54fdb4 (plain)
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
// 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]
pub mod ffi {
    use alloc::boxed::Box;
    use core::ops::RangeInclusive;

    /// Result of a single iteration of [`CodePointRangeIterator`].
    /// Logically can be considered to be an `Option<RangeInclusive<u32>>`,
    ///
    /// `start` and `end` represent an inclusive range of code points [start, end],
    /// and `done` will be true if the iterator has already finished. The last contentful
    /// iteration will NOT produce a range done=true, in other words `start` and `end` are useful
    /// values if and only if `done=false`.
    pub struct CodePointRangeIteratorResult {
        pub start: u32,
        pub end: u32,
        pub done: bool,
    }

    /// An iterator over code point ranges, produced by `ICU4XCodePointSetData` or
    /// one of the `ICU4XCodePointMapData` types
    #[diplomat::opaque]
    pub struct CodePointRangeIterator<'a>(pub Box<dyn Iterator<Item = RangeInclusive<u32>> + 'a>);

    impl<'a> CodePointRangeIterator<'a> {
        /// Advance the iterator by one and return the next range.
        ///
        /// If the iterator is out of items, `done` will be true
        #[allow(clippy::should_implement_trait)] // Rust isn't calling this code
        pub fn next(&mut self) -> CodePointRangeIteratorResult {
            self.0
                .next()
                .map(|r| CodePointRangeIteratorResult {
                    start: *r.start(),
                    end: *r.end(),
                    done: false,
                })
                .unwrap_or(CodePointRangeIteratorResult {
                    start: 0,
                    end: 0,
                    done: true,
                })
        }
    }
}