Function natural_timepiece_move

Function natural_timepiece_move_arguments

fd::natural_timepiece_move_arguments — Determine the most natural timepiece move operation, and return a tuple that can be applied to the advance function.

Synopsis

// In header: <fd/functional.h>


std::tuple< schedule_timepiece &, timepiece_move, schedule_timepoint > 
natural_timepiece_move_arguments(schedule_timepiece & schedule, 
                                 scheduling_purpose purpose, 
                                 const schedule_timepoint & now = schedule_clock::local_time());

Description

For the purpose of a single-event task execution: this function is intended to get called in the context of a launch handler function before handling the launch event itself.
For all other purposes, including a twofold-event action (aka restart): this function is intended to get called in context of a termination handler.

See the timepiece_test_player, which outlines the usage of how to advance a timepoint generator.