rune_alloc/string/
try_to_string.rs

Help
1//! String utilities.
2
3use core::fmt;
4
5use crate::error::Error;
6use crate::fmt::TryWrite;
7use crate::string::String;
8#[cfg(test)]
9use crate::testing::*;
10
11/// A trait for converting a value to a `String`.
12///
13/// This trait is automatically implemented for any type which implements the
14/// [`Display`] trait. As such, `ToString` shouldn't be implemented directly:
15/// [`Display`] should be implemented instead, and you get the `ToString`
16/// implementation for free.
17///
18/// [`Display`]: core::fmt::Display
19pub trait TryToString {
20    #[cfg(test)]
21    fn to_string(&self) -> String {
22        self.try_to_string().abort()
23    }
24
25    /// Converts the given value to a `String`.
26    ///
27    /// # Examples
28    ///
29    /// Basic usage:
30    ///
31    /// ```
32    /// use rune::alloc::String;
33    /// use rune::alloc::prelude::*;
34    ///
35    /// let i = 5;
36    /// let five = String::try_from("5")?;
37    ///
38    /// assert_eq!(five, i.try_to_string()?);
39    /// # Ok::<_, rune::alloc::Error>(())
40    /// ```
41    fn try_to_string(&self) -> Result<String, Error>;
42}
43
44impl<T> TryToString for T
45where
46    T: fmt::Display,
47{
48    #[inline]
49    fn try_to_string(&self) -> Result<String, Error> {
50        let mut s = String::new();
51        core::write!(s, "{}", self)?;
52        Ok(s)
53    }
54}
55
56impl TryToString for str {
57    #[inline]
58    fn try_to_string(&self) -> Result<String, Error> {
59        String::try_from(self)
60    }
61}
rune_alloc/string/try_to_string.rs

rune_alloc/string/
try_to_string.rs
