Function

CFRunLoopCopyCurrentMode

Returns the name of the mode in which a given run loop is currently running.

Declaration

CFRunLoopMode CFRunLoopCopyCurrentMode(CFRunLoopRef rl);

Parameters

rl

The run loop to examine.

Return Value

The mode in which rl is currently running; NULL if rl is not running. Ownership follows the The Create Rule.

Discussion

When run on the current thread’s run loop, the returned value identifies the run loop mode that made the callout in which your code is currently executing.

See Also

Managing Run Loop Modes

CFRunLoopAddCommonMode

Adds a mode to the set of run loop common modes.

CFRunLoopCopyAllModes

Returns an array that contains all the defined modes for a CFRunLoop object.