scheduleOneshot(deadline:leeway:)

func scheduleOneshot(deadline: DispatchTime, leeway: DispatchTimeInterval = .nanoseconds(0))

Discussion

Once this function returns, any pending source data accumulated for the previous timer values has been cleared and the next timer event will occur at deadline.

Delivery of the timer event may be delayed by the system in order to improve power consumption and system performance. The upper limit to the allowable delay may be configured with the leeway argument; the lower limit is under the control of the system.

The lower limit to the allowable delay may vary with process state such as visibility of the application UI. If the timer source was created with flags TimerFlags.strict, the system will make a best effort to strictly observe the provided leeway value, even if it is smaller than the current lower limit. Note that a minimal amount of delay is to be expected even if this flag is specified.

Calling this method has no effect if the timer source has already been canceled.