Header reorganizsateion - Please refer to ChangeLog

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@17407 72102866-910b-0410-8b05-ffd578937521

Headers/Foundation/NSInvocation.h

@@ -0,0 +1,132 @@
+/* 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 Library 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 Library General Public
+   License along with this library; if not, write to the Free
+   Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
+   */ 
+
+#ifndef __NSInvocation_h_GNUSTEP_BASE_INCLUDE
+#define __NSInvocation_h_GNUSTEP_BASE_INCLUDE
+
+#include <Foundation/NSMethodSignature.h>
+
+
+@interface NSInvocation : NSObject
+{
+  NSMethodSignature	*_sig;
+  void                  *_cframe;
+  void			*_retval;
+  id			_target;
+  SEL			_selector;
+  unsigned int		_numArgs;
+#ifndef	STRICT_MACOS_X
+  NSArgumentInfo	*_info;
+#else
+  void			*_dummy;
+#endif
+  BOOL			_argsRetained;
+  BOOL			_validReturn;
+  BOOL			_sendToSuper;
+}
+
+/*
+ *	Creating instances.
+ */
++ (NSInvocation*) invocationWithMethodSignature: (NSMethodSignature*)_signature;
+
+/*
+ *	Accessing message elements.
+ */
+- (void) getArgument: (void*)buffer
+	     atIndex: (int)index;
+- (void) getReturnValue: (void*)buffer;
+- (SEL) selector;
+- (void) setArgument: (void*)buffer
+	     atIndex: (int)index;
+- (void) setReturnValue: (void*)buffer;
+- (void) setSelector: (SEL)aSelector;
+- (void) setTarget: (id)anObject;
+- (id) target;
+
+/*
+ *	Managing arguments.
+ */
+- (BOOL) argumentsRetained;
+- (void) retainArguments;
+
+/*
+ *	Dispatching an Invocation.
+ */
+- (void) invoke;
+- (void) invokeWithTarget: (id)anObject;
+
+/*
+ *	Getting the method signature.
+ */
+- (NSMethodSignature*) methodSignature;
+
+@end
+
+#ifndef	NO_GNUSTEP
+@interface NSInvocation (GNUstep)
+- (id) initWithArgframe: (arglist_t)frame selector: (SEL)aSelector;
+- (id) initWithMethodSignature: (NSMethodSignature*)aSignature;
+- (id) initWithSelector: (SEL)aSelector;
+- (id) initWithTarget: (id)anObject selector: (SEL)aSelector, ...;
+- (void*) returnFrame: (arglist_t)argFrame;
+- (BOOL) sendsToSuper;
+- (void) setSendsToSuper: (BOOL)flag;
+@end
+#endif
+
+/* Do NOT use these methods ... internal use only ... not public API */
+@interface NSInvocation (MacroSetup)
++ (id) _newProxyForInvocation: (id)target;
++ (id) _newProxyForMessage: (id)target;
++ (NSInvocation*) _returnInvocationAndDestroyProxy: (id)proxy;
+@end
+
+/**
+ *  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(class, message...) ({\
+  id __proxy = [NSInvocation _newProxyForInvocation: class]; \
+  [__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]; \
+})
+
+#endif /* __NSInvocation_h_GNUSTEP_BASE_INCLUDE */
+