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-2017 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