fd::natural_timepiece_move_setup — Determine the most natural very first timepiece move operation (at setup), and return a value that can be forwarded to the timepoint generator constructor.
// In header: <fd/functional.h> timepiece_move natural_timepiece_move_setup(const interval_schedule_data & data, scheduling_purpose purpose);
For the purpose of a single-event task execution: the very first setup move is timepiece_move::to_adjacent
.
For a fixed duration schedule: the very first setup move is timepiece_move::rewind
.
For the purpose of a twofold-event action (aka restart): the very first setup move is timepiece_move::to_adjacent
.
See the timepiece_test_player
, which outlines the usage of how to advance a timepoint generator.