src/libstd/from_str.rs

   1 // Copyright 2012 The Rust Project Developers. See the COPYRIGHT
   2 // file at the top-level directory of this distribution and at
   3 // http://rust-lang.org/COPYRIGHT.
   4 //
   5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
   6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
   7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
   8 // option. This file may not be copied, modified, or distributed
   9 // except according to those terms.
  10
  11 //! The trait for types that can be created from strings
  12
  13 use option::Option;
  14
  15 /// A trait to abstract the idea of creating a new instance of a type from a
  16 /// string.
  17 pub trait FromStr {
  18     /// Parses a string `s` to return an optional value of this type. If the
  19     /// string is ill-formatted, the None is returned.
  20     fn from_str(s: &str) -> Option<Self>;
  21 }
  22
  23 /// A utility function that just calls FromStr::from_str
  24 pub fn from_str<A: FromStr>(s: &str) -> Option<A> {
  25     FromStr::from_str(s)
  26 }