e976a775e2
* libobjc/objc/deprecated: New directory. * libobjc/objc/deprecated/README: New file. * libobjc/objc/README: New file. * libobjc/objc/typedstream.h: Moved into objc/deprecated/typedstream.h; objc/typedstream.h replaced with a placeholder including the file from the deprecated/ directory. * libobjc/objc/deprecated/objc-unexpected-exception.h: New file with the definition of _objc_unexpected_exception. * libobjc/objc/objc-api.h: Include deprecated/objc-unexcepted-exception.h instead of defining _objc_unexpected_exception. * libobjc/objc/deprecated/Object.h: New file with the deprecated Object methods in a 'Deprecated' category. * libobjc/objc/Object.h Include deprecated/Object.h instead of defining the deprecated methods. * libobjc/Object.m: Moved deprecated methods into 'Deprecated' category. * libobjc/objc-private: New directory. * libobjc/objc-private/README: New file. * libobjc/Makefile.in (OBJC_DEPRECATED_H): New variable. (install-headers): Create installation directory for OBJC_DEPRECATED_H headers, and install them. From-SVN: r164153
142 lines
3.8 KiB
Objective-C
142 lines
3.8 KiB
Objective-C
/* Interface for the Object class for Objective-C.
|
|
Copyright (C) 1993, 1994, 1995, 2009, 2010 Free Software Foundation, Inc.
|
|
|
|
This file is part of GCC.
|
|
|
|
GCC is free software; you can redistribute it and/or modify it
|
|
under the terms of the GNU General Public License as published by the
|
|
Free Software Foundation; either version 3, or (at your option) any
|
|
later version.
|
|
|
|
GCC 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 General Public
|
|
License for more details.
|
|
|
|
Under Section 7 of GPL version 3, you are granted additional
|
|
permissions described in the GCC Runtime Library Exception, version
|
|
3.1, as published by the Free Software Foundation.
|
|
|
|
You should have received a copy of the GNU General Public License and
|
|
a copy of the GCC Runtime Library Exception along with this program;
|
|
see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
|
|
<http://www.gnu.org/licenses/>. */
|
|
|
|
|
|
#ifndef __object_INCLUDE_GNU
|
|
#define __object_INCLUDE_GNU
|
|
|
|
#include "objc.h"
|
|
#include "typedstream.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* The Object class is a minimal (but fully functional) root class
|
|
included with the runtime.
|
|
|
|
It is mostly for testing the runtime; very handy in configure
|
|
tests, and when writing language/runtime testcases.
|
|
|
|
Because Objective-C allows multiple root classes, a Foundation
|
|
library (such as GNUstep Base) is expected to provide its own root
|
|
class (typically called NSObject), fully integrated with the
|
|
library's own high-level features. If you are using such a
|
|
Foundation library, you should most likely use its root class for
|
|
everything and ignore Object.
|
|
*/
|
|
|
|
/*
|
|
All classes are derived from Object. As such,
|
|
this is the overhead tacked onto those objects.
|
|
*/
|
|
@interface Object
|
|
{
|
|
Class isa; /* A pointer to the instance's class structure */
|
|
}
|
|
|
|
/* Initializing classes and instances */
|
|
+ initialize;
|
|
- init;
|
|
|
|
/* Creating, freeing, and copying instances */
|
|
+ new;
|
|
+ alloc;
|
|
- free;
|
|
- copy;
|
|
- shallowCopy;
|
|
- deepen;
|
|
- deepCopy;
|
|
|
|
/* Identifying classes */
|
|
- (Class)class;
|
|
- (Class)superClass;
|
|
- (MetaClass)metaClass;
|
|
- (const char *)name;
|
|
|
|
/* Identifying and comparing objects */
|
|
- self;
|
|
- (unsigned int)hash;
|
|
- (BOOL)isEqual:anObject;
|
|
- (int)compare:(id)anotherObject;
|
|
|
|
/* Testing object type */
|
|
- (BOOL)isMetaClass;
|
|
- (BOOL)isClass;
|
|
- (BOOL)isInstance;
|
|
|
|
/* Testing inheritance relationships */
|
|
- (BOOL)isKindOf:(Class)aClassObject;
|
|
- (BOOL)isMemberOf:(Class)aClassObject;
|
|
- (BOOL)isKindOfClassNamed:(const char *)aClassName;
|
|
- (BOOL)isMemberOfClassNamed:(const char *)aClassName;
|
|
|
|
/* Testing class functionality */
|
|
+ (BOOL)instancesRespondTo:(SEL)aSel;
|
|
- (BOOL)respondsTo:(SEL)aSel;
|
|
|
|
/* Testing protocol conformance */
|
|
- (BOOL)conformsTo:(Protocol*)aProtocol;
|
|
|
|
/* Introspection */
|
|
+ (IMP)instanceMethodFor:(SEL)aSel;
|
|
- (IMP)methodFor:(SEL)aSel;
|
|
+ (struct objc_method_description *)descriptionForInstanceMethod:(SEL)aSel;
|
|
- (struct objc_method_description *)descriptionForMethod:(SEL)aSel;
|
|
|
|
/* Sending messages determined at run time */
|
|
- perform:(SEL)aSel;
|
|
- perform:(SEL)aSel with:anObject;
|
|
- perform:(SEL)aSel with:anObject1 with:anObject2;
|
|
|
|
/* Forwarding */
|
|
- (retval_t)forward:(SEL)aSel :(arglist_t)argFrame;
|
|
- (retval_t)performv:(SEL)aSel :(arglist_t)argFrame;
|
|
|
|
/* Posing */
|
|
+ poseAs:(Class)aClassObject;
|
|
- (Class)transmuteClassTo:(Class)aClassObject;
|
|
|
|
/* Enforcing intentions */
|
|
- subclassResponsibility:(SEL)aSel;
|
|
- notImplemented:(SEL)aSel;
|
|
- shouldNotImplement:(SEL)aSel;
|
|
|
|
/* Error handling */
|
|
- doesNotRecognize:(SEL)aSel;
|
|
- error:(const char *)aString, ...;
|
|
|
|
/* Archiving */
|
|
+ (int)version;
|
|
+ setVersion:(int)aVersion;
|
|
@end
|
|
|
|
#include "deprecated/Object.h"
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|