Struct Lowerings 

pub struct Lowerings { /* private fields */ }

What the group did to every function a run lowered, in the order they came through.

The same shape crate::pressure::Pressure has and for the same reason: a caller collects one of these over a whole command line and asks for the listing once at the end.

Implementations

impl Lowerings

pub fn new() -> Self

Nothing recorded, and nothing counted either.

pub fn asked(wanted: bool) -> Self

The same, told whether to count, which is what -Zlowering=FILE decides.

pub fn wanted(&self) -> bool

Whether the counting is worth doing, which is what group is passed.

This is a question and not an assumption for a reason that showed up as soon as the numbers were measured on something large. Counting is a walk of the function per step, and a function’s instructions are a linked list, so on the SQLite amalgamation the walks cost about two seconds on top of nine, which is more than several of the passes they are measuring. A debugging aid nobody asked for should cost nothing, so a run without the flag runs the group and records no numbers at all.

pub fn record(&mut self, name: &str, ran: Ran)

Writes down what the group did to one function.

pub fn merge(&mut self, other: &Self)

Takes in everything another one recorded, which is how one file’s answer joins a run’s.

pub fn functions(&self) -> usize

How many functions went through the group.

pub fn listing(&self) -> String

What -Zlowering=FILE writes.

A comment holding the count and then one block per function. Whoever reads one of these is looking for which step changed a function they are surprised by, so the file is the same text in the same order as the group ran, and every step is there whether it did anything or not. A dump listing only the steps that fired could not tell a step that found nothing from a step somebody forgot to put in the group, which is half of what this is read for.

Trait Implementations

impl Clone for Lowerings

fn clone(&self) -> Lowerings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Lowerings

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

Formats the value using the given formatter.

impl Default for Lowerings

fn default() -> Lowerings

Returns the “default value” for a type.

impl Eq for Lowerings

impl PartialEq for Lowerings

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Lowerings