1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
//---------------------------------------------------------------------------------------
// EDCommonDefines.h created by erik on Fri 28-Mar-1997
// @(#)$Id: EDCommonDefines.h,v 2.0 2002/08/16 18:12:43 erik Exp $
//
// Copyright (c) 1997-2000 by Erik Doernenburg. All rights reserved.
//
// Permission to use, copy, modify and distribute this software and its documentation
// is hereby granted, provided that both the copyright notice and this permission
// notice appear in all copies of the software, derivative works or modified versions,
// and any portions thereof, and that both notices appear in supporting documentation,
// and that credit is given to Erik Doernenburg in all documents and publicity
// pertaining to direct or indirect use of this code or its derivatives.
//
// THIS IS EXPERIMENTAL SOFTWARE AND IT IS KNOWN TO HAVE BUGS, SOME OF WHICH MAY HAVE
// SERIOUS CONSEQUENCES. THE COPYRIGHT HOLDER ALLOWS FREE USE OF THIS SOFTWARE IN ITS
// "AS IS" CONDITION. THE COPYRIGHT HOLDER DISCLAIMS ANY LIABILITY OF ANY KIND FOR ANY
// DAMAGES WHATSOEVER RESULTING DIRECTLY OR INDIRECTLY FROM THE USE OF THIS SOFTWARE
// OR OF ANY DERIVATIVE WORK.
//---------------------------------------------------------------------------------------
#ifndef __EDCommonDefines_h_INCLUDE
#define __EDCommonDefines_h_INCLUDE
// Defines to handle extern declarations on different platforms
/*" Ignore this stuff. It is needed thanks to Microsoft's great DLL implementation. "*/
#if defined(__MACH__)
#ifdef __cplusplus
// This isnt extern "C" because the compiler will not allow this if it has
// seen an extern "Objective-C"
# define EDCOMMON_EXTERN extern
#else
# define EDCOMMON_EXTERN extern
#endif
#elif defined(WIN32)
#ifdef _BUILDING_EDCOMMON_DLL
# define EDCOMMON_DLL_GOOP __declspec(dllexport)
#else
# define EDCOMMON_DLL_GOOP __declspec(dllimport)
#endif
#ifdef __cplusplus
# define EDCOMMON_EXTERN extern "C" EDCOMMON_DLL_GOOP
#else
# define EDCOMMON_EXTERN EDCOMMON_DLL_GOOP extern
#endif
#else
#ifdef __cplusplus
# define EDCOMMON_EXTERN extern "C"
#else
# define EDCOMMON_EXTERN extern
#endif
#endif
/*" Use this if you want to say neither YES nor NO... "*/
#define UNKNOWN 2
/*" A shortcut to get the default notification center "*/
#define DNC [NSNotificationCenter defaultCenter]
/*" A shortcut to get the standard user defaults "*/
#define DEFAULTS [NSUserDefaults standardUserDefaults]
/*" A shortcut to instantiate a CalendarDate object containing the current time and date "*/
#define NOW [NSCalendarDate calendarDate]
// A really useful data type
typedef unsigned char byte;
// A macro to do asserted casts
/*" Don't call this directly. "*/
static __inline__ id EDCast(id object, Class aClass, SEL cmd, id self, const char *file, int line)
{
if((object != nil) && ([object isKindOfClass:aClass] == NO))
[[NSAssertionHandler currentHandler] handleFailureInMethod:cmd object:self file:[NSString stringWithCString:file] lineNumber:line description:@"cast failure; cannot cast instance of %@ to %@", NSStringFromClass([object class]), NSStringFromClass(aClass)];
return object;
}
/*" Use this to cast an object pointer to a specific class, eg. !{myString = CAST([array lastObject], NSString)}, asserting that the object really is an instance of the class or one of its subclasses. Raises if the assertion fails."*/
#define CAST(ID, CLASSNAME) \
((CLASSNAME *)EDCast(ID, [CLASSNAME class], _cmd, self, __FILE__, __LINE__))
/*" A global variable that determines the output generated by the log macros. "*/
EDCOMMON_EXTERN unsigned int EDLogMask;
// Macros to conditionally print messages. This looks scary and is in fact a
// bad C hack. It is done because this is the only way to prevent the arguments
// from even being created if no output would be made anyway. If this would
// be implemented as a function and called like, say,
// EDLog1(4, @"array = %@", [array description])
// then a poentially large description of the array would be created just
// to be discarded if the log mask does not include the area in question.
// On the downside, variable argument lists don't work and hence the number of
// parameters must be given with the macro name.
/*" Function pointer to the function used by the log macros. #NSLog by default. Note that the function does not have to be able to deal with variable arg lists; it is always called with excatly on string argument."*/
EDCOMMON_EXTERN void (*_EDLogFunction)(NSString *);
/*" Don't call this directly. "*/
#define EDLogBody(area, format, arg1, arg2, arg3, arg4) \
do { \
if(EDLogMask & area) \
(*_EDLogFunction)([NSString stringWithFormat:format, arg1, arg2, arg3, arg4]); \
} while(0)
/*" Log text with format %f and arguments %argN with the logmask specified in %{l}. If !{l & EDLogMask !== 0} the output is supressed and in this case none of the strings are needed. This means that you can pass !{[myObject description]} and the method is only invoked if the output is required."*/
#define EDLog(l, f) EDLogBody((l), (f), 0, 0, 0, 0)
#define EDLog1(l, f, arg1) EDLogBody((l), (f), arg1, 0, 0, 0)
#define EDLog2(l, f, arg1, arg2) EDLogBody((l), (f), arg1, arg2, 0, 0)
#define EDLog3(l, f, arg1, arg2, arg3) EDLogBody((l), (f), arg1, arg2, arg3, 0)
#define EDLog4(l, f, arg1, arg2, arg3, arg4) EDLogBody((l), (f), arg1, arg2, arg3, arg4)
#endif /* __EDCommonDefines_h_INCLUDE */
|
