Struct TimerStruct

pub struct TimerStruct {
    pub duration: u32,
    pub hours: u32,
    pub minutes: u32,
    pub seconds: u32,
}

Represents a countdown timer.

Fields

duration: u32

The total duration of the timer in seconds.

hours: u32

The initial hours component of the timer.

minutes: u32

The initial minutes component of the timer.

seconds: u32

The initial seconds component of the timer.

Implementations

impl TimerStruct

pub fn new( hours: u32, minutes: u32, seconds: u32, ) -> Result<TimerStruct, &'static str>

Creates a new TimerStruct instance.

Arguments

• hours - The hours component of the timer duration.
• minutes - The minutes component of the timer duration.
• seconds - The seconds component of the timer duration.

Returns

• Ok(TimerStruct) if the total duration calculated from hours, minutes, and seconds is greater than 0.
• Err("Duration need to be 1 or more seconds.") if the total duration is 0.

Examples

use your_crate_name::TimerStruct; // Replace your_crate_name with your actual crate name

let timer = TimerStruct::new(0, 1, 30).expect("Failed to create timer"); // 1 minute 30 seconds
let invalid_timer = TimerStruct::new(0, 0, 0); // This will return an Err

pub fn start_timer<W: Write>(&self, writer: &mut W)

Starts the countdown timer.

The timer will print the remaining time to the provided writer every second, overwriting the previous line. When the timer reaches 0, it prints the final 0:0:0 with a newline and stops.

Arguments

• writer - A mutable reference to any type that implements the std::io::Write trait (e.g., &mut std::io::Stdout).

Examples

use clock-timer::TimerStruct; // Replace your_crate_name with your actual crate name
use std::io::{self, stdout};

let timer = TimerStruct::new(0, 0, 5).unwrap(); // 5-second timer
let mut writer = stdout();
timer.start_timer(&mut writer);
println!("Timer finished!");

Trait Implementations

impl Clone for TimerStruct

fn clone(&self) -> TimerStruct

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimerStruct

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

Formats the value using the given formatter.

impl Copy for TimerStruct