OOWeakReference Class Reference

#include <OOWeakReference.h>

Inheritance diagram for OOWeakReference:

Collaboration diagram for OOWeakReference:

Instance Methods
(id)	- weakRefUnderlyingObject
(id)	- OO_RETURNS_RETAINED
(void)	- weakRefDrop
(void)	- dealloc [implementation]
(NSString *)	- description [implementation]
(id)	- weakRetain [implementation]
(Class)	- class [implementation]
(BOOL)	- isProxy [implementation]
(void)	- forwardInvocation: [implementation]
(NSMethodSignature *)	- methodSignatureForSelector: [implementation]
(BOOL)	- respondsToSelector: [implementation]
(id)	- forwardingTargetForSelector: [implementation]

Class Methods
(id)	+ weakRefWithObject:

Protected Attributes
id< OOWeakReferenceSupport >	_object

Detailed Description

Definition at line 109 of file OOWeakReference.h.

Method Documentation

class

- (Class) class

implementation

Definition at line 72 of file OOWeakReference.m.

{
    return [_object class];
}

References class.

Referenced by class, and description.

Here is the call graph for this function:

Here is the caller graph for this function:

dealloc

- (void) dealloc

implementation

Definition at line 37 of file OOWeakReference.m.

{
    [_object weakRefDied:self];
    
    [super dealloc];
}

References dealloc.

Referenced by dealloc.

Here is the call graph for this function:

Here is the caller graph for this function:

description

- (NSString *) description

implementation

Definition at line 45 of file OOWeakReference.m.

{
    if (_object != nil)  return [_object description];
    else  return [NSString stringWithFormat:@"<Dead %@ %p>", [self class], self];
}

References _object, class, description, and nil.

Referenced by description.

Here is the call graph for this function:

Here is the caller graph for this function:

forwardingTargetForSelector:

- (id) forwardingTargetForSelector: (SEL) sel

implementation

Definition at line 132 of file OOWeakReference.m.

                                 :(SEL)sel
{
    return _object;
}

References _object.

forwardInvocation:

- (void) forwardInvocation: (NSInvocation *) invocation

implementation

Definition at line 84 of file OOWeakReference.m.

                         :(NSInvocation *)invocation
{
    // Does the right thing even with nil _object.
    [invocation invokeWithTarget:_object];
}

isProxy

- (BOOL) isProxy

implementation

Definition at line 78 of file OOWeakReference.m.

{
    return YES;
}

References isProxy.

Referenced by isProxy.

Here is the call graph for this function:

Here is the caller graph for this function:

methodSignatureForSelector:

- (NSMethodSignature *) methodSignatureForSelector: (SEL) selector

implementation

Definition at line 91 of file OOWeakReference.m.

                                                 :(SEL)selector
{
    NSMethodSignature       *result = nil;
    
    if (__builtin_expect(
        selector != @selector(weakRefDrop) &&
        selector != @selector(weakRefUnderlyingObject), 1))
    {
        // Not a proxy method; get signature from _object if it exists, otherwise generic signature for nil calls.
        if (__builtin_expect(_object != nil, 1))  result = [(id)_object methodSignatureForSelector:selector];
        else  result = [OOWeakReferenceTemplates methodSignatureForSelector:@selector(nilMethod)];
    }
    else
    {
        // One of OOWeakReference's own methods.
        result = [OOWeakReferenceTemplates methodSignatureForSelector:selector];
    }
    
    return result;
}

References _object, nil, weakRefDrop, and weakRefUnderlyingObject.

Here is the call graph for this function:

OO_RETURNS_RETAINED

- (id) OO_RETURNS_RETAINED

References OO_RETURNS_RETAINED, weakRefDrop, and weakRetain.

Referenced by OO_RETURNS_RETAINED.

Here is the call graph for this function:

Here is the caller graph for this function:

respondsToSelector:

- (BOOL) respondsToSelector: (SEL) selector

implementation

Definition at line 113 of file OOWeakReference.m.

                          :(SEL)selector
{
    if (__builtin_expect(_object != nil &&
        selector != @selector(weakRefDrop) &&
        selector != @selector(weakRefUnderlyingObject), 1))
    {
        // _object exists and it's not one of our methods, ask _object.
        return [_object respondsToSelector:selector];
    }
    else
    {
        // Selector we responds to, or _object is nil and therefore responds to everything.
        return YES;
    }
}

References _object, nil, weakRefDrop, and weakRefUnderlyingObject.

Here is the call graph for this function:

weakRefDrop

- (void) weakRefDrop

Definition at line 64 of file OOWeakReference.m.

{
    _object = nil;
}

References _object, nil, and weakRefDrop.

Referenced by OOJSScript::dealloc, OOWeakRefObject::dealloc, ShipEntity::dealloc, methodSignatureForSelector:, OO_RETURNS_RETAINED, respondsToSelector:, and weakRefDrop.

Here is the call graph for this function:

Here is the caller graph for this function:

weakRefUnderlyingObject

- (id) weakRefUnderlyingObject

Definition at line 52 of file OOWeakReference.m.

{
    return _object;
}

References _object, and weakRefUnderlyingObject.

Referenced by OOWeakSet::allObjects, OOShipGroup::countByEnumeratingWithState:objects:count:, PlayerEntity::dockedStation, HeadUpDisplay(Private)::drawSecondaryTargetReticle:, Universe::firstBeacon, ShipEntity::foundTarget, Universe::lastBeacon, ShipEntity::lastEscortTarget, OOShipGroup::leader, OOWeakSet::makeObjectsPerformSelector:, OOWeakSet::makeObjectsPerformSelector:withObject:, methodSignatureForSelector:, PlayerEntity::moveTargetMemoryBy:, OOVisualEffectEntity::nextBeacon, OOWaypointEntity::nextBeacon, ShipEntity::nextBeacon, OODebugInspector::object, OODebugInspectorModule::object, Entity::owner, OOVisualEffectEntity::prevBeacon, OOWaypointEntity::prevBeacon, ShipEntity::prevBeacon, ShipEntity::primaryAggressor, ShipEntity::primaryTarget, ShipEntity::primaryTargetWithoutValidityCheck, ShipEntity::proximityAlert, ShipEntity::rememberedShip, respondsToSelector:, ShipEntity::shipHitByLaser, ShipEntity::subEntityTakingDamage, ShipEntity::targetStation, ShipEntity::thankedShip, OOECMBlastEntity::update:, and weakRefUnderlyingObject.

Here is the call graph for this function:

Here is the caller graph for this function:

weakRefWithObject:

+ (id) weakRefWithObject:

(id<OOWeakReferenceSupport>)

object

Definition at line 26 of file OOWeakReference.m.

                       :(id<OOWeakReferenceSupport>)object
{
    if (object == nil)  return nil;
    
    OOWeakReference *result = [OOWeakReference alloc];
    // No init for proxies.
    result->_object = object;
    return [result autorelease];
}

References _object, and nil.

Referenced by OOJSScript::weakRetain, and OOWeakRefObject::weakRetain.

Here is the caller graph for this function:

weakRetain

- (id) weakRetain

implementation

Definition at line 58 of file OOWeakReference.m.

{
    return [self retain];
}

References weakRetain.

Referenced by OO_RETURNS_RETAINED, and weakRetain.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

_object

- (id<OOWeakReferenceSupport>) _object

protected

Definition at line 111 of file OOWeakReference.h.

Referenced by description, forwardingTargetForSelector:, methodSignatureForSelector:, respondsToSelector:, weakRefDrop, weakRefUnderlyingObject, and weakRefWithObject:.

---

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

• src/Core/OOWeakReference.h
• src/Core/OOWeakReference.m