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 1 of file OOWeakReference.m.

{
    return [_object class];
}

dealloc

- (void) dealloc

implementation

Definition at line 1 of file OOWeakReference.m.

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

description

- (NSString *) description

implementation

Definition at line 1 of file OOWeakReference.m.

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

forwardingTargetForSelector:

- (id) forwardingTargetForSelector: (SEL) sel

implementation

Definition at line 1 of file OOWeakReference.m.

                                 :(SEL)sel
{
    return _object;
}

forwardInvocation:

- (void) forwardInvocation: (NSInvocation *) invocation

implementation

Definition at line 1 of file OOWeakReference.m.

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

isProxy

- (BOOL) isProxy

implementation

Definition at line 1 of file OOWeakReference.m.

{
    return YES;
}

methodSignatureForSelector:

- (NSMethodSignature *) methodSignatureForSelector: (SEL) selector

implementation

Definition at line 1 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;
}

OO_RETURNS_RETAINED

- (id) OO_RETURNS_RETAINED

respondsToSelector:

- (BOOL) respondsToSelector: (SEL) selector

implementation

Definition at line 1 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;
    }
}

weakRefDrop

- (void) weakRefDrop

Definition at line 1 of file OOWeakReference.m.

{
    _object = nil;
}

weakRefUnderlyingObject

- (id) weakRefUnderlyingObject

Definition at line 1 of file OOWeakReference.m.

{
    return _object;
}

weakRefWithObject:

+ (id) weakRefWithObject:

(id<OOWeakReferenceSupport>)

object

Definition at line 1 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];
}

weakRetain

- (id) weakRetain

implementation

Definition at line 1 of file OOWeakReference.m.

{
    return [self retain];
}

Member Data Documentation

_object

- (id<OOWeakReferenceSupport>) _object

protected

Definition at line 111 of file OOWeakReference.h.

---

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

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