ps-str 0.1.0-5

String transcoding library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

mod variants;

/// Extension trait for encoding paths to UTF-8 strings.
///
/// This is a separate trait from [`Utf8Encoder`](crate::Utf8Encoder) due to Rust's coherence rules
/// preventing blanket implementations from coexisting with specific type implementations.
pub trait PathUtf8Encoder {
    /// Converts a path to a UTF-8 string, replacing invalid bytes with fallback characters.
    ///
    /// # Example
    ///
    /// ```
    /// use ps_str::PathUtf8Encoder;
    /// use std::path::Path;
    ///
    /// let path = Path::new("hello.txt");
    /// let encoded = path.to_utf8_string();
    /// assert_eq!(encoded, "hello.txt");
    /// ```
    fn to_utf8_string(&self) -> String;
}