]>
git.saurik.com Git - apple/objc4.git/blob - runtime/objc-runtime.h
2 * Copyright (c) 1999 Apple Computer, Inc. All rights reserved.
4 * @APPLE_LICENSE_HEADER_START@
6 * Copyright (c) 1999-2003 Apple Computer, Inc. All Rights Reserved.
8 * This file contains Original Code and/or Modifications of Original Code
9 * as defined in and that are subject to the Apple Public Source License
10 * Version 2.0 (the 'License'). You may not use this file except in
11 * compliance with the License. Please obtain a copy of the License at
12 * http://www.opensource.apple.com/apsl/ and read it before using this
15 * The Original Code and all software distributed under the License are
16 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
17 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
18 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
20 * Please see the License for the specific language governing rights and
21 * limitations under the License.
23 * @APPLE_LICENSE_HEADER_END@
27 * Copyright 1988-1996, NeXT Software, Inc.
30 #ifndef _OBJC_RUNTIME_H_
31 #define _OBJC_RUNTIME_H_
34 #import <AvailabilityMacros.h>
36 #import <objc/objc-class.h>
38 #if !defined(AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER)
39 /* For 10.2 compatibility */
40 # define AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER
43 typedef struct objc_symtab
*Symtab
;
46 unsigned long sel_ref_cnt
;
48 unsigned short cls_def_cnt
;
49 unsigned short cat_def_cnt
;
50 void *defs
[1]; /* variable size */
53 typedef struct objc_module
*Module
;
56 unsigned long version
;
72 * Messaging Primitives (prototypes)
75 OBJC_EXPORT id
objc_getClass(const char *name
);
76 OBJC_EXPORT id
objc_getMetaClass(const char *name
);
77 OBJC_EXPORT id
objc_msgSend(id self
, SEL op
, ...);
78 OBJC_EXPORT id
objc_msgSendSuper(struct objc_super
*super
, SEL op
, ...);
81 /* Floating-point-returning Messaging Primitives (prototypes)
83 * On some platforms, the ABI for functions returning a floating-point
84 * value is incompatible with that for functions returning an integral type.
85 * objc_msgSend_fpret must be used for these.
87 * ppc: objc_msgSend_fpret not used
88 * ppc64: objc_msgSend_fpret not used
89 * i386: objc_msgSend_fpret REQUIRED
91 * For `float` or `long double` return types, cast the function
92 * to an appropriate function pointer type first.
96 OBJC_EXPORT
double objc_msgSend_fpret(id self
, SEL op
, ...);
100 /* Struct-returning Messaging Primitives (prototypes)
102 * For historical reasons, the prototypes for the struct-returning
103 * messengers are unusual. The portable, correct way to call these functions
104 * is to cast them to your desired return type first.
106 * For example, `NSRect result = [myNSView frame]` could be written as:
107 * NSRect (*msgSend_stret_fn)(id, SEL, ...) = (NSRect(*)(id, SEL, ...))objc_msgSend_stret;
108 * NSRect result = (*msgSend_stret_fn)(myNSView, @selector(frame));
109 * or, without the function pointer:
110 * NSRect result = (*(NSRect(*)(id, SEL, ...))objc_msgSend_stret)(myNSView, @selector(frame));
112 * BE WARNED that these prototypes have changed in the past and will change
113 * in the future. Code that uses a cast like the example above will be
117 #if defined(__cplusplus)
118 OBJC_EXPORT id
objc_msgSend_stret(id self
, SEL op
, ...);
119 OBJC_EXPORT id
objc_msgSendSuper_stret(struct objc_super
*super
, SEL op
, ...);
121 OBJC_EXPORT
void objc_msgSend_stret(void * stretAddr
, id self
, SEL op
, ...);
122 OBJC_EXPORT
void objc_msgSendSuper_stret(void * stretAddr
, struct objc_super
*super
, SEL op
, ...);
128 OBJC_EXPORT id
objc_msgSendv(id self
, SEL op
, unsigned arg_size
, marg_list arg_frame
);
129 OBJC_EXPORT
void objc_msgSendv_stret(void * stretAddr
, id self
, SEL op
, unsigned arg_size
, marg_list arg_frame
);
132 getting all the classes in the application...
134 int objc_getClassList(buffer, bufferLen)
135 classes is an array of Class values (which are pointers)
136 which will be filled by the function; if this
137 argument is NULL, no copying is done, only the
138 return value is returned
139 bufferLen is the number of Class values the given buffer
140 can hold; if the buffer is not large enough to
141 hold all the classes, the buffer is filled to
142 the indicated capacity with some arbitrary subset
143 of the known classes, which could be different
145 returns the number of classes, which is the number put
146 in the buffer if the buffer was large enough,
147 or the length the buffer should have been
149 int numClasses = 0, newNumClasses = objc_getClassList(NULL, 0);
150 Class *classes = NULL;
151 while (numClasses < newNumClasses) {
152 numClasses = newNumClasses;
153 classes = realloc(classes, sizeof(Class) * numClasses);
154 newNumClasses = objc_getClassList(classes, numClasses);
156 // now, can use the classes list; if NULL, there are no classes
160 OBJC_EXPORT
int objc_getClassList(Class
*buffer
, int bufferLen
);
162 #define OBSOLETE_OBJC_GETCLASSES 1
163 #if OBSOLETE_OBJC_GETCLASSES
164 OBJC_EXPORT
void *objc_getClasses(void);
167 OBJC_EXPORT id
objc_lookUpClass(const char *name
);
168 OBJC_EXPORT id
objc_getRequiredClass(const char *name
);
169 OBJC_EXPORT
void objc_addClass(Class myClass
);
171 /* customizing the error handling for objc_getClass/objc_getMetaClass */
173 OBJC_EXPORT
void objc_setClassHandler(int (*)(const char *));
175 /* Making the Objective-C runtime thread safe. */
176 OBJC_EXPORT
void objc_setMultithreaded (BOOL flag
);
178 /* overriding the default object allocation and error handling routines */
180 OBJC_EXPORT
id (*_alloc
)(Class
, unsigned int);
181 OBJC_EXPORT
id (*_copy
)(id
, unsigned int);
182 OBJC_EXPORT
id (*_realloc
)(id
, unsigned int);
183 OBJC_EXPORT
id (*_dealloc
)(id
);
184 OBJC_EXPORT
id (*_zoneAlloc
)(Class
, unsigned int, void *);
185 OBJC_EXPORT
id (*_zoneRealloc
)(id
, unsigned int, void *);
186 OBJC_EXPORT
id (*_zoneCopy
)(id
, unsigned int, void *);
188 OBJC_EXPORT
void (*_error
)(id
, const char *, va_list);
191 #endif /* _OBJC_RUNTIME_H_ */