Type Method

timerWithTimeInterval:target:selector:userInfo:repeats:

Initializes a timer object with the specified object and selector.

Declaration

+ (NSTimer *)timerWithTimeInterval:(NSTimeInterval)ti target:(id)aTarget selector:(SEL)aSelector userInfo:(id)userInfo repeats:(BOOL)yesOrNo;

Parameters

ti

The number of seconds between firings of the timer. If ti is less than or equal to 0.0, this method chooses the nonnegative value of 0.1 milliseconds instead.

target

The object to which to send the message specified by aSelector when the timer fires. The timer maintains a strong reference to this object until it (the timer) is invalidated.

aSelector

The message to send to target when the timer fires.

The selector should have the following signature: timerFireMethod: (including a colon to indicate that the method takes an argument). The timer passes itself as the argument, thus the method would adopt the following pattern:

- (void)timerFireMethod:(NSTimer *)timer
userInfo

Custom user info for the timer.

The timer maintains a strong reference to this object until it (the timer) is invalidated. This parameter may be nil.

repeats

If YES, the timer will repeatedly reschedule itself until invalidated. If NO, the timer will be invalidated after it fires.

Return Value

A new NSTimer object, configured according to the specified parameters.

Discussion

You must add the new timer to a run loop, using addTimer:forMode:. Then, after ti seconds have elapsed, the timer fires, sending the message aSelector to target. (If the timer is configured to repeat, there is no need to subsequently re-add the timer to the run loop.)

See Also

Creating a Timer

+ scheduledTimerWithTimeInterval:repeats:block:

Creates a timer and schedules it on the current run loop in the default mode.

+ scheduledTimerWithTimeInterval:target:selector:userInfo:repeats:

Creates a timer and schedules it on the current run loop in the default mode.

+ scheduledTimerWithTimeInterval:invocation:repeats:

Creates a new timer and schedules it on the current run loop in the default mode.

+ timerWithTimeInterval:repeats:block:

Initializes a timer object with the specified time interval and block.

+ timerWithTimeInterval:invocation:repeats:

Initializes a timer object with the specified invocation object.

- initWithFireDate:interval:repeats:block:

Initializes a timer for the specified date and time interval with the specified block.

- initWithFireDate:interval:target:selector:userInfo:repeats:

Initializes a timer using the specified object and selector.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software