roe 0.0.9

Unicode case conversion
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

use crate::unicode::ucd_generated_case_mapping::SORTED_TITLECASE_MAPPING;

/// Take a [`char`] and return its Unicode titlecase as 3 `char`s.
///
/// Trailing NUL bytes in the returned array should be ignored.
///
/// # Examples
///
/// ```
/// use roe::to_titlecase;
///
/// assert_eq!(to_titlecase('DŽ'), ['Dž', '\0', '\0']);
///
/// // Ligatures
/// assert_eq!(to_titlecase('ffl'), ['F', 'f', 'l']);
///
/// // Locale is ignored
/// assert_eq!(to_titlecase('i'), ['I', '\0', '\0']);
///
/// // A character already titlecased map to itself
/// assert_eq!(to_titlecase('A'), ['A', '\0', '\0']);
/// ```
#[allow(clippy::module_name_repetitions)]
#[must_use]
pub fn to_titlecase(c: char) -> [char; 3] {
    super::mapping::lookup_table(c, SORTED_TITLECASE_MAPPING)
}

#[cfg(test)]
mod tests {
    use alloc::vec::Vec;

    use super::to_titlecase;
    use crate::unicode::std_case_mapping_iter::CaseMappingIter;

    #[test]
    fn test_char_to_titlecase() {
        assert_eq!(
            CaseMappingIter::new(to_titlecase('ß')).collect::<Vec<_>>(),
            ['S', 's']
        );
        assert_eq!(
            CaseMappingIter::new(to_titlecase('DŽ')).collect::<Vec<_>>(),
            ['Dž']
        );
        assert_eq!(
            CaseMappingIter::new(to_titlecase('ffl')).collect::<Vec<_>>(),
            ['F', 'f', 'l']
        );
        assert_eq!(
            CaseMappingIter::new(to_titlecase('i')).collect::<Vec<_>>(),
            ['I']
        );
        assert_eq!(
            CaseMappingIter::new(to_titlecase('A')).collect::<Vec<_>>(),
            ['A']
        );
    }

    #[test]
    fn test_next_back() {
        let mut iter = CaseMappingIter::new(to_titlecase('ffl'));
        assert_eq!(iter.next_back(), Some('l'));
        assert_eq!(iter.next_back(), Some('f'));
        assert_eq!(iter.next_back(), Some('F'));
        assert_eq!(iter.next_back(), None);
    }
}