15976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org/* 25976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * libjingle 35976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * Copyright 2004 Google Inc. 45976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * 55976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * Redistribution and use in source and binary forms, with or without 65976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * modification, are permitted provided that the following conditions are met: 75976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * 85976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * 1. Redistributions of source code must retain the above copyright notice, 95976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * this list of conditions and the following disclaimer. 105976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * 2. Redistributions in binary form must reproduce the above copyright notice, 115976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * this list of conditions and the following disclaimer in the documentation 125976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * and/or other materials provided with the distribution. 135976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * 3. The name of the author may not be used to endorse or promote products 145976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * derived from this software without specific prior written permission. 155976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * 165976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED 175976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 185976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 195976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 205976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 215976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 225976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 235976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 245976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 255976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 265976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org */ 275976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 285976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#ifndef TALK_BASE_COMMON_H_ 295976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define TALK_BASE_COMMON_H_ 305976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 315976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#include "talk/base/basictypes.h" 325976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#include "talk/base/constructormagic.h" 335976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 345976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#if defined(_MSC_VER) 355976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// warning C4355: 'this' : used in base member initializer list 365976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#pragma warning(disable:4355) 375976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif 385976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 395976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org////////////////////////////////////////////////////////////////////// 405976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// General Utilities 415976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org////////////////////////////////////////////////////////////////////// 425976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 435976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// Note: UNUSED is also defined in basictypes.h 445976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#ifndef UNUSED 455976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define UNUSED(x) Unused(static_cast<const void*>(&x)) 465976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define UNUSED2(x, y) Unused(static_cast<const void*>(&x)); \ 475976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org Unused(static_cast<const void*>(&y)) 485976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define UNUSED3(x, y, z) Unused(static_cast<const void*>(&x)); \ 495976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org Unused(static_cast<const void*>(&y)); \ 505976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org Unused(static_cast<const void*>(&z)) 515976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define UNUSED4(x, y, z, a) Unused(static_cast<const void*>(&x)); \ 525976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org Unused(static_cast<const void*>(&y)); \ 535976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org Unused(static_cast<const void*>(&z)); \ 545976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org Unused(static_cast<const void*>(&a)) 555976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define UNUSED5(x, y, z, a, b) Unused(static_cast<const void*>(&x)); \ 565976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org Unused(static_cast<const void*>(&y)); \ 575976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org Unused(static_cast<const void*>(&z)); \ 585976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org Unused(static_cast<const void*>(&a)); \ 595976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org Unused(static_cast<const void*>(&b)) 605976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.orginline void Unused(const void*) {} 615976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif // UNUSED 625976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 635976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#ifndef WIN32 645976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define strnicmp(x, y, n) strncasecmp(x, y, n) 655976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define stricmp(x, y) strcasecmp(x, y) 665976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 675976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// TODO: Remove this. std::max should be used everywhere in the code. 685976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// NOMINMAX must be defined where we include <windows.h>. 695976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define stdmax(x, y) std::max(x, y) 705976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#else 715976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define stdmax(x, y) talk_base::_max(x, y) 725976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif 735976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 745976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define ARRAY_SIZE(x) (static_cast<int>(sizeof(x) / sizeof(x[0]))) 755976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 765976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org///////////////////////////////////////////////////////////////////////////// 775976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// Assertions 785976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org///////////////////////////////////////////////////////////////////////////// 795976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 805976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#ifndef ENABLE_DEBUG 815976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define ENABLE_DEBUG _DEBUG 825976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif // !defined(ENABLE_DEBUG) 835976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 845976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// Even for release builds, allow for the override of LogAssert. Though no 855976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// macro is provided, this can still be used for explicit runtime asserts 865976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// and allow applications to override the assert behavior. 875976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 885976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.orgnamespace talk_base { 895976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 905976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// LogAssert writes information about an assertion to the log. It's called by 915976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// Assert (and from the ASSERT macro in debug mode) before any other action 925976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// is taken (e.g. breaking the debugger, abort()ing, etc.). 935976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.orgvoid LogAssert(const char* function, const char* file, int line, 945976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org const char* expression); 955976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 965976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.orgtypedef void (*AssertLogger)(const char* function, 975976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org const char* file, 985976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org int line, 995976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org const char* expression); 1005976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1015976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// Sets a custom assert logger to be used instead of the default LogAssert 1025976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// behavior. To clear the custom assert logger, pass NULL for |logger| and the 1035976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// default behavior will be restored. Only one custom assert logger can be set 1045976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// at a time, so this should generally be set during application startup and 1055976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// only by one component. 1065976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.orgvoid SetCustomAssertLogger(AssertLogger logger); 1075976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1085976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org} // namespace talk_base 1095976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1105976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1115976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#if ENABLE_DEBUG 1125976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1135976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.orgnamespace talk_base { 1145976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 115b30f5947ff2af0e3b77751bacec5dc7350c4dcd6sergeyu@chromium.org// If a debugger is attached, triggers a debugger breakpoint. If a debugger is 116b30f5947ff2af0e3b77751bacec5dc7350c4dcd6sergeyu@chromium.org// not attached, forces program termination. 1175976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.orgvoid Break(); 1185976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1195976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.orginline bool Assert(bool result, const char* function, const char* file, 1205976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org int line, const char* expression) { 1215976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org if (!result) { 1225976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org LogAssert(function, file, line, expression); 1235976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org Break(); 1245976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org return false; 1255976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org } 1265976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org return true; 1275976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org} 1285976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1295976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org} // namespace talk_base 1305976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1315976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#if defined(_MSC_VER) && _MSC_VER < 1300 1325976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define __FUNCTION__ "" 1335976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif 1345976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1355976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#ifndef ASSERT 1365976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define ASSERT(x) \ 1375976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org (void)talk_base::Assert((x), __FUNCTION__, __FILE__, __LINE__, #x) 1385976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif 1395976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1405976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#ifndef VERIFY 1415976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define VERIFY(x) talk_base::Assert((x), __FUNCTION__, __FILE__, __LINE__, #x) 1425976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif 1435976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1445976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#else // !ENABLE_DEBUG 1455976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1465976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.orgnamespace talk_base { 1475976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1485976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.orginline bool ImplicitCastToBool(bool result) { return result; } 1495976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1505976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org} // namespace talk_base 1515976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1525976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#ifndef ASSERT 1535976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define ASSERT(x) (void)0 1545976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif 1555976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1565976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#ifndef VERIFY 1575976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define VERIFY(x) talk_base::ImplicitCastToBool(x) 1585976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif 1595976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1605976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif // !ENABLE_DEBUG 1615976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1625976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define COMPILE_TIME_ASSERT(expr) char CTA_UNIQUE_NAME[expr] 1635976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define CTA_UNIQUE_NAME CTA_MAKE_NAME(__LINE__) 1645976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define CTA_MAKE_NAME(line) CTA_MAKE_NAME2(line) 1655976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define CTA_MAKE_NAME2(line) constraint_ ## line 1665976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1675976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// Forces compiler to inline, even against its better judgement. Use wisely. 1685976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#if defined(__GNUC__) 1695976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define FORCE_INLINE __attribute__((always_inline)) 1705976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#elif defined(WIN32) 1715976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define FORCE_INLINE __forceinline 1725976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#else 1735976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define FORCE_INLINE 1745976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif 1755976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1765976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// Borrowed from Chromium's base/compiler_specific.h. 1775976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// Annotate a virtual method indicating it must be overriding a virtual 1785976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// method in the parent class. 1795976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// Use like: 1805976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org// virtual void foo() OVERRIDE; 1815976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#if defined(WIN32) 1825976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define OVERRIDE override 1835976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#elif defined(__clang__) 1845976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define OVERRIDE override 1855976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#else 1865976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#define OVERRIDE 1875976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif 1885976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org 1895976650443d68ccfadf1dea24999ee459dd2819mflodman@webrtc.org#endif // TALK_BASE_COMMON_H_ 190