hydroperx-utf16 1.0.0

Work with UTF-16 in Rust
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

use crate::{slice::SliceIndex, Utf16CharIndices, Utf16Chars, Utf16Str, Utf16String};

impl Utf16Str {
    /// Returns the number of UTF-16 code units representing the string.
    #[inline]
    pub fn len(&self) -> usize {
        self.raw.len()
    }

    #[inline]
    pub fn as_ptr(&self) -> *const u16 {
        self.raw.as_ptr()
    }

    #[inline]
    pub fn as_mut_ptr(&mut self) -> *mut u16 {
        self.raw.as_mut_ptr()
    }

    pub unsafe fn from_utf16_unchecked(raw: &[u16]) -> &Self {
        unsafe { &*(raw as *const [u16] as *const Self) }
    }

    pub unsafe fn from_utf16_unchecked_mut(raw: &mut [u16]) -> &mut Self {
        unsafe { &mut *(raw as *mut [u16] as *mut Self) }
    }

    /// Iterates the UTF-16 code units.
    pub fn code_units(&self) -> std::slice::Iter<u16> {
        self.raw.iter()
    }

    /// Iterates the code points in the string.
    pub fn chars(&self) -> Utf16Chars {
        Utf16Chars {
            slice: self,
            index: 0,
        }
    }

    /// Iterates the indices and their code pointss in the string.
    pub fn char_indices(&self) -> Utf16CharIndices {
        Utf16CharIndices {
            slice: self,
            index: 0,
        }
    }

    #[inline]
    pub fn get<I: SliceIndex<Utf16Str>>(&self, index: I) -> Option<&<I as SliceIndex<Utf16Str>>::Output> {
        index.get(self)
    }

    #[inline]
    pub fn get_mut<I: SliceIndex<Utf16Str>>(&mut self, index: I) -> Option<&mut <I as SliceIndex<Utf16Str>>::Output> {
        index.get_mut(self)
    }

    #[inline]
    pub unsafe fn get_unchecked<I: SliceIndex<Utf16Str>>(&self, index: I) -> &<I as SliceIndex<Utf16Str>>::Output {
        unsafe { index.get_unchecked(self) }
    }

    #[inline]
    pub unsafe fn get_unchecked_mut<I: SliceIndex<Utf16Str>>(&mut self, index: I) -> &mut <I as SliceIndex<Utf16Str>>::Output {
        unsafe { index.get_unchecked_mut(self) }
    }

    #[inline]
    pub fn is_empty(&self) -> bool {
        self.raw.len() == 0
    }

    pub fn to_owned(&self) -> Utf16String {
        Utf16String {
            buf: self.raw.to_owned(),
        }
    }

    pub fn to_utf8(&self) -> String {
        let mut r = String::new();
        for ch in self.chars() {
            r.push(ch);
        }
        r
    }

    pub fn to_lowercase(&self) -> Utf16String {
        self.to_utf8().to_lowercase().into()
    }

    pub fn to_uppercase(&self) -> Utf16String {
        self.to_utf8().to_uppercase().into()
    }
}

impl std::ops::Index<usize> for Utf16Str {
    type Output = u16;

    fn index(&self, index: usize) -> &Self::Output {
        self.raw.get(index).expect("Reading position out of bounds of Utf16Str.")
    }
}