from-os-str 0.1.0

A macro that uses autoref based specialization to guess how to convert a &OsStr to a more useful type
Documentation
  • Coverage
  • 100%
    5 out of 5 items documented2 out of 3 items with examples
  • Size
  • Source code size: 11.8 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 1.6 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Links
  • aj-bagwell/from-os-str
    0 0 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • aj-bagwell

From OsStr

A macro to convert a &OsStr to a more useful types

Crates.io Crates.io License License Build Status

Dual-licensed under Apache 2.0 or MIT

About

A macro for trying to convert an &OsStr to another more usefull type There are lots of ways to do that and this will pick the best via autoref based specialization

e.g. a PathBuf will be created via From<OsString> not From<String> so non UTF8 paths will work.

It is most useful in other macros where you don't know the type you are converting to.

Example

use from_os_str::*;
use std::ffi::OsStr;
use std::path::Path;
let os_str = OsStr::new("123");
let path = try_from_os_str!(os_str as &Path);
assert_eq!(path, Ok(Path::new("123")));
let int = try_from_os_str!(os_str as u8);
assert_eq!(int, Ok(123));

Conversion Methods

It will use one of the following traits (in order of preferece) to convert the &OsStr to the type you want.

  • From<&OsStr>
  • From<&Path>
  • From
  • From<&str>
  • From
  • TryFrom<&OsStr>
  • TryFrom<&str>
  • FromStr