kvarn::prelude::utils::prelude::str

Trait FromStr

1.0.0 · source
pub trait FromStr: Sized {
    type Err;

    // Required method
    fn from_str(s: &str) -> Result<Self, Self::Err>;
}
Expand description

Parse a value from a string

FromStr’s from_str method is often used implicitly, through str’s parse method. See parse’s documentation for examples.

FromStr does not have a lifetime parameter, and so you can only parse types that do not contain a lifetime parameter themselves. In other words, you can parse an i32 with FromStr, but not a &i32. You can parse a struct that contains an i32, but not one that contains an &i32.

§Examples

Basic implementation of FromStr on an example Point type:

use std::str::FromStr;

#[derive(Debug, PartialEq)]
struct Point {
    x: i32,
    y: i32
}

#[derive(Debug, PartialEq, Eq)]
struct ParsePointError;

impl FromStr for Point {
    type Err = ParsePointError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        let (x, y) = s
            .strip_prefix('(')
            .and_then(|s| s.strip_suffix(')'))
            .and_then(|s| s.split_once(','))
            .ok_or(ParsePointError)?;

        let x_fromstr = x.parse::<i32>().map_err(|_| ParsePointError)?;
        let y_fromstr = y.parse::<i32>().map_err(|_| ParsePointError)?;

        Ok(Point { x: x_fromstr, y: y_fromstr })
    }
}

let expected = Ok(Point { x: 1, y: 2 });
// Explicit call
assert_eq!(Point::from_str("(1,2)"), expected);
// Implicit calls, through parse
assert_eq!("(1,2)".parse(), expected);
assert_eq!("(1,2)".parse::<Point>(), expected);
// Invalid input string
assert!(Point::from_str("(1 2)").is_err());

Required Associated Types§

1.0.0 · source

type Err

The associated error which can be returned from parsing.

Required Methods§

1.0.0 · source

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

If parsing succeeds, return the value inside Ok, otherwise when the string is ill-formatted return an error specific to the inside Err. The error type is specific to the implementation of the trait.

§Examples

Basic usage with i32, a type that implements FromStr:

use std::str::FromStr;

let s = "5";
let x = i32::from_str(s).unwrap();

assert_eq!(5, x);

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors§

source§

impl FromStr for ClientCachePreference

source§

impl FromStr for ServerCachePreference

1.7.0 · source§

impl FromStr for IpAddr

1.0.0 · source§

impl FromStr for SocketAddr

source§

impl FromStr for log::Level

source§

impl FromStr for log::LevelFilter

1.0.0 · source§

impl FromStr for bool

1.20.0 · source§

impl FromStr for char

1.0.0 · source§

impl FromStr for f32

1.0.0 · source§

impl FromStr for f64

1.0.0 · source§

impl FromStr for i8

1.0.0 · source§

impl FromStr for i16

1.0.0 · source§

impl FromStr for i32

1.0.0 · source§

impl FromStr for i64

1.0.0 · source§

impl FromStr for i128

1.0.0 · source§

impl FromStr for isize

1.0.0 · source§

impl FromStr for u8

1.0.0 · source§

impl FromStr for u16

1.0.0 · source§

impl FromStr for u32

1.0.0 · source§

impl FromStr for u64

1.0.0 · source§

impl FromStr for u128

1.0.0 · source§

impl FromStr for usize

source§

impl FromStr for Mime

§

impl FromStr for CompactString

§

impl FromStr for HeaderName

§

impl FromStr for HeaderValue

§

impl FromStr for Method

§

type Err = InvalidMethod

1.32.0 · source§

impl FromStr for PathBuf

§

impl FromStr for StatusCode

§

type Err = InvalidStatusCode

§

impl FromStr for Uri

1.35.0 · source§

impl FromStr for NonZero<i8>

1.35.0 · source§

impl FromStr for NonZero<i16>

1.35.0 · source§

impl FromStr for NonZero<i32>

1.35.0 · source§

impl FromStr for NonZero<i64>

1.35.0 · source§

impl FromStr for NonZero<i128>

1.35.0 · source§

impl FromStr for NonZero<isize>

1.35.0 · source§

impl FromStr for NonZero<u8>

1.35.0 · source§

impl FromStr for NonZero<u16>

1.35.0 · source§

impl FromStr for NonZero<u32>

1.35.0 · source§

impl FromStr for NonZero<u64>

1.35.0 · source§

impl FromStr for NonZero<u128>

1.35.0 · source§

impl FromStr for NonZero<usize>

1.0.0 · source§

impl FromStr for Ipv4Addr

1.0.0 · source§

impl FromStr for Ipv6Addr

1.5.0 · source§

impl FromStr for SocketAddrV4

1.5.0 · source§

impl FromStr for SocketAddrV6

§

impl FromStr for Authority

§

impl FromStr for PathAndQuery

§

impl FromStr for Scheme

source§

impl FromStr for CString

1.0.0 · source§

impl FromStr for String

Available on non-no_global_oom_handling only.
1.45.0 · source§

impl FromStr for OsString

source§

impl FromStr for Uuid

§

impl FromStr for Level

§

type Err = ParseLevelError

§

impl FromStr for LevelFilter

§

type Err = ParseLevelFilterError

§

impl FromStr for Month

§

type Err = InvalidVariant

§

impl FromStr for Protocol

§

type Err = InvalidProtocol

§

impl FromStr for Weekday

§

type Err = InvalidVariant

§

impl<S> FromStr for Ascii<S>
where S: FromStr,

§

type Err = <S as FromStr>::Err

§

impl<S> FromStr for UniCase<S>
where S: FromStr + AsRef<str>,

§

type Err = <S as FromStr>::Err

§

impl<const MIN: i8, const MAX: i8> FromStr for RangedI8<MIN, MAX>

§

type Err = ParseIntError

§

impl<const MIN: i16, const MAX: i16> FromStr for RangedI16<MIN, MAX>

§

type Err = ParseIntError

§

impl<const MIN: i32, const MAX: i32> FromStr for RangedI32<MIN, MAX>

§

type Err = ParseIntError

§

impl<const MIN: i64, const MAX: i64> FromStr for RangedI64<MIN, MAX>

§

type Err = ParseIntError

§

impl<const MIN: i128, const MAX: i128> FromStr for RangedI128<MIN, MAX>

§

type Err = ParseIntError

§

impl<const MIN: isize, const MAX: isize> FromStr for RangedIsize<MIN, MAX>

§

type Err = ParseIntError

§

impl<const MIN: u8, const MAX: u8> FromStr for RangedU8<MIN, MAX>

§

type Err = ParseIntError

§

impl<const MIN: u16, const MAX: u16> FromStr for RangedU16<MIN, MAX>

§

type Err = ParseIntError

§

impl<const MIN: u32, const MAX: u32> FromStr for RangedU32<MIN, MAX>

§

type Err = ParseIntError

§

impl<const MIN: u64, const MAX: u64> FromStr for RangedU64<MIN, MAX>

§

type Err = ParseIntError

§

impl<const MIN: u128, const MAX: u128> FromStr for RangedU128<MIN, MAX>

§

type Err = ParseIntError

§

impl<const MIN: usize, const MAX: usize> FromStr for RangedUsize<MIN, MAX>

§

type Err = ParseIntError