Struct OptimizationConfig 

pub struct OptimizationConfig { /* private fields */ }

A live choice of which optimizations are enabled — one bit per Opt.

The default is every optimization on (the speed-tuned baseline). Clearing all bits yields plain, boring Rust.

Implementations

impl OptimizationConfig

pub fn all_on() -> OptimizationConfig

Every default-on optimization enabled (the speed baseline).

pub const fn all_off() -> OptimizationConfig

No optimizations enabled — the “boring Rust” config.

pub const fn is_on(&self, opt: Opt) -> bool

Whether a given optimization is on.

pub fn set(&mut self, opt: Opt, on: bool)

Turn an optimization on or off.

pub fn disable(self, opt: Opt) -> OptimizationConfig

Turn an optimization off (builder style).

pub fn enable(self, opt: Opt) -> OptimizationConfig

Turn an optimization on (builder style).

pub fn enable_with_requires(&mut self, opt: Opt)

Turn opt on together with the transitive closure of what it requires.

The complement of normalize’s dependency-closure (which turns dependents off when a requirement goes off): enabling a leaf must pull its whole requires-chain on, or normalize would just turn the leaf back off. This is the on-direction of the UI’s toggle-linking.

pub const fn is_all_off(&self) -> bool

Whether every optimization is off.

pub const fn bits(&self) -> u64

The raw enabled bitmask (bit layout = Opt::bit). Lets callers relate an OptimizationConfig to a FiredOptimizations set bit-for-bit.

pub const fn merged(&self, func: &OptimizationConfig) -> OptimizationConfig

Combine a program-level config with a function’s per-function overrides: an optimization is on for the function only if it is on in both.

pub fn disabled_keywords(&self) -> impl Iterator<Item = &'static str>

The keywords of every optimization currently off (registry order).

pub fn normalize(&mut self) -> NormalizeReport

Resolve conflicts and dependencies, returning what was auto-disabled.

Conflicts: when two mutually exclusive optimizations are both on, the one declared earlier in REGISTRY wins and the later is disabled. Dependencies: any optimization whose requires set is not fully on is disabled (transitively, to a fixed point).

pub fn from_env() -> OptimizationConfig

Build a config from the environment, the single external entry point.

• LOGOS_OPT=off (or LOGOS_NO_OPTIMIZE=1) disables everything.
• LOGOS_OPT_PROFILE=speed|memory|safety selects a base profile.
• LOGOS_OPT_OFF="scalarize,unroll,…" disables the listed keywords.

The result is normalized.

pub fn from_spec( master_off: bool, profile: Option<&str>, off_list: Option<&str>, ) -> OptimizationConfig

The pure, testable core of from_env. master_off disables everything; profile picks the base preset (speed by default); off_list is a comma/space/;-separated list of keywords to disable. The result is normalized.

pub fn from_toggles( toggles: &BTreeMap<String, bool>, ) -> (OptimizationConfig, Vec<Opt>)

Build a config from a keyword→enabled map (e.g. UI toggles), returning the normalized config and the optimizations normalization forced off.

Trait Implementations

impl Clone for OptimizationConfig

fn clone(&self) -> OptimizationConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OptimizationConfig

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

Formats the value using the given formatter.

impl Default for OptimizationConfig

fn default() -> OptimizationConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for OptimizationConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<OptimizationConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for OptimizationConfig

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

where __H: Hasher,

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 for OptimizationConfig

fn eq(&self, other: &OptimizationConfig) -> 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 Serialize for OptimizationConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for OptimizationConfig

impl Eq for OptimizationConfig

impl StructuralPartialEq for OptimizationConfig