Changeset 85092 in vbox

Timestamp:

Jul 7, 2020 6:22:33 PM (4 years ago)

Author:

vboxsync

Message:

iprt/cdefs.h: Introducing DECL_HIDDEN_NOTHROW for use on functions (couldn't make nothrow fit into the existing DECLHIDDEN as it is applied to data as well as functions). Corrected DECL_FORCE_INLINE to imply nothrow just like DECLINLINE, adding DECL_FORCE_INLINE_THROW in case anyone ever needs it. bugref:9794

File:

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

trunk/include/iprt/cdefs.h

@@ -1374 +1374 @@
 #endif
 
+/** @def DECL_HIDDEN_NOTHROW
+ * How to declare a non-exported function that does not throw C++ exceptions.
+ * @param   type    The return type of the function or the data type of the variable.
+ */
+#define DECL_HIDDEN_NOTHROW(a_Type) DECL_NOTHROW(DECLHIDDEN(a_Type))
+
 /** @def DECL_INVALID
  * How to declare a function not available for linking in the current context.
@@ -1403 +1409 @@
  * @param   type    The return type of the function.
  */
-#define DECLASMTYPE(type)       DECL_NOTHROW(type RTCALL)
+#define DECLASMTYPE(type)       DECL_NOTHROW_TYPEDEF(type RTCALL)
 
 /** @def RT_ASM_DECL_PRAGMA_WATCOM
@@ -1583 +1589 @@
 
 /** @def DECL_FORCE_INLINE
- * How to declare a function as inline and try convince the compiler to always
- * inline it regardless of optimization switches.
+ * How to declare a function that does not throw any C++ exceptions as inline
+ * and try convince the compiler to always inline it regardless of optimization
+ * switches.
  * @param   type    The return type of the function declaration.
  * @remarks Use sparsely and with care. Don't use this macro on C++ methods.
+ * @sa      DECL_FORCE_INLINE_THROW
  */
 #ifdef __GNUC__
 # define DECL_FORCE_INLINE(type)    __attribute__((__always_inline__)) DECLINLINE(type)
 #elif defined(_MSC_VER)
-# define DECL_FORCE_INLINE(type)    __forceinline type
+# define DECL_FORCE_INLINE(type)    DECL_NOTHROW(__forceinline type)
 #else
 # define DECL_FORCE_INLINE(type)    DECLINLINE(type)
+#endif
+
+/** @def DECL_FORCE_INLINE_THROW
+ * How to declare a function throwing C++ exceptions as inline and try convince
+ * the compiler to always inline it regardless of optimization switches.
+ * @param   type    The return type of the function declaration.
+ * @remarks Use sparsely and with care. Don't use this macro on C++ methods.
+ */
+#ifdef __GNUC__
+# define DECL_FORCE_INLINE_THROW(type)  __attribute__((__always_inline__)) DECL_INLINE_THROW(type)
+#elif defined(_MSC_VER)
+# define DECL_FORCE_INLINE_THROW(type)  __forceinline type
+#else
+# define DECL_FORCE_INLINE_THROW(type)  DECL_INLINE_THROW(type)
 #endif