Struct target_tuples::Target

pub struct Target { /* private fields */ }

The representation of a target tuple.

A Target Tuple is of the form arch-vendor-system, where system can be either os-env or simply either os or env (the latter is used in the case of a freestanding target).

There are two types of target tuple: canonical and exact. This type can be used to represent both.

The core::fmt::Display implementation will display the canonical tuple; the function Self::get_name extracts the exact form that was parsed. In any case, if any field, other than vendor, is unknown, or the form is not the one above, the core::str::FromStr implementation will yield an UnknownError.

Implementations

impl Target

pub fn get_name(&self) -> &str

Gets the exact name of the target tuple.

pub fn arch_name(&self) -> &str

Returns the architecture name

pub fn vendor_name(&self) -> &str

pub fn sys(&self) -> &str

Gets the entire sys component

pub fn parse(s: &str) -> Self

Parses a target tuple of the form arch-vendor-system (where system is either os-env, os, or env). If a field is not known, it is left as unknown, and the original value will be available through the exact name.

Panics if s is not of the above form

pub fn operating_system(&self) -> Option<OS>

Gets the value of the os field

pub fn environment(&self) -> Option<Environment>

Gets the value of the env field, or unknown if the environment was omitted

pub fn parse_components(arch: &str, vendor: Option<&str>, sys: &str) -> Self

pub fn from_components(
    arch: Architecture,
    vendor: Vendor,
    os: Option<OS>,
    env: Option<Environment>,
    objfmt: Option<ObjectFormat>
) -> Self

Constructs a target tuple in canonical form from the specified components.

pub fn from_components_without_vendor(
    arch: Architecture,
    os: Option<OS>,
    env: Option<Environment>,
    objfmt: Option<ObjectFormat>
) -> Self

Constructs a target tuple in canonical form from the specified components.

pub fn target_object_format(&self) -> ObjectFormat

Gets the object format, either from the end of the env field, or the default for the target

pub fn object_format(&self) -> Option<ObjectFormat>

Gets the object format component from the end of the env component, or None if none is present

pub fn arch(&self) -> Architecture

Gets the value of the Architecture field

pub fn vendor(&self) -> Vendor

Gets the value of the vendor field.

Trait Implementations

impl Clone for Target

fn clone(&self) -> Target

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Target

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

Formats the value using the given formatter.

impl Display for Target

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

Formats the value using the given formatter.

impl FromStr for Target

type Err = UnknownError

The associated error which can be returned from parsing.

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

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

impl Hash for Target

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,
    Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<Target> for Target

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Target