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

#![doc = include_str!("../README.md")]

use cursive_core::utils::span::{SpannedStr, SpannedString};
use std::str::Chars;
use unicode_width::UnicodeWidthStr;

mod views;
mod funcs;
mod macros;

pub use views::*;
pub use funcs::*;

#[cfg(test)]
mod tests;

// cursive reexport for the macros
#[doc(hidden)]
pub use cursive_core as siv;

/// [`SpannedString`]: cursive_core::utils::span::SpannedString
/// [`SpannedStr`]: cursive_core::utils::span::SpannedStr
/// [`StyledString`]: cursive_core::utils::markup::StyledString
///
/// Extension trait for [`SpannedString`] and [`SpannedStr`]
///
/// These methods might be useful when working with [`StyledString`]s
pub trait SpannedStrExt<T>: Clone {
    /// The amount of UTF-8 characters in the source string
    fn char_len(&self) -> usize;

    /// Iterate over the characters in the source string
    ///
    /// Disclaimer: some special characters are actually multiple characters
    /// (like accented letters)
    fn chars(&self) -> Chars;

    /// Convert the [`SpannedStr`] back to a [`SpannedString`]
    fn to_spanned_string(&self) -> SpannedString<T>;

    /// Creates a [`SpannedStr`] reference from a [`SpannedString`]
    fn as_spanned_str(&self) -> SpannedStr<T>;
}

impl<T: Clone> SpannedStrExt<T> for SpannedString<T> {
    fn char_len(&self) -> usize { self.source().width() }
    fn chars(&self) -> Chars { self.source().chars() }
    fn to_spanned_string(&self) -> SpannedString<T> { self.clone() }
    fn as_spanned_str(&self) -> SpannedStr<T> { SpannedStr::new(self.source(), self.spans_raw()) }
}

impl<'a, T: Clone> SpannedStrExt<T> for SpannedStr<'a, T> {
    fn char_len(&self) -> usize { self.source().width() }
    fn chars(&self) -> Chars { self.source().chars() }
    fn to_spanned_string(&self) -> SpannedString<T> { SpannedString::with_spans(self.source(), self.spans_raw().to_vec()) }
    fn as_spanned_str(&self) -> SpannedStr<T> { SpannedStr::new(self.source(), self.spans_raw()) }
}