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.


// 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());


  • 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.