Struct TargetFeature 

pub struct TargetFeature {
    pub name: &'static str,
    pub implies_features: BTreeSet<&'static str>,
    pub unstable_feature_gate: Option<&'static str>,
    pub globally_enabled: bool,
}

Information about a target feature.

Rust target features are used to influence code generation, especially around selecting instructions which are not universally supported by the target architecture.

Target features are commonly enabled by the #[target_feature] attribute to influence code generation for a particular function, and less commonly enabled by compiler options like -Ctarget-feature or -Ctarget-cpu. Targets themselves automatically enable certain target features by default, for example because the target’s ABI specification requires saving specific registers which only exist in an architectural extension.

Target features can imply other target features: for example, x86-64 avx2 implies avx, and aarch64 sve2 implies sve, since both of these architectural extensions depend on their predecessors.

Target features can be probed at compile time by #[cfg(target_feature)] or cfg!(…) conditional compilation to determine whether a target feature is enabled in a particular context.

Fields

name: &'static str

The name of this target feature.

implies_features: BTreeSet<&'static str>

Other target features which are implied by this target feature, if any.

unstable_feature_gate: Option<&'static str>

If this target feature is unstable, the name of the associated language feature gate.

globally_enabled: bool

Whether this feature is globally enabled by default.

Target features can be globally enabled implicitly as a result of the target’s definition. For example, x86-64 hardware floating point ABIs require saving x87 and SSE2 registers, which in turn requires globally enabling the x87 and sse2 target features so that the generated machine code conforms to the target’s ABI.

Target features can also be globally enabled explicitly as a result of compiler flags like -Ctarget-feature or -Ctarget-cpu.

Trait Implementations

impl Clone for TargetFeature

fn clone(&self) -> TargetFeature

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TargetFeature

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

Formats the value using the given formatter.

impl Hash for TargetFeature

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 Ord for TargetFeature

fn cmp(&self, other: &TargetFeature) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for TargetFeature

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for TargetFeature

fn partial_cmp(&self, other: &TargetFeature) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for TargetFeature

impl StructuralPartialEq for TargetFeature