Trait tor_hsservice::internal_prelude::FromStr

1.0.0 · source ·

pub(crate) 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);

Object Safety§

This trait is not object safe.

Implementors§

source §

type Err = ParseError

1.7.0 · source§

impl FromStr for IpAddr

§

type Err = AddrParseError

1.0.0 · source§

impl FromStr for SocketAddr

§

type Err = AddrParseError

source §

impl FromStr for log::Level

§

type Err = ParseLevelError

source §

impl FromStr for log::LevelFilter

§

type Err = ParseLevelError

source §

impl FromStr for serde_json::value::Value

§

type Err = Error

1.0.0 · source§

impl FromStr for bool

§

type Err = ParseBoolError

1.20.0 · source§

impl FromStr for char

§

type Err = ParseCharError

1.0.0 · source§

impl FromStr for f32

§

type Err = ParseFloatError

1.0.0 · source§

impl FromStr for f64

§

type Err = ParseFloatError

1.0.0 · source§

impl FromStr for i8

§

type Err = ParseIntError

1.0.0 · source§

impl FromStr for i16

§

type Err = ParseIntError

1.0.0 · source§

impl FromStr for i32

§

type Err = ParseIntError

1.0.0 · source§

impl FromStr for i64

§

type Err = ParseIntError

1.0.0 · source§

impl FromStr for i128

§

type Err = ParseIntError

1.0.0 · source§

impl FromStr for isize

§

type Err = ParseIntError

1.0.0 · source§

impl FromStr for u8

§

type Err = ParseIntError

1.0.0 · source§

impl FromStr for u16

§

type Err = ParseIntError

1.0.0 · source§

impl FromStr for u32

§

type Err = ParseIntError

1.0.0 · source§

impl FromStr for u64

§

type Err = ParseIntError

1.0.0 · source§

impl FromStr for u128

§

type Err = ParseIntError

1.0.0 · source§

impl FromStr for usize

§

type Err = ParseIntError

source §

impl FromStr for CountryCode

§

type Err = Error

source §

impl FromStr for OptionCc

§

type Err = Error

source §

impl FromStr for BridgeConfig

§

type Err = BridgeParseError

source §

impl FromStr for BridgeConfigBuilder

BridgeConfigBuilder parses the same way as BridgeConfig

§

type Err = BridgeParseError

source §

impl FromStr for ArtiPath

§

type Err = ArtiPathSyntaxError

source §

impl FromStr for KeystoreId

§

type Err = Error

source §

impl FromStr for Protocols

A Protocols set can be parsed from a string according to the format used in Tor consensus documents.

A protocols set is represented by a space-separated list of entries. Each entry is of the form Name=Versions, where Name is the name of a protocol, and Versions is a comma-separated list of version numbers and version ranges. Each version range is a pair of integers separated by -.

No protocol name may be listed twice. No version may be listed twice for a single protocol. All versions must be in range 0 through 63 inclusive.

§