NVIDIA(R) PhysX(R) SDK 3.4 API Reference: PxAssert.h Source File

00001 // This code contains NVIDIA Confidential Information and is disclosed to you
+00002 // under a form of NVIDIA software license agreement provided separately to you.
+00003 //
+00004 // Notice
+00005 // NVIDIA Corporation and its licensors retain all intellectual property and
+00006 // proprietary rights in and to this software and related documentation and
+00007 // any modifications thereto. Any use, reproduction, disclosure, or
+00008 // distribution of this software and related documentation without an express
+00009 // license agreement from NVIDIA Corporation is strictly prohibited.
+00010 //
+00011 // ALL NVIDIA DESIGN SPECIFICATIONS, CODE ARE PROVIDED "AS IS.". NVIDIA MAKES
+00012 // NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO
+00013 // THE MATERIALS, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT,
+00014 // MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.
+00015 //
+00016 // Information and code furnished is believed to be accurate and reliable.
+00017 // However, NVIDIA Corporation assumes no responsibility for the consequences of use of such
+00018 // information or for any infringement of patents or other rights of third parties that may
+00019 // result from its use. No license is granted by implication or otherwise under any patent
+00020 // or patent rights of NVIDIA Corporation. Details are subject to change without notice.
+00021 // This code supersedes and replaces all information previously supplied.
+00022 // NVIDIA Corporation products are not authorized for use as critical
+00023 // components in life support devices or systems without express written approval of
+00024 // NVIDIA Corporation.
+00025 //
+00026 // Copyright (c) 2008-2016 NVIDIA Corporation. All rights reserved.
+00027 // Copyright (c) 2004-2008 AGEIA Technologies, Inc. All rights reserved.
+00028 // Copyright (c) 2001-2004 NovodeX AG. All rights reserved.
+00029 
+00030 #ifndef PXFOUNDATION_PXASSERT_H
+00031 #define PXFOUNDATION_PXASSERT_H
+00032 
+00036 #include "foundation/Px.h"
+00037 
+00038 #if !PX_DOXYGEN
+00039 namespace physx
+00040 {
+00041 #endif
+00042 
+00043 /* Base class to handle assert failures */
+00044 class PxAssertHandler
+00045 {
+00046   public:
+00047     virtual ~PxAssertHandler()
+00048     {
+00049     }
+00050     virtual void operator()(const char* exp, const char* file, int line, bool& ignore) = 0;
+00051 };
+00052 
+00053 PX_FOUNDATION_API PxAssertHandler& PxGetAssertHandler();
+00054 PX_FOUNDATION_API void PxSetAssertHandler(PxAssertHandler& handler);
+00055 
+00056 #if !PX_DOXYGEN
+00057 } // namespace physx
+00058 #endif
+00059 
+00060 #if !PX_ENABLE_ASSERTS
+00061 #define PX_ASSERT(exp) ((void)0)
+00062 #define PX_ALWAYS_ASSERT_MESSAGE(exp) ((void)0)
+00063 #define PX_ASSERT_WITH_MESSAGE(condition, message) ((void)0)
+00064 #else
+00065 #if PX_VC
+00066 #define PX_CODE_ANALYSIS_ASSUME(exp)                                                                                   \
+00067     __analysis_assume(!!(exp)) // This macro will be used to get rid of analysis warning messages if a PX_ASSERT is used
+00068 // to "guard" illegal mem access, for example.
+00069 #else
+00070 #define PX_CODE_ANALYSIS_ASSUME(exp)
+00071 #endif
+00072 #define PX_ASSERT(exp)                                                                                                 \
+00073     {                                                                                                                  \
+00074         static bool _ignore = false;                                                                                   \
+00075         ((void)((!!(exp)) || (!_ignore && (physx::PxGetAssertHandler()(#exp, __FILE__, __LINE__, _ignore), false))));  \
+00076         PX_CODE_ANALYSIS_ASSUME(exp);                                                                                  \
+00077     }
+00078 #define PX_ALWAYS_ASSERT_MESSAGE(exp)                                                                                  \
+00079     {                                                                                                                  \
+00080         static bool _ignore = false;                                                                                   \
+00081         if(!_ignore)                                                                                                   \
+00082             physx::PxGetAssertHandler()(exp, __FILE__, __LINE__, _ignore);                                             \
+00083     }
+00084 #define PX_ASSERT_WITH_MESSAGE(exp, message)                                                                             \
+00085     {                                                                                                                    \
+00086         static bool _ignore = false;                                                                                     \
+00087         ((void)((!!(exp)) || (!_ignore && (physx::PxGetAssertHandler()(message, __FILE__, __LINE__, _ignore), false)))); \
+00088         PX_CODE_ANALYSIS_ASSUME(exp);                                                                                    \
+00089     }
+00090 #endif
+00091 
+00092 #define PX_ALWAYS_ASSERT() PX_ASSERT(0)
+00093 
+00095 #endif // #ifndef PXFOUNDATION_PXASSERT_H
+