Changeset 21390 in vbox

Timestamp:

Jul 8, 2009 12:17:50 PM (16 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

49759

Message:

iprt/cdefs.h: RT_EXCEPTIONS_ENABLED, RT_THROW and RT_THROW_BAD_ALLOC.

File:

• trunk/include/iprt/cdefs.h (modified) (3 diffs)

trunk/include/iprt/cdefs.h

@@ -86 +86 @@
 #define Breakpoint
 #define RT_NO_DEPRECATED_MACROS
+#define RT_EXCEPTIONS_ENABLED
 #endif /* DOXYGEN_RUNNING */
 
@@ -482 +483 @@
 #define RT_NOTHING
 
-
-/** @def RTCALL
- * The standard calling convention for the Runtime interfaces.
- */
-#ifdef _MSC_VER
-# define RTCALL     __cdecl
-#elif defined(__GNUC__) && defined(IN_RING0) && !(defined(RT_OS_OS2) || defined(RT_ARCH_AMD64)) /* the latter is kernel/gcc */
-# define RTCALL     __attribute__((cdecl,regparm(0)))
-#else
-# define RTCALL
+/** @def RT_EXCEPTIONS_ENABLED
+ * Defined when C++ exceptions are enabled.
+ */
+#if !defined(RT_EXCEPTIONS_ENABLED) \
+ &&  defined(__cplusplus) \
+ && (   (defined(_MSC_VER) && defined(_CPPUNWIND)) \
+     || (defined(__GNUC__) && defined(__EXCEPTIONS)))
+# define RT_EXCEPTIONS_ENABLED
 #endif
 
@@ -500 +499 @@
  * and the semicolon in function prototypes (and implementation if C++).
  */
-#if defined(__cplusplus) \
- && (   (defined(_MSC_VER) && defined(_CPPUNWIND)) \
-     || (defined(__GNUC__) && defined(__EXCEPTIONS)))
-# define RT_NO_THROW    throw()
+#ifdef RT_EXCEPTIONS_ENABLED
+# define RT_NO_THROW            throw()
 #else
 # define RT_NO_THROW
+#endif
+
+/** @def RT_THROW
+ * How to express that a method or function throws a type of exceptions.
+ *
+ * @param   type    The type exception.
+ *
+ * @remarks If the actual throwing is done from the header, enclose it by
+ *          \#ifdef RT_EXCEPTIONS_ENABLED ... \#else ... \#endif so the header
+ *          compiles cleanly without exceptions enabled.
+ *
+ * @remarks Do NOT use this for the actual throwing of exceptions!
+ */
+#ifdef RT_EXCEPTIONS_ENABLED
+# define RT_THROW(type)         throw(type)
+#else
+# define RT_THROW(type)
+#endif
+
+/** @def RT_THROW_BAD_ALLOC
+ * How to express that a method or function throws a std::bad_alloc exception.
+ */
+#ifdef RT_EXCEPTIONS_ENABLED
+# define RT_THROW_BAD_ALLOC     throw(std::bad_alloc)
+#else
+# define RT_THROW_BAD_ALLOC
+#endif
+
+/** @def RTCALL
+ * The standard calling convention for the Runtime interfaces.
+ */
+#ifdef _MSC_VER
+# define RTCALL     __cdecl
+#elif defined(__GNUC__) && defined(IN_RING0) && !(defined(RT_OS_OS2) || defined(RT_ARCH_AMD64)) /* the latter is kernel/gcc */
+# define RTCALL     __attribute__((cdecl,regparm(0)))
+#else
+# define RTCALL
 #endif