Function

CFRunLoopTimerInvalidate

Invalidates a CFRunLoopTimer object, stopping it from ever firing again.

Declaration

void CFRunLoopTimerInvalidate(CFRunLoopTimerRef timer);

Parameters

timer

The run loop timer to invalidate.

Discussion

Once invalidated, timer will never fire and call its callback function again. This function automatically removes timer from all run loop modes in which it had been added. The memory is not deallocated unless the run loop held the only reference to timer.

See Also

CFRunLoopTimer Miscellaneous Functions

CFRunLoopTimerCreateWithHandler

Creates a new CFRunLoopTimer object with a block-based handler.

CFRunLoopTimerCreate

Creates a new CFRunLoopTimer object with a function callback.

CFRunLoopTimerDoesRepeat

Returns a Boolean value that indicates whether a CFRunLoopTimer object repeats.

CFRunLoopTimerGetContext

Returns the context information for a CFRunLoopTimer object.

CFRunLoopTimerGetInterval

Returns the firing interval of a repeating CFRunLoopTimer object.

CFRunLoopTimerGetNextFireDate

Returns the next firing time for a CFRunLoopTimer object.

CFRunLoopTimerGetOrder

Returns the ordering parameter for a CFRunLoopTimer object.

CFRunLoopTimerGetTypeID

Returns the type identifier of the CFRunLoopTimer opaque type.

CFRunLoopTimerIsValid

Returns a Boolean value that indicates whether a CFRunLoopTimer object is valid and able to fire.

CFRunLoopTimerSetNextFireDate

Sets the next firing date for a CFRunLoopTimer object .