rustdoc_copy_macro 0.2.0

Macros for `rustdoc_copy`
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

//! Utility functions.

/// Returns `true` if the text has given circumfix.
pub(crate) fn surrounds_with(text: &str, circumfix: &str) -> bool {
    text.starts_with(circumfix) && text.ends_with(circumfix)
}

/// Returns a string slice with the optional circumfix removed.
///
/// This is substitute for nightly only [`str::trim_prefix`].
pub(crate) fn trim_circumfix<'a>(text: &'a str, circumfix: &'a str) -> &'a str {
    match surrounds_with(text, circumfix) {
        false => text,
        true => trim_prefix(trim_suffix(text, circumfix), circumfix),
    }
}

/// Returns a string slice with the optional prefix removed.
///
/// This is substitute for nightly only [`str::trim_prefix`].
pub(crate) fn trim_prefix<'a>(text: &'a str, prefix: &'a str) -> &'a str {
    text.strip_prefix(prefix).unwrap_or(text)
}

/// Returns a string slice with the optional suffix removed.
///
/// This is substitute for nightly only [`str::trim_suffix`].
pub(crate) fn trim_suffix<'a>(text: &'a str, prefix: &'a str) -> &'a str {
    text.strip_suffix(prefix).unwrap_or(text)
}