| 1 | /* |
| 2 | * Name: wx/cpp.h |
| 3 | * Purpose: Various preprocessor helpers |
| 4 | * Author: Vadim Zeitlin |
| 5 | * Created: 2006-09-30 |
| 6 | * RCS-ID: $Id$ |
| 7 | * Copyright: (c) 2006 Vadim Zeitlin <vadim@wxwindows.org> |
| 8 | * Licence: wxWindows licence |
| 9 | */ |
| 10 | |
| 11 | /* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */ |
| 12 | |
| 13 | #ifndef _WX_CPP_H_ |
| 14 | #define _WX_CPP_H_ |
| 15 | |
| 16 | /* wxCONCAT works like preprocessor ## operator but also works with macros */ |
| 17 | #define wxCONCAT_HELPER(text, line) text ## line |
| 18 | #define wxCONCAT(text, line) wxCONCAT_HELPER(text, line) |
| 19 | |
| 20 | #define wxCONCAT3(x1, x2, x3) wxCONCAT(wxCONCAT(x1, x2), x3) |
| 21 | #define wxCONCAT4(x1, x2, x3, x4) wxCONCAT(wxCONCAT3(x1, x2, x3), x4) |
| 22 | #define wxCONCAT5(x1, x2, x3, x4, x5) wxCONCAT(wxCONCAT4(x1, x2, x3, x4), x5) |
| 23 | |
| 24 | /* wxSTRINGIZE works as the preprocessor # operator but also works with macros */ |
| 25 | #define wxSTRINGIZE_HELPER(x) #x |
| 26 | #define wxSTRINGIZE(x) wxSTRINGIZE_HELPER(x) |
| 27 | |
| 28 | /* a Unicode-friendly version of wxSTRINGIZE_T */ |
| 29 | #define wxSTRINGIZE_T(x) wxAPPLY_T(wxSTRINGIZE(x)) |
| 30 | |
| 31 | /* |
| 32 | Special workarounds for compilers with broken "##" operator. For all the |
| 33 | other ones we can just use it directly. |
| 34 | */ |
| 35 | #ifdef wxCOMPILER_BROKEN_CONCAT_OPER |
| 36 | #define wxPREPEND_L(x) L ## x |
| 37 | #define wxAPPEND_i64(x) x ## i64 |
| 38 | #define wxAPPEND_ui64(x) x ## ui64 |
| 39 | #endif /* wxCOMPILER_BROKEN_CONCAT_OPER */ |
| 40 | |
| 41 | /* |
| 42 | Helper macros for wxMAKE_UNIQUE_NAME: normally this works by appending the |
| 43 | current line number to the given identifier to reduce the probability of the |
| 44 | conflict (it may still happen if this is used in the headers, hence you |
| 45 | should avoid doing it or provide unique prefixes then) but we have to do it |
| 46 | differently for VC++ |
| 47 | */ |
| 48 | #if defined(__VISUALC__) && (__VISUALC__ >= 1300) |
| 49 | /* |
| 50 | __LINE__ handling is completely broken in VC++ when using "Edit and |
| 51 | Continue" (/ZI option) and results in preprocessor errors if we use it |
| 52 | inside the macros. Luckily VC7 has another standard macro which can be |
| 53 | used like this and is even better than __LINE__ because it is globally |
| 54 | unique. |
| 55 | */ |
| 56 | # define wxCONCAT_LINE(text) wxCONCAT(text, __COUNTER__) |
| 57 | #else /* normal compilers */ |
| 58 | # define wxCONCAT_LINE(text) wxCONCAT(text, __LINE__) |
| 59 | #endif |
| 60 | |
| 61 | /* Create a "unique" name with the given prefix */ |
| 62 | #define wxMAKE_UNIQUE_NAME(text) wxCONCAT_LINE(text) |
| 63 | |
| 64 | /* |
| 65 | This macro can be passed as argument to another macro when you don't have |
| 66 | anything to pass in fact. |
| 67 | */ |
| 68 | #define wxEMPTY_PARAMETER_VALUE /* Fake macro parameter value */ |
| 69 | |
| 70 | /* |
| 71 | Define __WXFUNCTION__ which is like standard __FUNCTION__ but defined as |
| 72 | NULL for the compilers which don't support the latter. |
| 73 | */ |
| 74 | #ifndef __WXFUNCTION__ |
| 75 | /* TODO: add more compilers supporting __FUNCTION__ */ |
| 76 | #if defined(__DMC__) |
| 77 | /* |
| 78 | __FUNCTION__ happens to be not defined within class members |
| 79 | http://www.digitalmars.com/drn-bin/wwwnews?c%2B%2B.beta/485 |
| 80 | */ |
| 81 | #define __WXFUNCTION__ (NULL) |
| 82 | #elif defined(__GNUC__) || \ |
| 83 | (defined(_MSC_VER) && _MSC_VER >= 1300) || \ |
| 84 | defined(__FUNCTION__) |
| 85 | #define __WXFUNCTION__ __FUNCTION__ |
| 86 | #else |
| 87 | /* still define __WXFUNCTION__ to avoid #ifdefs elsewhere */ |
| 88 | #define __WXFUNCTION__ (NULL) |
| 89 | #endif |
| 90 | #endif /* __WXFUNCTION__ already defined */ |
| 91 | |
| 92 | #endif /* _WX_CPP_H_ */ |
| 93 | |