Step 6 of 9

Challenge: a Clock class

This challenge is about designing a small class from a description. Here's the process professionals use:

1. Decide the data. What's the smallest set of members that represents the state? For a timer, a single number of seconds remaining is enough. Minutes and seconds can be computed from it when needed, so they shouldn't be stored separately (two copies of the same information can get out of sync).
2. Write the constructor so every object starts valid.
3. Write each method, keeping the data valid (here: never below 0).
4. Mark reading methods const.

Formatting with padding

M:SS needs the seconds padded to two digits: 1:05, not 1:5. Building the string yourself is simple: if the seconds are below 10, add a "0" before them.

#include <iostream>
#include <string>

class Stopwatch {
public:
    void add(int seconds) {
        if (seconds > 0) total_ += seconds;
    }
    std::string display() const {
        int h = total_ / 3600;
        int m = (total_ / 60) % 60;
        int s = total_ % 60;
        return std::to_string(h) + "h" + two(m) + "m" + two(s) + "s";
    }

private:
    static std::string two(int n) {
        return (n < 10 ? "0" : "") + std::to_string(n);
    }
    int total_ = 0;
};

int main() {
    Stopwatch w;
    w.add(3725);
    std::cout << w.display() << "\n";
    w.add(-50);
    w.add(40);
    std::cout << w.display() << "\n";
}

1h02m05s
1h02m45s

two is a private static helper: it doesn't need an object, and it's an implementation detail, so it's hidden from users of the class.

Default arguments work on member functions too: void tick(int s = 1) lets callers write tick() or tick(5).

Your task

Write a class Clock representing a round timer in seconds:

• Clock(int seconds) creates it
• void tick(int s = 1) subtracts seconds but never goes below 0
• bool expired() const is true at 0
• std::string display() const returns M:SS, like 1:55 or 0:07

Challenge 2

Write a class Bomb for a planted bomb:

• Bomb(int seconds) starts the timer
• void tick() takes one second off, but only while it's still ticking (not defused, not exploded)
• void defuse() stops it, unless it already exploded
• std::string status() const returns "planted 35", "defused 12" (the seconds that were left) or "exploded"

Challenge 3

Write a class Stopwatch that records lap times: void add(int seconds) adds time to the current lap, void lap() finishes the current lap (recording its time) and starts a new one at 0, std::vector<int> laps() const returns the recorded laps in order, and int best_lap() const returns the shortest recorded lap, or -1 if there are none.

Previous: static members Next: Member initializer lists