icu_capi/properties_iter.rs
1// This file is part of ICU4X. For terms of use, please see the file
2// called LICENSE at the top level of the ICU4X source tree
3// (online at: https://github.com/unicode-org/icu4x/blob/main/LICENSE ).
4
5#[diplomat::bridge]
6pub mod ffi {
7 use alloc::boxed::Box;
8 use core::ops::RangeInclusive;
9
10 /// Result of a single iteration of [`CodePointRangeIterator`].
11 /// Logically can be considered to be an `Option<RangeInclusive<u32>>`,
12 ///
13 /// `start` and `end` represent an inclusive range of code points [start, end],
14 /// and `done` will be true if the iterator has already finished. The last contentful
15 /// iteration will NOT produce a range done=true, in other words `start` and `end` are useful
16 /// values if and only if `done=false`.
17 #[diplomat::out]
18 pub struct CodePointRangeIteratorResult {
19 pub start: u32,
20 pub end: u32,
21 pub done: bool,
22 }
23
24 /// An iterator over code point ranges, produced by `ICU4XCodePointSetData` or
25 /// one of the `ICU4XCodePointMapData` types
26 #[diplomat::opaque]
27 pub struct CodePointRangeIterator<'a>(pub Box<dyn Iterator<Item = RangeInclusive<u32>> + 'a>);
28
29 impl<'a> CodePointRangeIterator<'a> {
30 /// Advance the iterator by one and return the next range.
31 ///
32 /// If the iterator is out of items, `done` will be true
33 pub fn next(&mut self) -> CodePointRangeIteratorResult {
34 self.0
35 .next()
36 .map(|r| CodePointRangeIteratorResult {
37 start: *r.start(),
38 end: *r.end(),
39 done: false,
40 })
41 .unwrap_or(CodePointRangeIteratorResult {
42 start: 0,
43 end: 0,
44 done: true,
45 })
46 }
47 }
48}