Struct target_spec::TargetSpec

pub struct TargetSpec<'a> { /* fields omitted */ }

A parsed target specification or triple, as found in a Cargo.toml file.

Use the FromStr implementation or str::parse to obtain an instance.

Examples

use target_spec::{Platform, TargetFeatures, TargetSpec};

let i686_windows = Platform::new("i686-pc-windows-gnu", TargetFeatures::Unknown).unwrap();
let x86_64_mac = Platform::new("x86_64-apple-darwin", TargetFeatures::none()).unwrap();
let i686_linux = Platform::new(
    "i686-unknown-linux-gnu",
    TargetFeatures::features(["sse2"].iter().copied()),
).unwrap();

let spec: TargetSpec = "cfg(any(windows, target_arch = \"x86_64\"))".parse().unwrap();
assert_eq!(spec.eval(&i686_windows), Some(true), "i686 Windows");
assert_eq!(spec.eval(&x86_64_mac), Some(true), "x86_64 MacOS");
assert_eq!(spec.eval(&i686_linux), Some(false), "i686 Linux (should not match)");

let spec: TargetSpec = "cfg(any(target_feature = \"sse2\", target_feature = \"sse\"))".parse().unwrap();
assert_eq!(spec.eval(&i686_windows), None, "i686 Windows features are unknown");
assert_eq!(spec.eval(&x86_64_mac), Some(false), "x86_64 MacOS matches no features");
assert_eq!(spec.eval(&i686_linux), Some(true), "i686 Linux matches some features");

Implementations

impl<'a> TargetSpec<'a>

pub fn custom(target_info: &'a TargetInfo<'a>) -> Self

Creates a new exact, custom target spec to match against.

Note that this is for an exact target spec, similar to a triple specified, not an expression like cfg(windows).

Custom platforms are often found in embedded and similar environments. For built-in platforms, the FromStr implementation is recommended instead.

pub fn eval(&self, platform: &Platform<'_>) -> Option<bool>

Evaluates this specification against the given platform.

Returns Some(true) if there's a match, Some(false) if there's none, or None if the result of the evaluation is unknown (typically found if target features are involved).

Trait Implementations

impl<'a> Clone for TargetSpec<'a>

fn clone(&self) -> TargetSpec<'a>

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for TargetSpec<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromStr for TargetSpec<'static>

type Err = Error

The associated error which can be returned from parsing.

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

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