OOScriptTimer Class Reference

#include <OOScriptTimer.h>

Inheritance diagram for OOScriptTimer:

Collaboration diagram for OOScriptTimer:

Instance Methods
(id)	- initWithNextTime:interval:
(id)	- initOneShotTimerWithDelay:
(OOTimeAbsolute)	- nextTime
(BOOL)	- setNextTime:
(OOTimeDelta)	- interval
(void)	- setInterval:
(void)	- timerFired
(BOOL)	- scheduleTimer
(void)	- unscheduleTimer
(BOOL)	- isScheduled
(BOOL)	- isValidForScheduling
(NSComparisonResult)	- compareByNextFireTime:
(void)	- dealloc [implementation]
(NSString *)	- descriptionComponents [implementation]

Class Methods
(void)	+ updateTimers
(void)	+ noteGameReset

Private Attributes
OOTimeAbsolute	_nextTime
OOTimeDelta	_interval
BOOL	_isScheduled
BOOL	_hasBeenRun

Detailed Description

Definition at line 39 of file OOScriptTimer.h.

Method Documentation

compareByNextFireTime:

- (NSComparisonResult) compareByNextFireTime:

(OOScriptTimer *)

other

Definition at line 240 of file OOScriptTimer.m.

                                            :(OOScriptTimer *)other
{
    OOTimeAbsolute        otherTime = -INFINITY;
    
    @try
    {
        if (other != nil)  otherTime = [other nextTime];
    }
    @catch (NSException *exception)
    {
        OOLog(kOOLogException, @"\n\n***** Ignoring Timer Exception: %@ : %@ *****\n\n",[exception name], [exception reason]);
    }
    
    if (_nextTime < otherTime) return NSOrderedAscending;
    else if (_nextTime > otherTime) return NSOrderedDescending;
    else  return NSOrderedSame;
}

References _nextTime, kOOLogException, nextTime, nil, and OOLog.

Here is the call graph for this function:

dealloc

- (void) dealloc

implementation

Reimplemented in OOJSTimer.

Definition at line 76 of file OOScriptTimer.m.

{
    if (_isScheduled)  [self unscheduleTimer];
    
    [super dealloc];
}

References _isScheduled, dealloc, and unscheduleTimer.

Referenced by OOJSTimer::dealloc, and dealloc.

Here is the call graph for this function:

Here is the caller graph for this function:

descriptionComponents

- (NSString *) descriptionComponents

implementation

Reimplemented in OOJSTimer.

Definition at line 84 of file OOScriptTimer.m.

{
    NSString                    *intervalDesc = nil;
    
    if (_interval <= 0.0)  intervalDesc = @"one-shot";
    else  intervalDesc = [NSString stringWithFormat:@"interval: %g", _interval];
        
    return [NSString stringWithFormat:@"nextTime: %g, %@, %srunning", _nextTime, intervalDesc, _isScheduled ? "" : "not "];
}

References _interval, descriptionComponents, and nil.

Referenced by OOJSTimer::descriptionComponents, and descriptionComponents.

Here is the call graph for this function:

Here is the caller graph for this function:

initOneShotTimerWithDelay:

- (id) initOneShotTimerWithDelay:

(OOTimeDelta)

delay

Definition at line 70 of file OOScriptTimer.m.

                                :(OOTimeDelta)delay
{
    return [self initWithNextTime:[UNIVERSE getTime] + delay interval:-1.0];
}

References initWithNextTime:interval:.

Here is the call graph for this function:

initWithNextTime:interval:

- (id) initWithNextTime:		(OOTimeAbsolute)	nextTime
interval:		(OOTimeDelta)	interval

Definition at line 41 of file OOScriptTimer.m.

                       :(OOTimeAbsolute)nextTime
               interval:(OOTimeDelta)interval
{
    OOTimeAbsolute            now;
    
    if ((self = [super init]))
    {
        if (interval <= 0.0)  interval = -1.0;
        
        now = [UNIVERSE getTime];
        if (nextTime < 0.0)  nextTime = now + interval;
        if (nextTime < now && interval < 0)
        {
            // Negative or old nextTime and negative interval = meaningless.
            [self release];
            self = nil;
        }
        else
        {
            _nextTime = nextTime;
            _interval = interval;
            _hasBeenRun = NO;
        }
    }
    
    return self;
}

References _hasBeenRun, _interval, _nextTime, interval, nextTime, and nil.

Referenced by initOneShotTimerWithDelay:, and OOJSTimer(Private)::initWithDelay:interval:context:function:this:.

Here is the call graph for this function:

Here is the caller graph for this function:

interval

- (OOTimeDelta) interval

Definition at line 110 of file OOScriptTimer.m.

{
    return _interval;
}

References _interval, and interval.

Referenced by initWithNextTime:interval:, interval, and setInterval:.

Here is the call graph for this function:

Here is the caller graph for this function:

isScheduled

- (BOOL) isScheduled

Definition at line 158 of file OOScriptTimer.m.

{
    return _isScheduled;
}

References _isScheduled, and isScheduled.

Referenced by isScheduled.

Here is the call graph for this function:

Here is the caller graph for this function:

isValidForScheduling

- (BOOL) isValidForScheduling

Definition at line 216 of file OOScriptTimer.m.

{
    OOTimeAbsolute        now;
    double              scaled;
    
    now = [UNIVERSE getTime];
    if (_nextTime <= now)
    {
        if (_interval <= 0.0 && _hasBeenRun)  return NO;    // One-shot timer which has expired
        
        // Move _nextTime to the closest future time that's a multiple of _interval
        scaled = (now - _nextTime) / _interval;
        scaled = ceil(scaled);
        _nextTime += scaled * _interval;
        if (_nextTime <= now && _hasBeenRun) 
        {
            // Should only happen if _nextTime is exactly equal to now after previous stuff
            _nextTime += _interval;
        }
    }
    
    return YES;
}

References _hasBeenRun, _interval, _nextTime, and isValidForScheduling.

Referenced by isValidForScheduling, and scheduleTimer.

Here is the call graph for this function:

Here is the caller graph for this function:

nextTime

- (OOTimeAbsolute) nextTime

Definition at line 95 of file OOScriptTimer.m.

{
    return _nextTime;
}

References _nextTime, and nextTime.

Referenced by compareByNextFireTime:, initWithNextTime:interval:, nextTime, setNextTime:, and updateTimers.

Here is the call graph for this function:

Here is the caller graph for this function:

noteGameReset

+ (void) noteGameReset

Definition at line 201 of file OOScriptTimer.m.

{
    NSArray             *timers = nil;
    NSEnumerator        *timerEnum = nil;
    OOScriptTimer       *timer = nil;
    
    // Intermediate array is required so we don't get stuck in an endless loop over reinserted timers. Note that -sortedObjects also clears the queue!
    timers = [sTimers sortedObjects];
    for (timerEnum = [timers objectEnumerator]; (timer = [timerEnum nextObject]); )
    {
        timer->_isScheduled = NO;
    }
}

References _isScheduled, nil, noteGameReset, and OOPriorityQueue::sortedObjects.

Referenced by noteGameReset, and PlayerEntity::setUpAndConfirmOK:saveGame:.

Here is the call graph for this function:

Here is the caller graph for this function:

scheduleTimer

- (BOOL) scheduleTimer

Definition at line 129 of file OOScriptTimer.m.

{
    if (_isScheduled)  return YES;
    if (![self isValidForScheduling])  return NO;
    
    if (EXPECT(!sUpdating))
    {
        if (EXPECT_NOT(sTimers == nil))  sTimers = [[OOPriorityQueue alloc] initWithComparator:@selector(compareByNextFireTime:)];
        [sTimers addObject:self];
    }
    else
    {
        if (sDeferredTimers == nil)  sDeferredTimers = [[NSMutableArray alloc] init];
        [sDeferredTimers addObject:self];
    }
    
    _isScheduled = YES;
    return YES;
}

References _isScheduled, OOPriorityQueue::addObject:, EXPECT, EXPECT_NOT, isValidForScheduling, nil, scheduleTimer, sDeferredTimers, sTimers, and sUpdating.

Referenced by scheduleTimer, TimerConstruct(), and updateTimers.

Here is the call graph for this function:

Here is the caller graph for this function:

setInterval:

- (void) setInterval:

(OOTimeDelta)

interval

Definition at line 116 of file OOScriptTimer.m.

                   :(OOTimeDelta)interval
{
    if (interval <= 0.0)  interval = -1.0;
    _interval = interval;
}

References _interval, and interval.

Referenced by TimerSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

setNextTime:

- (BOOL) setNextTime:

(OOTimeAbsolute)

nextTime

Definition at line 101 of file OOScriptTimer.m.

                   :(OOTimeAbsolute)nextTime
{
    if (_isScheduled)  return NO;
    
    _nextTime = nextTime;
    return YES;
}

References _isScheduled, _nextTime, and nextTime.

Here is the call graph for this function:

timerFired

- (void) timerFired

Reimplemented in OOJSTimer.

Definition at line 123 of file OOScriptTimer.m.

{
    OOLogGenericSubclassResponsibility();
}

References OOLogGenericSubclassResponsibility, and timerFired.

Referenced by timerFired, and updateTimers.

Here is the call graph for this function:

Here is the caller graph for this function:

unscheduleTimer

- (void) unscheduleTimer

Definition at line 150 of file OOScriptTimer.m.

{
    [sTimers removeExactObject:self];
    _isScheduled = NO;
    _hasBeenRun = NO;
}

References _hasBeenRun, _isScheduled, OOPriorityQueue::removeExactObject:, and unscheduleTimer.

Referenced by dealloc, OOJSTimer::deleteJSPointers, OOJSTimer::timerFired, TimerStop(), and unscheduleTimer.

Here is the call graph for this function:

Here is the caller graph for this function:

updateTimers

+ (void) updateTimers

Definition at line 164 of file OOScriptTimer.m.

{
    OOScriptTimer       *timer = nil;
    OOTimeAbsolute        now;
    
    sUpdating = YES;
    
    now = [UNIVERSE getTime];
    for (;;)
    {
        timer = [sTimers peekAtNextObject];
        if (timer == nil || now < [timer nextTime])  break;
        
        [sTimers removeNextObject];
        
        // Must fire before rescheduling so that the timer callback can stop itself. -- Ahruman 2011-01-01
        [timer timerFired];
        
        timer->_hasBeenRun = YES;
        
        if (timer->_isScheduled)
        {
            timer->_isScheduled = NO;
            [timer scheduleTimer];
        }
    }
    
    if (sDeferredTimers != nil)
    {
        [sTimers addObjects:sDeferredTimers];
        DESTROY(sDeferredTimers);
    }
    
    sUpdating = NO;
}

References _hasBeenRun, _isScheduled, OOPriorityQueue::addObjects:, DESTROY, nextTime, nil, OOPriorityQueue::peekAtNextObject, OOPriorityQueue::removeNextObject, scheduleTimer, sDeferredTimers, sUpdating, timerFired, and updateTimers.

Referenced by PlayerEntity::setUpAndConfirmOK:saveGame:, PlayerEntity::update:, and updateTimers.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

_hasBeenRun

- (BOOL) _hasBeenRun

private

Definition at line 45 of file OOScriptTimer.h.

Referenced by initWithNextTime:interval:, isValidForScheduling, unscheduleTimer, and updateTimers.

_interval

- (OOTimeDelta) _interval

private

Definition at line 43 of file OOScriptTimer.h.

Referenced by descriptionComponents, initWithNextTime:interval:, interval, isValidForScheduling, and setInterval:.

_isScheduled

- (BOOL) _isScheduled

private

Definition at line 44 of file OOScriptTimer.h.

Referenced by dealloc, isScheduled, noteGameReset, scheduleTimer, setNextTime:, unscheduleTimer, and updateTimers.

_nextTime

- (OOTimeAbsolute) _nextTime

private

Definition at line 42 of file OOScriptTimer.h.

Referenced by compareByNextFireTime:, initWithNextTime:interval:, isValidForScheduling, nextTime, and setNextTime:.

---

The documentation for this class was generated from the following files:

• src/Core/Scripting/OOScriptTimer.h
• src/Core/Scripting/OOScriptTimer.m