Struct specifications::profiling::ProfileScope

pub struct ProfileScope { /* private fields */ }

Defines a scope within a ProfileReport.

Implementations

impl ProfileScope

pub fn new(name: impl Into<String>) -> Self

Constructor for the ProfileScope.

Arguments

• name: The name of the ProfileScope.

Returns

A new ProfileScope instance.

pub fn time(&self, name: impl Into<String>) -> TimerGuard<'_>

Returns a TimerGuard, which takes a time exactly as long as it is in scope.

Arguments

• name: The name to set for this Timing.

Returns

A new Timer struct to take a timing.

pub fn time_func<R>( &self, name: impl Into<String>, func: impl FnOnce() -> R, ) -> R

Profiles the given function and adds its timing under the given name.

Arguments

• name: The name to set for this Timing.
• func: The function to profile.

Returns

The result of the function, if any.

pub fn time_fut<'s, R>( &'s self, name: impl Into<String>, fut: impl 's + Future<Output = R>, ) -> impl 's + Future<Output = R>

Profiles the given future by creating a future that times it while running.

Arguments

• name: The name to set for this Timing.
• fut: The Future to profile.

Returns

A future that returns the same result as the given, but times its execution as a side-effect.

pub fn nest(&self, name: impl Into<String>) -> ProfileScopeHandle<'_>

Returns a new ProfileScope that can be used to do more elaborate nested timings.

Arguments

• name: The name of the new scope.

Returns

A new ProfileScope that can be used to take timings.

pub fn nest_func<R>( &self, name: impl Into<String>, func: impl FnOnce(ProfileScopeHandle<'_>) -> R, ) -> R

Profiles the given function, but provides it with extra profile options by giving it its own ProfileScope to populate.

Note that the ProfileScope is already automatically given a “total”-timing, representing the function’s profiling. This is still untimed as long as the function sees it, obviously.

Arguments

• name: The name to set for this Timing.
• func: The function to profile.

Returns

The result of the function, if any.

pub fn nest_fut<'s, F: Future>( &'s self, name: impl Into<String>, fut: impl 's + FnOnce(ProfileScopeHandle<'s>) -> F, ) -> impl 's + Future<Output = F::Output>

Profiles the given future by creating a future that times it while running, but provides it with extra profile options by giving it its own ProfileScope to popupate.

Note that the ProfileScope is already automatically given a “total”-timing, representing the future’s profiling. This is still untimed as long as the future sees it, obviously.

Arguments

• name: The name to set for this Timing.
• fut: The Future to profile.

Returns

A future that returns the same result as the given, but times its execution as a side-effect.

pub fn display(&self) -> ProfileScopeFormatter<'_>

Returns a formatter that neatly displays the results of this scope.

Note that this does not end with a newline, so typically you want to call writeln!()/println!() on this.

Returns

A new ProfileScopeFormatter.

pub fn display_indented(&self, indent: usize) -> ProfileScopeFormatter<'_>

Returns a formatter that neatly displays the results of this scope with a given number of spaces before each line.

Note that this does not end with a newline, so typically you want to call writeln!()/println!() on this.

Arguments

• indent: The number of spaces to print before each line.

Returns

A new ProfileScopeFormatter.

Trait Implementations

impl Debug for ProfileScope

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProfileScope

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ProfileScope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.