Crate howlong[−][src]

This crate allows you to measure how long it takes for a program to execute in different clocks. It ports the functions of the boost-chrono and boost-timer libraries.

The following clocks and their corresponding timers are implemented.

SystemClock, SystemTimer
SteadyClock, SteadyTimer if supported by the system.
HighResolutionClock, HighResolutionTimer
ProcessRealCPUClock, ProcessRealCPUTimer
ProcessUserCPUClock, ProcessUserCPUTimer
ProcessSystemCPUClock, ProcessSystemCPUTimer
ProcessCPUClock, ProcessCPUTimer
ThreadClock, ThreadTimer

See crate::clock to read more about their differences.

Usage

Add this to your Cargo.toml:

[dependencies]
howlong = "0.1"

Examples

let timer = howlong::HighResolutionTimer::new();
// do some computations
println!("{:?} have passed.", timer.elapsed());

let timer = howlong::ProcessCPUTimer::new();
// do other computations
println!("{}", timer.elapsed()); // 5.71s wall, 5.70s user + 0ns system = 5.70s CPU (99.8%)

Re-exports

pub use clock::*;

pub use timer::*;

Modules

clock	Measure the current time using different clocks.
timer	Measure how long a program takes to execute.

Structs

Duration	A `Duration` type to represent a span of time, typically used for system timeouts.
ProcessDuration	Like `Duration` but captures real, user-CPU, and system-CPU process times.
ProcessTimePoint	Like `TimePoint` but captures real, user-CPU, and system-CPU process times.
TimePoint	A point in time.

Enums

Error

Error type for this crate.

Traits

Clock

A trait to represent a clock.

Type Definitions

Result

Alias to core::result::Result<T, howlong::Error>