aboutsummaryrefslogtreecommitdiffhomepage
path: root/crates/shirabe-external-packages/src/symfony/string/unicode_string.rs
blob: e4158466644fb7bfb75e31ebd9d0f5906e654067 (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
49
50
51
52
53
54
55
56
//! ref: composer/vendor/symfony/string/UnicodeString.php

#[derive(Debug, Clone)]
pub struct UnicodeString {
    pub(crate) string: String,
}

impl UnicodeString {
    // TODO(phase-c): the real constructor runs `normalizer_normalize` (Unicode NFC normalization),
    // which has no Rust std equivalent and would need a dedicated normalization implementation.
    // Normalization is skipped here, which is only correct for already-NFC input such as ASCII.
    pub fn new(string: &str) -> Self {
        Self {
            string: string.to_string(),
        }
    }

    // TODO(phase-c): ASCII-only provisional implementation. The faithful `width()` uses `wcswidth`
    // with the Unicode width tables to treat wide characters as width 2 and skip zero-width /
    // combining characters; here every character counts as width 1, correct only for ASCII. The
    // ANSI/control-character stripping driven by `ignore_ansi_decoration` is likewise not handled.
    pub fn width(&self, _ignore_ansi_decoration: bool) -> i64 {
        let s = self.string.replace(['\x00', '\x05', '\x07'], "");
        let s = s.replace("\r\n", "\n").replace('\r', "\n");

        let mut width: i64 = 0;
        for line in s.split('\n') {
            let line_width = line.chars().count() as i64;
            if line_width > width {
                width = line_width;
            }
        }

        width
    }

    // TODO(phase-d): the faithful `length()` uses `grapheme_strlen` (extended grapheme clusters),
    // which needs Unicode segmentation tables with no Rust std equivalent and no permitted crate.
    // Approximated with the code-point count, exact only when no combining/multi-code-point
    // clusters are present (e.g. ASCII).
    pub fn length(&self) -> i64 {
        shirabe_php_shim::mb_strlen(&self.string, "UTF-8")
    }

    // TODO(phase-d): the faithful `slice()` uses `grapheme_substr` (grapheme-cluster offsets), which
    // needs Unicode segmentation tables with no std equivalent and no permitted crate. Approximated
    // with code-point offsets via `mb_substr`, exact only without combining/multi-code-point clusters.
    pub fn slice(&self, start: i64, length: Option<i64>) -> Self {
        Self::new(&shirabe_php_shim::mb_substr(
            &self.string,
            start,
            length,
            Some("UTF-8"),
        ))
    }
}