mirror of
https://github.com/gnustep/libs-base.git
synced 2025-05-02 12:51:07 +00:00
d2ea054c26
Richard: I'm unsure about three of these, which were fixes in memset() calls in: - NSConcreteMapTable.m - NSConcreteHashTable.m - Additions/NSData+GNUstepBase.m Please can you check them? I think they are intended to zero the entire object (rather than the first word), but the lack of comments makes me unsure. Most changes were just tweaks to variable types. I've also removed some dead code from NSInvocation. This was small group of things that were marked for internal use only, but not actually referenced in the code anywhere. Other improvements: - NSArray / NSDictionary fixed up to use the 10.7 (ARC-friendly) prototypes. - getObjects:andKeys: implemented for NSDictionary (10.5 method) - NSPointerArray and NSHashTable now properly support weak objects. - Tests for weak objects in collections. git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@33621 72102866-910b-0410-8b05-ffd578937521
153 lines
4.3 KiB
Objective-C
153 lines
4.3 KiB
Objective-C
/* Interface for NSInvocation for GNUStep
|
|
Copyright (C) 1998,2003 Free Software Foundation, Inc.
|
|
|
|
Author: Richard Frith-Macdonald <richard@brainstorm.co.uk>
|
|
Date: 1998
|
|
Based on code by: Andrew Kachites McCallum <mccallum@gnu.ai.mit.edu>
|
|
|
|
This file is part of the GNUstep Base Library.
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2 of the License, or (at your option) any later version.
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Library General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with this library; if not, write to the Free
|
|
Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
Boston, MA 02111 USA.
|
|
*/
|
|
|
|
#ifndef __NSInvocation_h_GNUSTEP_BASE_INCLUDE
|
|
#define __NSInvocation_h_GNUSTEP_BASE_INCLUDE
|
|
#import <GNUstepBase/GSVersionMacros.h>
|
|
|
|
#import <Foundation/NSMethodSignature.h>
|
|
|
|
#if defined(__cplusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
@interface NSInvocation : NSObject
|
|
{
|
|
#if GS_EXPOSE(NSInvocation)
|
|
@public
|
|
NSMethodSignature *_sig;
|
|
void *_cframe;
|
|
void *_retval;
|
|
id _target;
|
|
SEL _selector;
|
|
unsigned int _numArgs;
|
|
void *_info;
|
|
BOOL _argsRetained;
|
|
BOOL _targetRetained;
|
|
BOOL _validReturn;
|
|
BOOL _sendToSuper;
|
|
void *_retptr;
|
|
#endif
|
|
#if GS_NONFRAGILE
|
|
#else
|
|
/* Pointer to private additional data used to avoid breaking ABI
|
|
* when we don't have the non-fragile ABI available.
|
|
* Use this mechanism rather than changing the instance variable
|
|
* layout (see Source/GSInternal.h for details).
|
|
*/
|
|
@private id _internal GS_UNUSED_IVAR;
|
|
#endif
|
|
}
|
|
|
|
/*
|
|
* Creating instances.
|
|
*/
|
|
+ (NSInvocation*) invocationWithMethodSignature: (NSMethodSignature*)_signature;
|
|
|
|
/*
|
|
* Accessing message elements.
|
|
*/
|
|
- (void) getArgument: (void*)buffer
|
|
atIndex: (NSInteger)index;
|
|
- (void) getReturnValue: (void*)buffer;
|
|
- (SEL) selector;
|
|
- (void) setArgument: (void*)buffer
|
|
atIndex: (NSInteger)index;
|
|
- (void) setReturnValue: (void*)buffer;
|
|
- (void) setSelector: (SEL)aSelector;
|
|
- (void) setTarget: (id)anObject;
|
|
- (id) target;
|
|
|
|
/*
|
|
* Managing arguments.
|
|
*/
|
|
- (BOOL) argumentsRetained;
|
|
- (void) retainArguments;
|
|
|
|
#if OS_API_VERSION(GS_API_NONE,GS_API_NONE) && GS_API_VERSION( 11101,GS_API_LATEST)
|
|
- (BOOL) targetRetained;
|
|
- (void) retainArgumentsIncludingTarget: (BOOL)retainTargetFlag;
|
|
#endif
|
|
|
|
/*
|
|
* Dispatching an Invocation.
|
|
*/
|
|
- (void) invoke;
|
|
- (void) invokeWithTarget: (id)anObject;
|
|
|
|
/*
|
|
* Getting the method signature.
|
|
*/
|
|
- (NSMethodSignature*) methodSignature;
|
|
|
|
@end
|
|
|
|
#if GS_API_VERSION(GS_API_NONE, 011700)
|
|
@interface NSInvocation (GNUstep)
|
|
/**
|
|
* Returns the status of the flag set by -setSendsToSuper:
|
|
*/
|
|
- (BOOL) sendsToSuper;
|
|
/**
|
|
* Sets the flag to tell the invocation that it should actually invoke a
|
|
* method in the superclass of the target rather than the method of the
|
|
* target itself.<br />
|
|
* This extension permits an invocation to act like a regular method
|
|
* call sent to <em>super</em> in the method of a class.
|
|
*/
|
|
- (void) setSendsToSuper: (BOOL)flag;
|
|
@end
|
|
#endif
|
|
|
|
/**
|
|
* Creates and returns an autoreleased invocation containing a
|
|
* message to an instance of the class. The 'message' consists
|
|
* of selector and arguments like a standard ObjectiveC method
|
|
* call.<br />
|
|
* Before using the returned invocation, you need to set its target.
|
|
*/
|
|
#define NS_INVOCATION(aClass, message...) ({\
|
|
id __proxy = [NSInvocation _newProxyForInvocation: aClass]; \
|
|
[__proxy message]; \
|
|
[NSInvocation _returnInvocationAndDestroyProxy: __proxy]; \
|
|
})
|
|
|
|
/**
|
|
* Creates and returns an autoreleased invocation containing a
|
|
* message to the target object. The 'message' consists
|
|
* of selector and arguments like a standard ObjectiveC method
|
|
* call.
|
|
*/
|
|
#define NS_MESSAGE(target, message...) ({\
|
|
id __proxy = [NSInvocation _newProxyForMessage: target]; \
|
|
[__proxy message]; \
|
|
[NSInvocation _returnInvocationAndDestroyProxy: __proxy]; \
|
|
})
|
|
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
#endif /* __NSInvocation_h_GNUSTEP_BASE_INCLUDE */
|