1 // Copyright 2005, Google Inc. 2 // All rights reserved. 3 // 4 // Redistribution and use in source and binary forms, with or without 5 // modification, are permitted provided that the following conditions are 6 // met: 7 // 8 // * Redistributions of source code must retain the above copyright 9 // notice, this list of conditions and the following disclaimer. 10 // * Redistributions in binary form must reproduce the above 11 // copyright notice, this list of conditions and the following disclaimer 12 // in the documentation and/or other materials provided with the 13 // distribution. 14 // * Neither the name of Google Inc. nor the names of its 15 // contributors may be used to endorse or promote products derived from 16 // this software without specific prior written permission. 17 // 18 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 21 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 22 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 23 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 24 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 26 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 28 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29 // 30 // Authors: wan (at) google.com (Zhanyong Wan) 31 // 32 // Low-level types and utilities for porting Google Test to various 33 // platforms. They are subject to change without notice. DO NOT USE 34 // THEM IN USER CODE. 35 36 #ifndef GTEST_INCLUDE_GTEST_INTERNAL_GTEST_PORT_H_ 37 #define GTEST_INCLUDE_GTEST_INTERNAL_GTEST_PORT_H_ 38 39 // The user can define the following macros in the build script to 40 // control Google Test's behavior. If the user doesn't define a macro 41 // in this list, Google Test will define it. 42 // 43 // GTEST_HAS_CLONE - Define it to 1/0 to indicate that clone(2) 44 // is/isn't available. 45 // GTEST_HAS_EXCEPTIONS - Define it to 1/0 to indicate that exceptions 46 // are enabled. 47 // GTEST_HAS_GLOBAL_STRING - Define it to 1/0 to indicate that ::string 48 // is/isn't available (some systems define 49 // ::string, which is different to std::string). 50 // GTEST_HAS_GLOBAL_WSTRING - Define it to 1/0 to indicate that ::string 51 // is/isn't available (some systems define 52 // ::wstring, which is different to std::wstring). 53 // GTEST_HAS_POSIX_RE - Define it to 1/0 to indicate that POSIX regular 54 // expressions are/aren't available. 55 // GTEST_HAS_PTHREAD - Define it to 1/0 to indicate that <pthread.h> 56 // is/isn't available. 57 // GTEST_HAS_RTTI - Define it to 1/0 to indicate that RTTI is/isn't 58 // enabled. 59 // GTEST_HAS_STD_WSTRING - Define it to 1/0 to indicate that 60 // std::wstring does/doesn't work (Google Test can 61 // be used where std::wstring is unavailable). 62 // GTEST_HAS_TR1_TUPLE - Define it to 1/0 to indicate tr1::tuple 63 // is/isn't available. 64 // GTEST_HAS_SEH - Define it to 1/0 to indicate whether the 65 // compiler supports Microsoft's "Structured 66 // Exception Handling". 67 // GTEST_HAS_STREAM_REDIRECTION 68 // - Define it to 1/0 to indicate whether the 69 // platform supports I/O stream redirection using 70 // dup() and dup2(). 71 // GTEST_USE_OWN_TR1_TUPLE - Define it to 1/0 to indicate whether Google 72 // Test's own tr1 tuple implementation should be 73 // used. Unused when the user sets 74 // GTEST_HAS_TR1_TUPLE to 0. 75 // GTEST_LINKED_AS_SHARED_LIBRARY 76 // - Define to 1 when compiling tests that use 77 // Google Test as a shared library (known as 78 // DLL on Windows). 79 // GTEST_CREATE_SHARED_LIBRARY 80 // - Define to 1 when compiling Google Test itself 81 // as a shared library. 82 83 // This header defines the following utilities: 84 // 85 // Macros indicating the current platform (defined to 1 if compiled on 86 // the given platform; otherwise undefined): 87 // GTEST_OS_AIX - IBM AIX 88 // GTEST_OS_CYGWIN - Cygwin 89 // GTEST_OS_HAIKU - Haiku 90 // GTEST_OS_HPUX - HP-UX 91 // GTEST_OS_LINUX - Linux 92 // GTEST_OS_LINUX_ANDROID - Google Android 93 // GTEST_OS_MAC - Mac OS X 94 // GTEST_OS_NACL - Google Native Client (NaCl) 95 // GTEST_OS_SOLARIS - Sun Solaris 96 // GTEST_OS_SYMBIAN - Symbian 97 // GTEST_OS_WINDOWS - Windows (Desktop, MinGW, or Mobile) 98 // GTEST_OS_WINDOWS_DESKTOP - Windows Desktop 99 // GTEST_OS_WINDOWS_MINGW - MinGW 100 // GTEST_OS_WINDOWS_MOBILE - Windows Mobile 101 // GTEST_OS_ZOS - z/OS 102 // 103 // Among the platforms, Cygwin, Linux, Max OS X, and Windows have the 104 // most stable support. Since core members of the Google Test project 105 // don't have access to other platforms, support for them may be less 106 // stable. If you notice any problems on your platform, please notify 107 // googletestframework (at) googlegroups.com (patches for fixing them are 108 // even more welcome!). 109 // 110 // Note that it is possible that none of the GTEST_OS_* macros are defined. 111 // 112 // Macros indicating available Google Test features (defined to 1 if 113 // the corresponding feature is supported; otherwise undefined): 114 // GTEST_HAS_COMBINE - the Combine() function (for value-parameterized 115 // tests) 116 // GTEST_HAS_DEATH_TEST - death tests 117 // GTEST_HAS_PARAM_TEST - value-parameterized tests 118 // GTEST_HAS_TYPED_TEST - typed tests 119 // GTEST_HAS_TYPED_TEST_P - type-parameterized tests 120 // GTEST_USES_POSIX_RE - enhanced POSIX regex is used. Do not confuse with 121 // GTEST_HAS_POSIX_RE (see above) which users can 122 // define themselves. 123 // GTEST_USES_SIMPLE_RE - our own simple regex is used; 124 // the above two are mutually exclusive. 125 // GTEST_CAN_COMPARE_NULL - accepts untyped NULL in EXPECT_EQ(). 126 // 127 // Macros for basic C++ coding: 128 // GTEST_AMBIGUOUS_ELSE_BLOCKER_ - for disabling a gcc warning. 129 // GTEST_ATTRIBUTE_UNUSED_ - declares that a class' instances or a 130 // variable don't have to be used. 131 // GTEST_DISALLOW_ASSIGN_ - disables operator=. 132 // GTEST_DISALLOW_COPY_AND_ASSIGN_ - disables copy ctor and operator=. 133 // GTEST_MUST_USE_RESULT_ - declares that a function's result must be used. 134 // 135 // Synchronization: 136 // Mutex, MutexLock, ThreadLocal, GetThreadCount() 137 // - synchronization primitives. 138 // GTEST_IS_THREADSAFE - defined to 1 to indicate that the above 139 // synchronization primitives have real implementations 140 // and Google Test is thread-safe; or 0 otherwise. 141 // 142 // Template meta programming: 143 // is_pointer - as in TR1; needed on Symbian and IBM XL C/C++ only. 144 // IteratorTraits - partial implementation of std::iterator_traits, which 145 // is not available in libCstd when compiled with Sun C++. 146 // 147 // Smart pointers: 148 // scoped_ptr - as in TR2. 149 // 150 // Regular expressions: 151 // RE - a simple regular expression class using the POSIX 152 // Extended Regular Expression syntax on UNIX-like 153 // platforms, or a reduced regular exception syntax on 154 // other platforms, including Windows. 155 // 156 // Logging: 157 // GTEST_LOG_() - logs messages at the specified severity level. 158 // LogToStderr() - directs all log messages to stderr. 159 // FlushInfoLog() - flushes informational log messages. 160 // 161 // Stdout and stderr capturing: 162 // CaptureStdout() - starts capturing stdout. 163 // GetCapturedStdout() - stops capturing stdout and returns the captured 164 // string. 165 // CaptureStderr() - starts capturing stderr. 166 // GetCapturedStderr() - stops capturing stderr and returns the captured 167 // string. 168 // 169 // Integer types: 170 // TypeWithSize - maps an integer to a int type. 171 // Int32, UInt32, Int64, UInt64, TimeInMillis 172 // - integers of known sizes. 173 // BiggestInt - the biggest signed integer type. 174 // 175 // Command-line utilities: 176 // GTEST_FLAG() - references a flag. 177 // GTEST_DECLARE_*() - declares a flag. 178 // GTEST_DEFINE_*() - defines a flag. 179 // GetArgvs() - returns the command line as a vector of strings. 180 // 181 // Environment variable utilities: 182 // GetEnv() - gets the value of an environment variable. 183 // BoolFromGTestEnv() - parses a bool environment variable. 184 // Int32FromGTestEnv() - parses an Int32 environment variable. 185 // StringFromGTestEnv() - parses a string environment variable. 186 187 #include <ctype.h> // for isspace, etc 188 #include <stddef.h> // for ptrdiff_t 189 #include <stdlib.h> 190 #include <stdio.h> 191 #include <string.h> 192 #ifndef _WIN32_WCE 193 # include <sys/types.h> 194 # include <sys/stat.h> 195 #endif // !_WIN32_WCE 196 197 #include <iostream> // NOLINT 198 #include <sstream> // NOLINT 199 #include <string> // NOLINT 200 201 #define GTEST_DEV_EMAIL_ "googletestframework@@googlegroups.com" 202 #define GTEST_FLAG_PREFIX_ "gtest_" 203 #define GTEST_FLAG_PREFIX_DASH_ "gtest-" 204 #define GTEST_FLAG_PREFIX_UPPER_ "GTEST_" 205 #define GTEST_NAME_ "Google Test" 206 #define GTEST_PROJECT_URL_ "http://code.google.com/p/googletest/" 207 208 // Determines the version of gcc that is used to compile this. 209 #ifdef __GNUC__ 210 // 40302 means version 4.3.2. 211 # define GTEST_GCC_VER_ \ 212 (__GNUC__*10000 + __GNUC_MINOR__*100 + __GNUC_PATCHLEVEL__) 213 #endif // __GNUC__ 214 215 // Determines the platform on which Google Test is compiled. 216 #ifdef __CYGWIN__ 217 # define GTEST_OS_CYGWIN 1 218 #elif defined __SYMBIAN32__ 219 # define GTEST_OS_SYMBIAN 1 220 #elif defined _WIN32 221 # define GTEST_OS_WINDOWS 1 222 # ifdef _WIN32_WCE 223 # define GTEST_OS_WINDOWS_MOBILE 1 224 # elif defined(__MINGW__) || defined(__MINGW32__) 225 # define GTEST_OS_WINDOWS_MINGW 1 226 # else 227 # define GTEST_OS_WINDOWS_DESKTOP 1 228 # endif // _WIN32_WCE 229 #elif defined __APPLE__ 230 # define GTEST_OS_MAC 1 231 #elif defined __linux__ 232 # define GTEST_OS_LINUX 1 233 # ifdef ANDROID 234 # define GTEST_OS_LINUX_ANDROID 1 235 # endif // ANDROID 236 #elif defined __MVS__ 237 # define GTEST_OS_ZOS 1 238 #elif defined(__sun) && defined(__SVR4) 239 # define GTEST_OS_SOLARIS 1 240 #elif defined(_AIX) 241 # define GTEST_OS_AIX 1 242 #elif defined(__hpux) 243 # define GTEST_OS_HPUX 1 244 #elif defined __native_client__ 245 # define GTEST_OS_NACL 1 246 #elif defined(__HAIKU__) 247 # define GTEST_OS_HAIKU 1 248 #endif // __CYGWIN__ 249 250 // Brings in definitions for functions used in the testing::internal::posix 251 // namespace (read, write, close, chdir, isatty, stat). We do not currently 252 // use them on Windows Mobile. 253 #if !GTEST_OS_WINDOWS 254 // This assumes that non-Windows OSes provide unistd.h. For OSes where this 255 // is not the case, we need to include headers that provide the functions 256 // mentioned above. 257 # include <unistd.h> 258 # if !GTEST_OS_NACL 259 // TODO(vladl (at) google.com): Remove this condition when Native Client SDK adds 260 // strings.h (tracked in 261 // http://code.google.com/p/nativeclient/issues/detail?id=1175). 262 # include <strings.h> // Native Client doesn't provide strings.h. 263 # endif 264 #elif !GTEST_OS_WINDOWS_MOBILE 265 # include <direct.h> 266 # include <io.h> 267 #endif 268 269 // Defines this to true iff Google Test can use POSIX regular expressions. 270 #ifndef GTEST_HAS_POSIX_RE 271 # define GTEST_HAS_POSIX_RE (!GTEST_OS_WINDOWS) 272 #endif 273 274 #if GTEST_HAS_POSIX_RE 275 276 // On some platforms, <regex.h> needs someone to define size_t, and 277 // won't compile otherwise. We can #include it here as we already 278 // included <stdlib.h>, which is guaranteed to define size_t through 279 // <stddef.h>. 280 # include <regex.h> // NOLINT 281 282 # define GTEST_USES_POSIX_RE 1 283 284 #elif GTEST_OS_WINDOWS 285 286 // <regex.h> is not available on Windows. Use our own simple regex 287 // implementation instead. 288 # define GTEST_USES_SIMPLE_RE 1 289 290 #else 291 292 // <regex.h> may not be available on this platform. Use our own 293 // simple regex implementation instead. 294 # define GTEST_USES_SIMPLE_RE 1 295 296 #endif // GTEST_HAS_POSIX_RE 297 298 #ifndef GTEST_HAS_EXCEPTIONS 299 // The user didn't tell us whether exceptions are enabled, so we need 300 // to figure it out. 301 # if defined(_MSC_VER) || defined(__BORLANDC__) 302 // MSVC's and C++Builder's implementations of the STL use the _HAS_EXCEPTIONS 303 // macro to enable exceptions, so we'll do the same. 304 // Assumes that exceptions are enabled by default. 305 # ifndef _HAS_EXCEPTIONS 306 # define _HAS_EXCEPTIONS 1 307 # endif // _HAS_EXCEPTIONS 308 # define GTEST_HAS_EXCEPTIONS _HAS_EXCEPTIONS 309 # elif defined(__GNUC__) && __EXCEPTIONS 310 // gcc defines __EXCEPTIONS to 1 iff exceptions are enabled. 311 # define GTEST_HAS_EXCEPTIONS 1 312 # elif defined(__SUNPRO_CC) 313 // Sun Pro CC supports exceptions. However, there is no compile-time way of 314 // detecting whether they are enabled or not. Therefore, we assume that 315 // they are enabled unless the user tells us otherwise. 316 # define GTEST_HAS_EXCEPTIONS 1 317 # elif defined(__IBMCPP__) && __EXCEPTIONS 318 // xlC defines __EXCEPTIONS to 1 iff exceptions are enabled. 319 # define GTEST_HAS_EXCEPTIONS 1 320 # elif defined(__HP_aCC) 321 // Exception handling is in effect by default in HP aCC compiler. It has to 322 // be turned of by +noeh compiler option if desired. 323 # define GTEST_HAS_EXCEPTIONS 1 324 # else 325 // For other compilers, we assume exceptions are disabled to be 326 // conservative. 327 # define GTEST_HAS_EXCEPTIONS 0 328 # endif // defined(_MSC_VER) || defined(__BORLANDC__) 329 #endif // GTEST_HAS_EXCEPTIONS 330 331 #if !defined(GTEST_HAS_STD_STRING) 332 // Even though we don't use this macro any longer, we keep it in case 333 // some clients still depend on it. 334 # define GTEST_HAS_STD_STRING 1 335 #elif !GTEST_HAS_STD_STRING 336 // The user told us that ::std::string isn't available. 337 # error "Google Test cannot be used where ::std::string isn't available." 338 #endif // !defined(GTEST_HAS_STD_STRING) 339 340 #ifndef GTEST_HAS_GLOBAL_STRING 341 // The user didn't tell us whether ::string is available, so we need 342 // to figure it out. 343 344 # define GTEST_HAS_GLOBAL_STRING 0 345 346 #endif // GTEST_HAS_GLOBAL_STRING 347 348 #ifndef GTEST_HAS_STD_WSTRING 349 // The user didn't tell us whether ::std::wstring is available, so we need 350 // to figure it out. 351 // TODO(wan (at) google.com): uses autoconf to detect whether ::std::wstring 352 // is available. 353 354 // Cygwin 1.7 and below doesn't support ::std::wstring. 355 // Solaris' libc++ doesn't support it either. Android has 356 // no support for it at least as recent as Froyo (2.2). 357 // Minix currently doesn't support it either. 358 # define GTEST_HAS_STD_WSTRING \ 359 (!(GTEST_OS_LINUX_ANDROID || GTEST_OS_CYGWIN || GTEST_OS_SOLARIS || GTEST_OS_HAIKU || defined(_MINIX))) 360 361 #endif // GTEST_HAS_STD_WSTRING 362 363 #ifndef GTEST_HAS_GLOBAL_WSTRING 364 // The user didn't tell us whether ::wstring is available, so we need 365 // to figure it out. 366 # define GTEST_HAS_GLOBAL_WSTRING \ 367 (GTEST_HAS_STD_WSTRING && GTEST_HAS_GLOBAL_STRING) 368 #endif // GTEST_HAS_GLOBAL_WSTRING 369 370 // Determines whether RTTI is available. 371 #ifndef GTEST_HAS_RTTI 372 // The user didn't tell us whether RTTI is enabled, so we need to 373 // figure it out. 374 375 # ifdef _MSC_VER 376 377 # ifdef _CPPRTTI // MSVC defines this macro iff RTTI is enabled. 378 # define GTEST_HAS_RTTI 1 379 # else 380 # define GTEST_HAS_RTTI 0 381 # endif 382 383 // Starting with version 4.3.2, gcc defines __GXX_RTTI iff RTTI is enabled. 384 # elif defined(__GNUC__) && (GTEST_GCC_VER_ >= 40302) 385 386 # ifdef __GXX_RTTI 387 # define GTEST_HAS_RTTI 1 388 # else 389 # define GTEST_HAS_RTTI 0 390 # endif // __GXX_RTTI 391 392 // Starting with version 9.0 IBM Visual Age defines __RTTI_ALL__ to 1 if 393 // both the typeid and dynamic_cast features are present. 394 # elif defined(__IBMCPP__) && (__IBMCPP__ >= 900) 395 396 # ifdef __RTTI_ALL__ 397 # define GTEST_HAS_RTTI 1 398 # else 399 # define GTEST_HAS_RTTI 0 400 # endif 401 402 # else 403 404 // For all other compilers, we assume RTTI is enabled. 405 # define GTEST_HAS_RTTI 1 406 407 # endif // _MSC_VER 408 409 #endif // GTEST_HAS_RTTI 410 411 // It's this header's responsibility to #include <typeinfo> when RTTI 412 // is enabled. 413 #if GTEST_HAS_RTTI 414 # include <typeinfo> 415 #endif 416 417 // Determines whether Google Test can use the pthreads library. 418 #ifndef GTEST_HAS_PTHREAD 419 // The user didn't tell us explicitly, so we assume pthreads support is 420 // available on Linux and Mac. 421 // 422 // To disable threading support in Google Test, add -DGTEST_HAS_PTHREAD=0 423 // to your compiler flags. 424 # define GTEST_HAS_PTHREAD (GTEST_OS_LINUX || GTEST_OS_MAC || GTEST_OS_HPUX) 425 #endif // GTEST_HAS_PTHREAD 426 427 #if GTEST_HAS_PTHREAD 428 // gtest-port.h guarantees to #include <pthread.h> when GTEST_HAS_PTHREAD is 429 // true. 430 # include <pthread.h> // NOLINT 431 432 // For timespec and nanosleep, used below. 433 # include <time.h> // NOLINT 434 #endif 435 436 // Determines whether Google Test can use tr1/tuple. You can define 437 // this macro to 0 to prevent Google Test from using tuple (any 438 // feature depending on tuple with be disabled in this mode). 439 #ifndef GTEST_HAS_TR1_TUPLE 440 // The user didn't tell us not to do it, so we assume it's OK. 441 # define GTEST_HAS_TR1_TUPLE 1 442 #endif // GTEST_HAS_TR1_TUPLE 443 444 // Determines whether Google Test's own tr1 tuple implementation 445 // should be used. 446 #ifndef GTEST_USE_OWN_TR1_TUPLE 447 // The user didn't tell us, so we need to figure it out. 448 449 // We use our own TR1 tuple if we aren't sure the user has an 450 // implementation of it already. At this time, GCC 4.0.0+ and MSVC 451 // 2010 are the only mainstream compilers that come with a TR1 tuple 452 // implementation. NVIDIA's CUDA NVCC compiler pretends to be GCC by 453 // defining __GNUC__ and friends, but cannot compile GCC's tuple 454 // implementation. MSVC 2008 (9.0) provides TR1 tuple in a 323 MB 455 // Feature Pack download, which we cannot assume the user has. 456 # if (defined(__GNUC__) && !(defined(__CUDACC__) || defined(__clang__)) \ 457 && (GTEST_GCC_VER_ >= 40000)) \ 458 || _MSC_VER >= 1600 459 # define GTEST_USE_OWN_TR1_TUPLE 0 460 # else 461 # define GTEST_USE_OWN_TR1_TUPLE 1 462 # endif 463 464 #endif // GTEST_USE_OWN_TR1_TUPLE 465 466 // To avoid conditional compilation everywhere, we make it 467 // gtest-port.h's responsibility to #include the header implementing 468 // tr1/tuple. 469 #if GTEST_HAS_TR1_TUPLE 470 471 # if GTEST_USE_OWN_TR1_TUPLE 472 # include "gtest/internal/gtest-tuple.h" 473 # elif GTEST_OS_SYMBIAN 474 475 // On Symbian, BOOST_HAS_TR1_TUPLE causes Boost's TR1 tuple library to 476 // use STLport's tuple implementation, which unfortunately doesn't 477 // work as the copy of STLport distributed with Symbian is incomplete. 478 // By making sure BOOST_HAS_TR1_TUPLE is undefined, we force Boost to 479 // use its own tuple implementation. 480 # ifdef BOOST_HAS_TR1_TUPLE 481 # undef BOOST_HAS_TR1_TUPLE 482 # endif // BOOST_HAS_TR1_TUPLE 483 484 // This prevents <boost/tr1/detail/config.hpp>, which defines 485 // BOOST_HAS_TR1_TUPLE, from being #included by Boost's <tuple>. 486 # define BOOST_TR1_DETAIL_CONFIG_HPP_INCLUDED 487 # include <tuple> 488 489 # elif defined(__GNUC__) && (GTEST_GCC_VER_ >= 40000) 490 // GCC 4.0+ implements tr1/tuple in the <tr1/tuple> header. This does 491 // not conform to the TR1 spec, which requires the header to be <tuple>. 492 493 # if !GTEST_HAS_RTTI && GTEST_GCC_VER_ < 40302 494 // Until version 4.3.2, gcc has a bug that causes <tr1/functional>, 495 // which is #included by <tr1/tuple>, to not compile when RTTI is 496 // disabled. _TR1_FUNCTIONAL is the header guard for 497 // <tr1/functional>. Hence the following #define is a hack to prevent 498 // <tr1/functional> from being included. 499 # define _TR1_FUNCTIONAL 1 500 # include <tr1/tuple> 501 # undef _TR1_FUNCTIONAL // Allows the user to #include 502 // <tr1/functional> if he chooses to. 503 # else 504 # include <tr1/tuple> // NOLINT 505 # endif // !GTEST_HAS_RTTI && GTEST_GCC_VER_ < 40302 506 507 # else 508 // If the compiler is not GCC 4.0+, we assume the user is using a 509 // spec-conforming TR1 implementation. 510 # include <tuple> // NOLINT 511 # endif // GTEST_USE_OWN_TR1_TUPLE 512 513 #endif // GTEST_HAS_TR1_TUPLE 514 515 // Determines whether clone(2) is supported. 516 // Usually it will only be available on Linux, excluding 517 // Linux on the Itanium architecture. 518 // Also see http://linux.die.net/man/2/clone. 519 #ifndef GTEST_HAS_CLONE 520 // The user didn't tell us, so we need to figure it out. 521 522 # if GTEST_OS_LINUX && !defined(__ia64__) 523 # define GTEST_HAS_CLONE 1 524 # else 525 # define GTEST_HAS_CLONE 0 526 # endif // GTEST_OS_LINUX && !defined(__ia64__) 527 528 #endif // GTEST_HAS_CLONE 529 530 // Determines whether to support stream redirection. This is used to test 531 // output correctness and to implement death tests. 532 #ifndef GTEST_HAS_STREAM_REDIRECTION 533 // By default, we assume that stream redirection is supported on all 534 // platforms except known mobile ones. 535 # if GTEST_OS_WINDOWS_MOBILE || GTEST_OS_SYMBIAN 536 # define GTEST_HAS_STREAM_REDIRECTION 0 537 # else 538 # define GTEST_HAS_STREAM_REDIRECTION 1 539 # endif // !GTEST_OS_WINDOWS_MOBILE && !GTEST_OS_SYMBIAN 540 #endif // GTEST_HAS_STREAM_REDIRECTION 541 542 // Determines whether to support death tests. 543 // Google Test does not support death tests for VC 7.1 and earlier as 544 // abort() in a VC 7.1 application compiled as GUI in debug config 545 // pops up a dialog window that cannot be suppressed programmatically. 546 #if (GTEST_OS_LINUX || GTEST_OS_MAC || GTEST_OS_CYGWIN || GTEST_OS_SOLARIS || \ 547 (GTEST_OS_WINDOWS_DESKTOP && _MSC_VER >= 1400) || \ 548 GTEST_OS_WINDOWS_MINGW || GTEST_OS_AIX || GTEST_OS_HPUX) 549 # define GTEST_HAS_DEATH_TEST 1 550 # include <vector> // NOLINT 551 #endif 552 553 // We don't support MSVC 7.1 with exceptions disabled now. Therefore 554 // all the compilers we care about are adequate for supporting 555 // value-parameterized tests. 556 #define GTEST_HAS_PARAM_TEST 1 557 558 // Determines whether to support type-driven tests. 559 560 // Typed tests need <typeinfo> and variadic macros, which GCC, VC++ 8.0, 561 // Sun Pro CC, IBM Visual Age, and HP aCC support. 562 #if defined(__GNUC__) || (_MSC_VER >= 1400) || defined(__SUNPRO_CC) || \ 563 defined(__IBMCPP__) || defined(__HP_aCC) 564 # define GTEST_HAS_TYPED_TEST 1 565 # define GTEST_HAS_TYPED_TEST_P 1 566 #endif 567 568 // Determines whether to support Combine(). This only makes sense when 569 // value-parameterized tests are enabled. The implementation doesn't 570 // work on Sun Studio since it doesn't understand templated conversion 571 // operators. 572 #if GTEST_HAS_PARAM_TEST && GTEST_HAS_TR1_TUPLE && !defined(__SUNPRO_CC) 573 # define GTEST_HAS_COMBINE 1 574 #endif 575 576 // Determines whether the system compiler uses UTF-16 for encoding wide strings. 577 #define GTEST_WIDE_STRING_USES_UTF16_ \ 578 (GTEST_OS_WINDOWS || GTEST_OS_CYGWIN || GTEST_OS_SYMBIAN || GTEST_OS_AIX) 579 580 // Determines whether test results can be streamed to a socket. 581 #if GTEST_OS_LINUX 582 # define GTEST_CAN_STREAM_RESULTS_ 1 583 #endif 584 585 // Defines some utility macros. 586 587 // The GNU compiler emits a warning if nested "if" statements are followed by 588 // an "else" statement and braces are not used to explicitly disambiguate the 589 // "else" binding. This leads to problems with code like: 590 // 591 // if (gate) 592 // ASSERT_*(condition) << "Some message"; 593 // 594 // The "switch (0) case 0:" idiom is used to suppress this. 595 #ifdef __INTEL_COMPILER 596 # define GTEST_AMBIGUOUS_ELSE_BLOCKER_ 597 #else 598 # define GTEST_AMBIGUOUS_ELSE_BLOCKER_ switch (0) case 0: default: // NOLINT 599 #endif 600 601 // Use this annotation at the end of a struct/class definition to 602 // prevent the compiler from optimizing away instances that are never 603 // used. This is useful when all interesting logic happens inside the 604 // c'tor and / or d'tor. Example: 605 // 606 // struct Foo { 607 // Foo() { ... } 608 // } GTEST_ATTRIBUTE_UNUSED_; 609 // 610 // Also use it after a variable or parameter declaration to tell the 611 // compiler the variable/parameter does not have to be used. 612 #if defined(__GNUC__) && !defined(COMPILER_ICC) 613 # define GTEST_ATTRIBUTE_UNUSED_ __attribute__ ((unused)) 614 #else 615 # define GTEST_ATTRIBUTE_UNUSED_ 616 #endif 617 618 // A macro to disallow operator= 619 // This should be used in the private: declarations for a class. 620 #define GTEST_DISALLOW_ASSIGN_(type)\ 621 void operator=(type const &) 622 623 // A macro to disallow copy constructor and operator= 624 // This should be used in the private: declarations for a class. 625 #define GTEST_DISALLOW_COPY_AND_ASSIGN_(type)\ 626 type(type const &);\ 627 GTEST_DISALLOW_ASSIGN_(type) 628 629 // Tell the compiler to warn about unused return values for functions declared 630 // with this macro. The macro should be used on function declarations 631 // following the argument list: 632 // 633 // Sprocket* AllocateSprocket() GTEST_MUST_USE_RESULT_; 634 #if defined(__GNUC__) && (GTEST_GCC_VER_ >= 30400) && !defined(COMPILER_ICC) 635 # define GTEST_MUST_USE_RESULT_ __attribute__ ((warn_unused_result)) 636 #else 637 # define GTEST_MUST_USE_RESULT_ 638 #endif // __GNUC__ && (GTEST_GCC_VER_ >= 30400) && !COMPILER_ICC 639 640 // Determine whether the compiler supports Microsoft's Structured Exception 641 // Handling. This is supported by several Windows compilers but generally 642 // does not exist on any other system. 643 #ifndef GTEST_HAS_SEH 644 // The user didn't tell us, so we need to figure it out. 645 646 # if defined(_MSC_VER) || defined(__BORLANDC__) 647 // These two compilers are known to support SEH. 648 # define GTEST_HAS_SEH 1 649 # else 650 // Assume no SEH. 651 # define GTEST_HAS_SEH 0 652 # endif 653 654 #endif // GTEST_HAS_SEH 655 656 #ifdef _MSC_VER 657 658 # if GTEST_LINKED_AS_SHARED_LIBRARY 659 # define GTEST_API_ __declspec(dllimport) 660 # elif GTEST_CREATE_SHARED_LIBRARY 661 # define GTEST_API_ __declspec(dllexport) 662 # endif 663 664 #endif // _MSC_VER 665 666 #ifndef GTEST_API_ 667 # define GTEST_API_ 668 #endif 669 670 #ifdef __GNUC__ 671 // Ask the compiler to never inline a given function. 672 # define GTEST_NO_INLINE_ __attribute__((noinline)) 673 #else 674 # define GTEST_NO_INLINE_ 675 #endif 676 677 namespace testing { 678 679 class Message; 680 681 namespace internal { 682 683 class String; 684 685 // The GTEST_COMPILE_ASSERT_ macro can be used to verify that a compile time 686 // expression is true. For example, you could use it to verify the 687 // size of a static array: 688 // 689 // GTEST_COMPILE_ASSERT_(ARRAYSIZE(content_type_names) == CONTENT_NUM_TYPES, 690 // content_type_names_incorrect_size); 691 // 692 // or to make sure a struct is smaller than a certain size: 693 // 694 // GTEST_COMPILE_ASSERT_(sizeof(foo) < 128, foo_too_large); 695 // 696 // The second argument to the macro is the name of the variable. If 697 // the expression is false, most compilers will issue a warning/error 698 // containing the name of the variable. 699 700 template <bool> 701 struct CompileAssert { 702 }; 703 704 #define GTEST_COMPILE_ASSERT_(expr, msg) \ 705 typedef ::testing::internal::CompileAssert<(bool(expr))> \ 706 msg[bool(expr) ? 1 : -1] 707 708 // Implementation details of GTEST_COMPILE_ASSERT_: 709 // 710 // - GTEST_COMPILE_ASSERT_ works by defining an array type that has -1 711 // elements (and thus is invalid) when the expression is false. 712 // 713 // - The simpler definition 714 // 715 // #define GTEST_COMPILE_ASSERT_(expr, msg) typedef char msg[(expr) ? 1 : -1] 716 // 717 // does not work, as gcc supports variable-length arrays whose sizes 718 // are determined at run-time (this is gcc's extension and not part 719 // of the C++ standard). As a result, gcc fails to reject the 720 // following code with the simple definition: 721 // 722 // int foo; 723 // GTEST_COMPILE_ASSERT_(foo, msg); // not supposed to compile as foo is 724 // // not a compile-time constant. 725 // 726 // - By using the type CompileAssert<(bool(expr))>, we ensures that 727 // expr is a compile-time constant. (Template arguments must be 728 // determined at compile-time.) 729 // 730 // - The outter parentheses in CompileAssert<(bool(expr))> are necessary 731 // to work around a bug in gcc 3.4.4 and 4.0.1. If we had written 732 // 733 // CompileAssert<bool(expr)> 734 // 735 // instead, these compilers will refuse to compile 736 // 737 // GTEST_COMPILE_ASSERT_(5 > 0, some_message); 738 // 739 // (They seem to think the ">" in "5 > 0" marks the end of the 740 // template argument list.) 741 // 742 // - The array size is (bool(expr) ? 1 : -1), instead of simply 743 // 744 // ((expr) ? 1 : -1). 745 // 746 // This is to avoid running into a bug in MS VC 7.1, which 747 // causes ((0.0) ? 1 : -1) to incorrectly evaluate to 1. 748 749 // StaticAssertTypeEqHelper is used by StaticAssertTypeEq defined in gtest.h. 750 // 751 // This template is declared, but intentionally undefined. 752 template <typename T1, typename T2> 753 struct StaticAssertTypeEqHelper; 754 755 template <typename T> 756 struct StaticAssertTypeEqHelper<T, T> {}; 757 758 #if GTEST_HAS_GLOBAL_STRING 759 typedef ::string string; 760 #else 761 typedef ::std::string string; 762 #endif // GTEST_HAS_GLOBAL_STRING 763 764 #if GTEST_HAS_GLOBAL_WSTRING 765 typedef ::wstring wstring; 766 #elif GTEST_HAS_STD_WSTRING 767 typedef ::std::wstring wstring; 768 #endif // GTEST_HAS_GLOBAL_WSTRING 769 770 // A helper for suppressing warnings on constant condition. It just 771 // returns 'condition'. 772 GTEST_API_ bool IsTrue(bool condition); 773 774 // Defines scoped_ptr. 775 776 // This implementation of scoped_ptr is PARTIAL - it only contains 777 // enough stuff to satisfy Google Test's need. 778 template <typename T> 779 class scoped_ptr { 780 public: 781 typedef T element_type; 782 783 explicit scoped_ptr(T* p = NULL) : ptr_(p) {} 784 ~scoped_ptr() { reset(); } 785 786 T& operator*() const { return *ptr_; } 787 T* operator->() const { return ptr_; } 788 T* get() const { return ptr_; } 789 790 T* release() { 791 T* const ptr = ptr_; 792 ptr_ = NULL; 793 return ptr; 794 } 795 796 void reset(T* p = NULL) { 797 if (p != ptr_) { 798 if (IsTrue(sizeof(T) > 0)) { // Makes sure T is a complete type. 799 delete ptr_; 800 } 801 ptr_ = p; 802 } 803 } 804 private: 805 T* ptr_; 806 807 GTEST_DISALLOW_COPY_AND_ASSIGN_(scoped_ptr); 808 }; 809 810 // Defines RE. 811 812 // A simple C++ wrapper for <regex.h>. It uses the POSIX Extended 813 // Regular Expression syntax. 814 class GTEST_API_ RE { 815 public: 816 // A copy constructor is required by the Standard to initialize object 817 // references from r-values. 818 RE(const RE& other) { Init(other.pattern()); } 819 820 // Constructs an RE from a string. 821 RE(const ::std::string& regex) { Init(regex.c_str()); } // NOLINT 822 823 #if GTEST_HAS_GLOBAL_STRING 824 825 RE(const ::string& regex) { Init(regex.c_str()); } // NOLINT 826 827 #endif // GTEST_HAS_GLOBAL_STRING 828 829 RE(const char* regex) { Init(regex); } // NOLINT 830 ~RE(); 831 832 // Returns the string representation of the regex. 833 const char* pattern() const { return pattern_; } 834 835 // FullMatch(str, re) returns true iff regular expression re matches 836 // the entire str. 837 // PartialMatch(str, re) returns true iff regular expression re 838 // matches a substring of str (including str itself). 839 // 840 // TODO(wan (at) google.com): make FullMatch() and PartialMatch() work 841 // when str contains NUL characters. 842 static bool FullMatch(const ::std::string& str, const RE& re) { 843 return FullMatch(str.c_str(), re); 844 } 845 static bool PartialMatch(const ::std::string& str, const RE& re) { 846 return PartialMatch(str.c_str(), re); 847 } 848 849 #if GTEST_HAS_GLOBAL_STRING 850 851 static bool FullMatch(const ::string& str, const RE& re) { 852 return FullMatch(str.c_str(), re); 853 } 854 static bool PartialMatch(const ::string& str, const RE& re) { 855 return PartialMatch(str.c_str(), re); 856 } 857 858 #endif // GTEST_HAS_GLOBAL_STRING 859 860 static bool FullMatch(const char* str, const RE& re); 861 static bool PartialMatch(const char* str, const RE& re); 862 863 private: 864 void Init(const char* regex); 865 866 // We use a const char* instead of a string, as Google Test may be used 867 // where string is not available. We also do not use Google Test's own 868 // String type here, in order to simplify dependencies between the 869 // files. 870 const char* pattern_; 871 bool is_valid_; 872 873 #if GTEST_USES_POSIX_RE 874 875 regex_t full_regex_; // For FullMatch(). 876 regex_t partial_regex_; // For PartialMatch(). 877 878 #else // GTEST_USES_SIMPLE_RE 879 880 const char* full_pattern_; // For FullMatch(); 881 882 #endif 883 884 GTEST_DISALLOW_ASSIGN_(RE); 885 }; 886 887 // Formats a source file path and a line number as they would appear 888 // in an error message from the compiler used to compile this code. 889 GTEST_API_ ::std::string FormatFileLocation(const char* file, int line); 890 891 // Formats a file location for compiler-independent XML output. 892 // Although this function is not platform dependent, we put it next to 893 // FormatFileLocation in order to contrast the two functions. 894 GTEST_API_ ::std::string FormatCompilerIndependentFileLocation(const char* file, 895 int line); 896 897 // Defines logging utilities: 898 // GTEST_LOG_(severity) - logs messages at the specified severity level. The 899 // message itself is streamed into the macro. 900 // LogToStderr() - directs all log messages to stderr. 901 // FlushInfoLog() - flushes informational log messages. 902 903 enum GTestLogSeverity { 904 GTEST_INFO, 905 GTEST_WARNING, 906 GTEST_ERROR, 907 GTEST_FATAL 908 }; 909 910 // Formats log entry severity, provides a stream object for streaming the 911 // log message, and terminates the message with a newline when going out of 912 // scope. 913 class GTEST_API_ GTestLog { 914 public: 915 GTestLog(GTestLogSeverity severity, const char* file, int line); 916 917 // Flushes the buffers and, if severity is GTEST_FATAL, aborts the program. 918 ~GTestLog(); 919 920 ::std::ostream& GetStream() { return ::std::cerr; } 921 922 private: 923 const GTestLogSeverity severity_; 924 925 GTEST_DISALLOW_COPY_AND_ASSIGN_(GTestLog); 926 }; 927 928 #define GTEST_LOG_(severity) \ 929 ::testing::internal::GTestLog(::testing::internal::GTEST_##severity, \ 930 __FILE__, __LINE__).GetStream() 931 932 inline void LogToStderr() {} 933 inline void FlushInfoLog() { fflush(NULL); } 934 935 // INTERNAL IMPLEMENTATION - DO NOT USE. 936 // 937 // GTEST_CHECK_ is an all-mode assert. It aborts the program if the condition 938 // is not satisfied. 939 // Synopsys: 940 // GTEST_CHECK_(boolean_condition); 941 // or 942 // GTEST_CHECK_(boolean_condition) << "Additional message"; 943 // 944 // This checks the condition and if the condition is not satisfied 945 // it prints message about the condition violation, including the 946 // condition itself, plus additional message streamed into it, if any, 947 // and then it aborts the program. It aborts the program irrespective of 948 // whether it is built in the debug mode or not. 949 #define GTEST_CHECK_(condition) \ 950 GTEST_AMBIGUOUS_ELSE_BLOCKER_ \ 951 if (::testing::internal::IsTrue(condition)) \ 952 ; \ 953 else \ 954 GTEST_LOG_(FATAL) << "Condition " #condition " failed. " 955 956 // An all-mode assert to verify that the given POSIX-style function 957 // call returns 0 (indicating success). Known limitation: this 958 // doesn't expand to a balanced 'if' statement, so enclose the macro 959 // in {} if you need to use it as the only statement in an 'if' 960 // branch. 961 #define GTEST_CHECK_POSIX_SUCCESS_(posix_call) \ 962 if (const int gtest_error = (posix_call)) \ 963 GTEST_LOG_(FATAL) << #posix_call << "failed with error " \ 964 << gtest_error 965 966 // INTERNAL IMPLEMENTATION - DO NOT USE IN USER CODE. 967 // 968 // Use ImplicitCast_ as a safe version of static_cast for upcasting in 969 // the type hierarchy (e.g. casting a Foo* to a SuperclassOfFoo* or a 970 // const Foo*). When you use ImplicitCast_, the compiler checks that 971 // the cast is safe. Such explicit ImplicitCast_s are necessary in 972 // surprisingly many situations where C++ demands an exact type match 973 // instead of an argument type convertable to a target type. 974 // 975 // The syntax for using ImplicitCast_ is the same as for static_cast: 976 // 977 // ImplicitCast_<ToType>(expr) 978 // 979 // ImplicitCast_ would have been part of the C++ standard library, 980 // but the proposal was submitted too late. It will probably make 981 // its way into the language in the future. 982 // 983 // This relatively ugly name is intentional. It prevents clashes with 984 // similar functions users may have (e.g., implicit_cast). The internal 985 // namespace alone is not enough because the function can be found by ADL. 986 template<typename To> 987 inline To ImplicitCast_(To x) { return x; } 988 989 // When you upcast (that is, cast a pointer from type Foo to type 990 // SuperclassOfFoo), it's fine to use ImplicitCast_<>, since upcasts 991 // always succeed. When you downcast (that is, cast a pointer from 992 // type Foo to type SubclassOfFoo), static_cast<> isn't safe, because 993 // how do you know the pointer is really of type SubclassOfFoo? It 994 // could be a bare Foo, or of type DifferentSubclassOfFoo. Thus, 995 // when you downcast, you should use this macro. In debug mode, we 996 // use dynamic_cast<> to double-check the downcast is legal (we die 997 // if it's not). In normal mode, we do the efficient static_cast<> 998 // instead. Thus, it's important to test in debug mode to make sure 999 // the cast is legal! 1000 // This is the only place in the code we should use dynamic_cast<>. 1001 // In particular, you SHOULDN'T be using dynamic_cast<> in order to 1002 // do RTTI (eg code like this: 1003 // if (dynamic_cast<Subclass1>(foo)) HandleASubclass1Object(foo); 1004 // if (dynamic_cast<Subclass2>(foo)) HandleASubclass2Object(foo); 1005 // You should design the code some other way not to need this. 1006 // 1007 // This relatively ugly name is intentional. It prevents clashes with 1008 // similar functions users may have (e.g., down_cast). The internal 1009 // namespace alone is not enough because the function can be found by ADL. 1010 template<typename To, typename From> // use like this: DownCast_<T*>(foo); 1011 inline To DownCast_(From* f) { // so we only accept pointers 1012 // Ensures that To is a sub-type of From *. This test is here only 1013 // for compile-time type checking, and has no overhead in an 1014 // optimized build at run-time, as it will be optimized away 1015 // completely. 1016 if (false) { 1017 const To to = NULL; 1018 ::testing::internal::ImplicitCast_<From*>(to); 1019 } 1020 1021 #if GTEST_HAS_RTTI 1022 // RTTI: debug mode only! 1023 GTEST_CHECK_(f == NULL || dynamic_cast<To>(f) != NULL); 1024 #endif 1025 return static_cast<To>(f); 1026 } 1027 1028 // Downcasts the pointer of type Base to Derived. 1029 // Derived must be a subclass of Base. The parameter MUST 1030 // point to a class of type Derived, not any subclass of it. 1031 // When RTTI is available, the function performs a runtime 1032 // check to enforce this. 1033 template <class Derived, class Base> 1034 Derived* CheckedDowncastToActualType(Base* base) { 1035 #if GTEST_HAS_RTTI 1036 GTEST_CHECK_(typeid(*base) == typeid(Derived)); 1037 return dynamic_cast<Derived*>(base); // NOLINT 1038 #else 1039 return static_cast<Derived*>(base); // Poor man's downcast. 1040 #endif 1041 } 1042 1043 #if GTEST_HAS_STREAM_REDIRECTION 1044 1045 // Defines the stderr capturer: 1046 // CaptureStdout - starts capturing stdout. 1047 // GetCapturedStdout - stops capturing stdout and returns the captured string. 1048 // CaptureStderr - starts capturing stderr. 1049 // GetCapturedStderr - stops capturing stderr and returns the captured string. 1050 // 1051 GTEST_API_ void CaptureStdout(); 1052 GTEST_API_ String GetCapturedStdout(); 1053 GTEST_API_ void CaptureStderr(); 1054 GTEST_API_ String GetCapturedStderr(); 1055 1056 #endif // GTEST_HAS_STREAM_REDIRECTION 1057 1058 1059 #if GTEST_HAS_DEATH_TEST 1060 1061 // A copy of all command line arguments. Set by InitGoogleTest(). 1062 extern ::std::vector<String> g_argvs; 1063 1064 // GTEST_HAS_DEATH_TEST implies we have ::std::string. 1065 const ::std::vector<String>& GetArgvs(); 1066 1067 #endif // GTEST_HAS_DEATH_TEST 1068 1069 // Defines synchronization primitives. 1070 1071 #if GTEST_HAS_PTHREAD 1072 1073 // Sleeps for (roughly) n milli-seconds. This function is only for 1074 // testing Google Test's own constructs. Don't use it in user tests, 1075 // either directly or indirectly. 1076 inline void SleepMilliseconds(int n) { 1077 const timespec time = { 1078 0, // 0 seconds. 1079 n * 1000L * 1000L, // And n ms. 1080 }; 1081 nanosleep(&time, NULL); 1082 } 1083 1084 // Allows a controller thread to pause execution of newly created 1085 // threads until notified. Instances of this class must be created 1086 // and destroyed in the controller thread. 1087 // 1088 // This class is only for testing Google Test's own constructs. Do not 1089 // use it in user tests, either directly or indirectly. 1090 class Notification { 1091 public: 1092 Notification() : notified_(false) {} 1093 1094 // Notifies all threads created with this notification to start. Must 1095 // be called from the controller thread. 1096 void Notify() { notified_ = true; } 1097 1098 // Blocks until the controller thread notifies. Must be called from a test 1099 // thread. 1100 void WaitForNotification() { 1101 while(!notified_) { 1102 SleepMilliseconds(10); 1103 } 1104 } 1105 1106 private: 1107 volatile bool notified_; 1108 1109 GTEST_DISALLOW_COPY_AND_ASSIGN_(Notification); 1110 }; 1111 1112 // As a C-function, ThreadFuncWithCLinkage cannot be templated itself. 1113 // Consequently, it cannot select a correct instantiation of ThreadWithParam 1114 // in order to call its Run(). Introducing ThreadWithParamBase as a 1115 // non-templated base class for ThreadWithParam allows us to bypass this 1116 // problem. 1117 class ThreadWithParamBase { 1118 public: 1119 virtual ~ThreadWithParamBase() {} 1120 virtual void Run() = 0; 1121 }; 1122 1123 // pthread_create() accepts a pointer to a function type with the C linkage. 1124 // According to the Standard (7.5/1), function types with different linkages 1125 // are different even if they are otherwise identical. Some compilers (for 1126 // example, SunStudio) treat them as different types. Since class methods 1127 // cannot be defined with C-linkage we need to define a free C-function to 1128 // pass into pthread_create(). 1129 extern "C" inline void* ThreadFuncWithCLinkage(void* thread) { 1130 static_cast<ThreadWithParamBase*>(thread)->Run(); 1131 return NULL; 1132 } 1133 1134 // Helper class for testing Google Test's multi-threading constructs. 1135 // To use it, write: 1136 // 1137 // void ThreadFunc(int param) { /* Do things with param */ } 1138 // Notification thread_can_start; 1139 // ... 1140 // // The thread_can_start parameter is optional; you can supply NULL. 1141 // ThreadWithParam<int> thread(&ThreadFunc, 5, &thread_can_start); 1142 // thread_can_start.Notify(); 1143 // 1144 // These classes are only for testing Google Test's own constructs. Do 1145 // not use them in user tests, either directly or indirectly. 1146 template <typename T> 1147 class ThreadWithParam : public ThreadWithParamBase { 1148 public: 1149 typedef void (*UserThreadFunc)(T); 1150 1151 ThreadWithParam( 1152 UserThreadFunc func, T param, Notification* thread_can_start) 1153 : func_(func), 1154 param_(param), 1155 thread_can_start_(thread_can_start), 1156 finished_(false) { 1157 ThreadWithParamBase* const base = this; 1158 // The thread can be created only after all fields except thread_ 1159 // have been initialized. 1160 GTEST_CHECK_POSIX_SUCCESS_( 1161 pthread_create(&thread_, 0, &ThreadFuncWithCLinkage, base)); 1162 } 1163 ~ThreadWithParam() { Join(); } 1164 1165 void Join() { 1166 if (!finished_) { 1167 GTEST_CHECK_POSIX_SUCCESS_(pthread_join(thread_, 0)); 1168 finished_ = true; 1169 } 1170 } 1171 1172 virtual void Run() { 1173 if (thread_can_start_ != NULL) 1174 thread_can_start_->WaitForNotification(); 1175 func_(param_); 1176 } 1177 1178 private: 1179 const UserThreadFunc func_; // User-supplied thread function. 1180 const T param_; // User-supplied parameter to the thread function. 1181 // When non-NULL, used to block execution until the controller thread 1182 // notifies. 1183 Notification* const thread_can_start_; 1184 bool finished_; // true iff we know that the thread function has finished. 1185 pthread_t thread_; // The native thread object. 1186 1187 GTEST_DISALLOW_COPY_AND_ASSIGN_(ThreadWithParam); 1188 }; 1189 1190 // MutexBase and Mutex implement mutex on pthreads-based platforms. They 1191 // are used in conjunction with class MutexLock: 1192 // 1193 // Mutex mutex; 1194 // ... 1195 // MutexLock lock(&mutex); // Acquires the mutex and releases it at the end 1196 // // of the current scope. 1197 // 1198 // MutexBase implements behavior for both statically and dynamically 1199 // allocated mutexes. Do not use MutexBase directly. Instead, write 1200 // the following to define a static mutex: 1201 // 1202 // GTEST_DEFINE_STATIC_MUTEX_(g_some_mutex); 1203 // 1204 // You can forward declare a static mutex like this: 1205 // 1206 // GTEST_DECLARE_STATIC_MUTEX_(g_some_mutex); 1207 // 1208 // To create a dynamic mutex, just define an object of type Mutex. 1209 class MutexBase { 1210 public: 1211 // Acquires this mutex. 1212 void Lock() { 1213 GTEST_CHECK_POSIX_SUCCESS_(pthread_mutex_lock(&mutex_)); 1214 owner_ = pthread_self(); 1215 } 1216 1217 // Releases this mutex. 1218 void Unlock() { 1219 // We don't protect writing to owner_ here, as it's the caller's 1220 // responsibility to ensure that the current thread holds the 1221 // mutex when this is called. 1222 owner_ = 0; 1223 GTEST_CHECK_POSIX_SUCCESS_(pthread_mutex_unlock(&mutex_)); 1224 } 1225 1226 // Does nothing if the current thread holds the mutex. Otherwise, crashes 1227 // with high probability. 1228 void AssertHeld() const { 1229 GTEST_CHECK_(owner_ == pthread_self()) 1230 << "The current thread is not holding the mutex @" << this; 1231 } 1232 1233 // A static mutex may be used before main() is entered. It may even 1234 // be used before the dynamic initialization stage. Therefore we 1235 // must be able to initialize a static mutex object at link time. 1236 // This means MutexBase has to be a POD and its member variables 1237 // have to be public. 1238 public: 1239 pthread_mutex_t mutex_; // The underlying pthread mutex. 1240 pthread_t owner_; // The thread holding the mutex; 0 means no one holds it. 1241 }; 1242 1243 // Forward-declares a static mutex. 1244 # define GTEST_DECLARE_STATIC_MUTEX_(mutex) \ 1245 extern ::testing::internal::MutexBase mutex 1246 1247 // Defines and statically (i.e. at link time) initializes a static mutex. 1248 # define GTEST_DEFINE_STATIC_MUTEX_(mutex) \ 1249 ::testing::internal::MutexBase mutex = { PTHREAD_MUTEX_INITIALIZER, 0 } 1250 1251 // The Mutex class can only be used for mutexes created at runtime. It 1252 // shares its API with MutexBase otherwise. 1253 class Mutex : public MutexBase { 1254 public: 1255 Mutex() { 1256 GTEST_CHECK_POSIX_SUCCESS_(pthread_mutex_init(&mutex_, NULL)); 1257 owner_ = 0; 1258 } 1259 ~Mutex() { 1260 GTEST_CHECK_POSIX_SUCCESS_(pthread_mutex_destroy(&mutex_)); 1261 } 1262 1263 private: 1264 GTEST_DISALLOW_COPY_AND_ASSIGN_(Mutex); 1265 }; 1266 1267 // We cannot name this class MutexLock as the ctor declaration would 1268 // conflict with a macro named MutexLock, which is defined on some 1269 // platforms. Hence the typedef trick below. 1270 class GTestMutexLock { 1271 public: 1272 explicit GTestMutexLock(MutexBase* mutex) 1273 : mutex_(mutex) { mutex_->Lock(); } 1274 1275 ~GTestMutexLock() { mutex_->Unlock(); } 1276 1277 private: 1278 MutexBase* const mutex_; 1279 1280 GTEST_DISALLOW_COPY_AND_ASSIGN_(GTestMutexLock); 1281 }; 1282 1283 typedef GTestMutexLock MutexLock; 1284 1285 // Helpers for ThreadLocal. 1286 1287 // pthread_key_create() requires DeleteThreadLocalValue() to have 1288 // C-linkage. Therefore it cannot be templatized to access 1289 // ThreadLocal<T>. Hence the need for class 1290 // ThreadLocalValueHolderBase. 1291 class ThreadLocalValueHolderBase { 1292 public: 1293 virtual ~ThreadLocalValueHolderBase() {} 1294 }; 1295 1296 // Called by pthread to delete thread-local data stored by 1297 // pthread_setspecific(). 1298 extern "C" inline void DeleteThreadLocalValue(void* value_holder) { 1299 delete static_cast<ThreadLocalValueHolderBase*>(value_holder); 1300 } 1301 1302 // Implements thread-local storage on pthreads-based systems. 1303 // 1304 // // Thread 1 1305 // ThreadLocal<int> tl(100); // 100 is the default value for each thread. 1306 // 1307 // // Thread 2 1308 // tl.set(150); // Changes the value for thread 2 only. 1309 // EXPECT_EQ(150, tl.get()); 1310 // 1311 // // Thread 1 1312 // EXPECT_EQ(100, tl.get()); // In thread 1, tl has the original value. 1313 // tl.set(200); 1314 // EXPECT_EQ(200, tl.get()); 1315 // 1316 // The template type argument T must have a public copy constructor. 1317 // In addition, the default ThreadLocal constructor requires T to have 1318 // a public default constructor. 1319 // 1320 // An object managed for a thread by a ThreadLocal instance is deleted 1321 // when the thread exits. Or, if the ThreadLocal instance dies in 1322 // that thread, when the ThreadLocal dies. It's the user's 1323 // responsibility to ensure that all other threads using a ThreadLocal 1324 // have exited when it dies, or the per-thread objects for those 1325 // threads will not be deleted. 1326 // 1327 // Google Test only uses global ThreadLocal objects. That means they 1328 // will die after main() has returned. Therefore, no per-thread 1329 // object managed by Google Test will be leaked as long as all threads 1330 // using Google Test have exited when main() returns. 1331 template <typename T> 1332 class ThreadLocal { 1333 public: 1334 ThreadLocal() : key_(CreateKey()), 1335 default_() {} 1336 explicit ThreadLocal(const T& value) : key_(CreateKey()), 1337 default_(value) {} 1338 1339 ~ThreadLocal() { 1340 // Destroys the managed object for the current thread, if any. 1341 DeleteThreadLocalValue(pthread_getspecific(key_)); 1342 1343 // Releases resources associated with the key. This will *not* 1344 // delete managed objects for other threads. 1345 GTEST_CHECK_POSIX_SUCCESS_(pthread_key_delete(key_)); 1346 } 1347 1348 T* pointer() { return GetOrCreateValue(); } 1349 const T* pointer() const { return GetOrCreateValue(); } 1350 const T& get() const { return *pointer(); } 1351 void set(const T& value) { *pointer() = value; } 1352 1353 private: 1354 // Holds a value of type T. 1355 class ValueHolder : public ThreadLocalValueHolderBase { 1356 public: 1357 explicit ValueHolder(const T& value) : value_(value) {} 1358 1359 T* pointer() { return &value_; } 1360 1361 private: 1362 T value_; 1363 GTEST_DISALLOW_COPY_AND_ASSIGN_(ValueHolder); 1364 }; 1365 1366 static pthread_key_t CreateKey() { 1367 pthread_key_t key; 1368 // When a thread exits, DeleteThreadLocalValue() will be called on 1369 // the object managed for that thread. 1370 GTEST_CHECK_POSIX_SUCCESS_( 1371 pthread_key_create(&key, &DeleteThreadLocalValue)); 1372 return key; 1373 } 1374 1375 T* GetOrCreateValue() const { 1376 ThreadLocalValueHolderBase* const holder = 1377 static_cast<ThreadLocalValueHolderBase*>(pthread_getspecific(key_)); 1378 if (holder != NULL) { 1379 return CheckedDowncastToActualType<ValueHolder>(holder)->pointer(); 1380 } 1381 1382 ValueHolder* const new_holder = new ValueHolder(default_); 1383 ThreadLocalValueHolderBase* const holder_base = new_holder; 1384 GTEST_CHECK_POSIX_SUCCESS_(pthread_setspecific(key_, holder_base)); 1385 return new_holder->pointer(); 1386 } 1387 1388 // A key pthreads uses for looking up per-thread values. 1389 const pthread_key_t key_; 1390 const T default_; // The default value for each thread. 1391 1392 GTEST_DISALLOW_COPY_AND_ASSIGN_(ThreadLocal); 1393 }; 1394 1395 # define GTEST_IS_THREADSAFE 1 1396 1397 #else // GTEST_HAS_PTHREAD 1398 1399 // A dummy implementation of synchronization primitives (mutex, lock, 1400 // and thread-local variable). Necessary for compiling Google Test where 1401 // mutex is not supported - using Google Test in multiple threads is not 1402 // supported on such platforms. 1403 1404 class Mutex { 1405 public: 1406 Mutex() {} 1407 void AssertHeld() const {} 1408 }; 1409 1410 # define GTEST_DECLARE_STATIC_MUTEX_(mutex) \ 1411 extern ::testing::internal::Mutex mutex 1412 1413 # define GTEST_DEFINE_STATIC_MUTEX_(mutex) ::testing::internal::Mutex mutex 1414 1415 class GTestMutexLock { 1416 public: 1417 explicit GTestMutexLock(Mutex*) {} // NOLINT 1418 }; 1419 1420 typedef GTestMutexLock MutexLock; 1421 1422 template <typename T> 1423 class ThreadLocal { 1424 public: 1425 ThreadLocal() : value_() {} 1426 explicit ThreadLocal(const T& value) : value_(value) {} 1427 T* pointer() { return &value_; } 1428 const T* pointer() const { return &value_; } 1429 const T& get() const { return value_; } 1430 void set(const T& value) { value_ = value; } 1431 private: 1432 T value_; 1433 }; 1434 1435 // The above synchronization primitives have dummy implementations. 1436 // Therefore Google Test is not thread-safe. 1437 # define GTEST_IS_THREADSAFE 0 1438 1439 #endif // GTEST_HAS_PTHREAD 1440 1441 // Returns the number of threads running in the process, or 0 to indicate that 1442 // we cannot detect it. 1443 GTEST_API_ size_t GetThreadCount(); 1444 1445 // Passing non-POD classes through ellipsis (...) crashes the ARM 1446 // compiler and generates a warning in Sun Studio. The Nokia Symbian 1447 // and the IBM XL C/C++ compiler try to instantiate a copy constructor 1448 // for objects passed through ellipsis (...), failing for uncopyable 1449 // objects. We define this to ensure that only POD is passed through 1450 // ellipsis on these systems. 1451 #if defined(__SYMBIAN32__) || defined(__IBMCPP__) || defined(__SUNPRO_CC) 1452 // We lose support for NULL detection where the compiler doesn't like 1453 // passing non-POD classes through ellipsis (...). 1454 # define GTEST_ELLIPSIS_NEEDS_POD_ 1 1455 #else 1456 # define GTEST_CAN_COMPARE_NULL 1 1457 #endif 1458 1459 // The Nokia Symbian and IBM XL C/C++ compilers cannot decide between 1460 // const T& and const T* in a function template. These compilers 1461 // _can_ decide between class template specializations for T and T*, 1462 // so a tr1::type_traits-like is_pointer works. 1463 #if defined(__SYMBIAN32__) || defined(__IBMCPP__) 1464 # define GTEST_NEEDS_IS_POINTER_ 1 1465 #endif 1466 1467 template <bool bool_value> 1468 struct bool_constant { 1469 typedef bool_constant<bool_value> type; 1470 static const bool value = bool_value; 1471 }; 1472 template <bool bool_value> const bool bool_constant<bool_value>::value; 1473 1474 typedef bool_constant<false> false_type; 1475 typedef bool_constant<true> true_type; 1476 1477 template <typename T> 1478 struct is_pointer : public false_type {}; 1479 1480 template <typename T> 1481 struct is_pointer<T*> : public true_type {}; 1482 1483 template <typename Iterator> 1484 struct IteratorTraits { 1485 typedef typename Iterator::value_type value_type; 1486 }; 1487 1488 template <typename T> 1489 struct IteratorTraits<T*> { 1490 typedef T value_type; 1491 }; 1492 1493 template <typename T> 1494 struct IteratorTraits<const T*> { 1495 typedef T value_type; 1496 }; 1497 1498 #if GTEST_OS_WINDOWS 1499 # define GTEST_PATH_SEP_ "\\" 1500 # define GTEST_HAS_ALT_PATH_SEP_ 1 1501 // The biggest signed integer type the compiler supports. 1502 typedef __int64 BiggestInt; 1503 #else 1504 # define GTEST_PATH_SEP_ "/" 1505 # define GTEST_HAS_ALT_PATH_SEP_ 0 1506 typedef long long BiggestInt; // NOLINT 1507 #endif // GTEST_OS_WINDOWS 1508 1509 // Utilities for char. 1510 1511 // isspace(int ch) and friends accept an unsigned char or EOF. char 1512 // may be signed, depending on the compiler (or compiler flags). 1513 // Therefore we need to cast a char to unsigned char before calling 1514 // isspace(), etc. 1515 1516 inline bool IsAlpha(char ch) { 1517 return isalpha(static_cast<unsigned char>(ch)) != 0; 1518 } 1519 inline bool IsAlNum(char ch) { 1520 return isalnum(static_cast<unsigned char>(ch)) != 0; 1521 } 1522 inline bool IsDigit(char ch) { 1523 return isdigit(static_cast<unsigned char>(ch)) != 0; 1524 } 1525 inline bool IsLower(char ch) { 1526 return islower(static_cast<unsigned char>(ch)) != 0; 1527 } 1528 inline bool IsSpace(char ch) { 1529 return isspace(static_cast<unsigned char>(ch)) != 0; 1530 } 1531 inline bool IsUpper(char ch) { 1532 return isupper(static_cast<unsigned char>(ch)) != 0; 1533 } 1534 inline bool IsXDigit(char ch) { 1535 return isxdigit(static_cast<unsigned char>(ch)) != 0; 1536 } 1537 1538 inline char ToLower(char ch) { 1539 return static_cast<char>(tolower(static_cast<unsigned char>(ch))); 1540 } 1541 inline char ToUpper(char ch) { 1542 return static_cast<char>(toupper(static_cast<unsigned char>(ch))); 1543 } 1544 1545 // The testing::internal::posix namespace holds wrappers for common 1546 // POSIX functions. These wrappers hide the differences between 1547 // Windows/MSVC and POSIX systems. Since some compilers define these 1548 // standard functions as macros, the wrapper cannot have the same name 1549 // as the wrapped function. 1550 1551 namespace posix { 1552 1553 // Functions with a different name on Windows. 1554 1555 #if GTEST_OS_WINDOWS 1556 1557 typedef struct _stat StatStruct; 1558 1559 # ifdef __BORLANDC__ 1560 inline int IsATTY(int fd) { return isatty(fd); } 1561 inline int StrCaseCmp(const char* s1, const char* s2) { 1562 return stricmp(s1, s2); 1563 } 1564 inline char* StrDup(const char* src) { return strdup(src); } 1565 # else // !__BORLANDC__ 1566 # if GTEST_OS_WINDOWS_MOBILE 1567 inline int IsATTY(int /* fd */) { return 0; } 1568 # else 1569 inline int IsATTY(int fd) { return _isatty(fd); } 1570 # endif // GTEST_OS_WINDOWS_MOBILE 1571 inline int StrCaseCmp(const char* s1, const char* s2) { 1572 return _stricmp(s1, s2); 1573 } 1574 inline char* StrDup(const char* src) { return _strdup(src); } 1575 # endif // __BORLANDC__ 1576 1577 # if GTEST_OS_WINDOWS_MOBILE 1578 inline int FileNo(FILE* file) { return reinterpret_cast<int>(_fileno(file)); } 1579 // Stat(), RmDir(), and IsDir() are not needed on Windows CE at this 1580 // time and thus not defined there. 1581 # else 1582 inline int FileNo(FILE* file) { return _fileno(file); } 1583 inline int Stat(const char* path, StatStruct* buf) { return _stat(path, buf); } 1584 inline int RmDir(const char* dir) { return _rmdir(dir); } 1585 inline bool IsDir(const StatStruct& st) { 1586 return (_S_IFDIR & st.st_mode) != 0; 1587 } 1588 # endif // GTEST_OS_WINDOWS_MOBILE 1589 1590 #else 1591 1592 typedef struct stat StatStruct; 1593 1594 inline int FileNo(FILE* file) { return fileno(file); } 1595 inline int IsATTY(int fd) { return isatty(fd); } 1596 inline int Stat(const char* path, StatStruct* buf) { return stat(path, buf); } 1597 inline int StrCaseCmp(const char* s1, const char* s2) { 1598 return strcasecmp(s1, s2); 1599 } 1600 inline char* StrDup(const char* src) { return strdup(src); } 1601 inline int RmDir(const char* dir) { return rmdir(dir); } 1602 inline bool IsDir(const StatStruct& st) { return S_ISDIR(st.st_mode); } 1603 1604 #endif // GTEST_OS_WINDOWS 1605 1606 // Functions deprecated by MSVC 8.0. 1607 1608 #ifdef _MSC_VER 1609 // Temporarily disable warning 4996 (deprecated function). 1610 # pragma warning(push) 1611 # pragma warning(disable:4996) 1612 #endif 1613 1614 inline const char* StrNCpy(char* dest, const char* src, size_t n) { 1615 return strncpy(dest, src, n); 1616 } 1617 1618 // ChDir(), FReopen(), FDOpen(), Read(), Write(), Close(), and 1619 // StrError() aren't needed on Windows CE at this time and thus not 1620 // defined there. 1621 1622 #if !GTEST_OS_WINDOWS_MOBILE 1623 inline int ChDir(const char* dir) { return chdir(dir); } 1624 #endif 1625 inline FILE* FOpen(const char* path, const char* mode) { 1626 return fopen(path, mode); 1627 } 1628 #if !GTEST_OS_WINDOWS_MOBILE 1629 inline FILE *FReopen(const char* path, const char* mode, FILE* stream) { 1630 return freopen(path, mode, stream); 1631 } 1632 inline FILE* FDOpen(int fd, const char* mode) { return fdopen(fd, mode); } 1633 #endif 1634 inline int FClose(FILE* fp) { return fclose(fp); } 1635 #if !GTEST_OS_WINDOWS_MOBILE 1636 inline int Read(int fd, void* buf, unsigned int count) { 1637 return static_cast<int>(read(fd, buf, count)); 1638 } 1639 inline int Write(int fd, const void* buf, unsigned int count) { 1640 return static_cast<int>(write(fd, buf, count)); 1641 } 1642 inline int Close(int fd) { return close(fd); } 1643 inline const char* StrError(int errnum) { return strerror(errnum); } 1644 #endif 1645 inline const char* GetEnv(const char* name) { 1646 #if GTEST_OS_WINDOWS_MOBILE 1647 // We are on Windows CE, which has no environment variables. 1648 return NULL; 1649 #elif defined(__BORLANDC__) || defined(__SunOS_5_8) || defined(__SunOS_5_9) 1650 // Environment variables which we programmatically clear will be set to the 1651 // empty string rather than unset (NULL). Handle that case. 1652 const char* const env = getenv(name); 1653 return (env != NULL && env[0] != '\0') ? env : NULL; 1654 #else 1655 return getenv(name); 1656 #endif 1657 } 1658 1659 #ifdef _MSC_VER 1660 # pragma warning(pop) // Restores the warning state. 1661 #endif 1662 1663 #if GTEST_OS_WINDOWS_MOBILE 1664 // Windows CE has no C library. The abort() function is used in 1665 // several places in Google Test. This implementation provides a reasonable 1666 // imitation of standard behaviour. 1667 void Abort(); 1668 #else 1669 inline void Abort() { abort(); } 1670 #endif // GTEST_OS_WINDOWS_MOBILE 1671 1672 } // namespace posix 1673 1674 // The maximum number a BiggestInt can represent. This definition 1675 // works no matter BiggestInt is represented in one's complement or 1676 // two's complement. 1677 // 1678 // We cannot rely on numeric_limits in STL, as __int64 and long long 1679 // are not part of standard C++ and numeric_limits doesn't need to be 1680 // defined for them. 1681 const BiggestInt kMaxBiggestInt = 1682 ~(static_cast<BiggestInt>(1) << (8*sizeof(BiggestInt) - 1)); 1683 1684 // This template class serves as a compile-time function from size to 1685 // type. It maps a size in bytes to a primitive type with that 1686 // size. e.g. 1687 // 1688 // TypeWithSize<4>::UInt 1689 // 1690 // is typedef-ed to be unsigned int (unsigned integer made up of 4 1691 // bytes). 1692 // 1693 // Such functionality should belong to STL, but I cannot find it 1694 // there. 1695 // 1696 // Google Test uses this class in the implementation of floating-point 1697 // comparison. 1698 // 1699 // For now it only handles UInt (unsigned int) as that's all Google Test 1700 // needs. Other types can be easily added in the future if need 1701 // arises. 1702 template <size_t size> 1703 class TypeWithSize { 1704 public: 1705 // This prevents the user from using TypeWithSize<N> with incorrect 1706 // values of N. 1707 typedef void UInt; 1708 }; 1709 1710 // The specialization for size 4. 1711 template <> 1712 class TypeWithSize<4> { 1713 public: 1714 // unsigned int has size 4 in both gcc and MSVC. 1715 // 1716 // As base/basictypes.h doesn't compile on Windows, we cannot use 1717 // uint32, uint64, and etc here. 1718 typedef int Int; 1719 typedef unsigned int UInt; 1720 }; 1721 1722 // The specialization for size 8. 1723 template <> 1724 class TypeWithSize<8> { 1725 public: 1726 1727 #if GTEST_OS_WINDOWS 1728 typedef __int64 Int; 1729 typedef unsigned __int64 UInt; 1730 #else 1731 typedef long long Int; // NOLINT 1732 typedef unsigned long long UInt; // NOLINT 1733 #endif // GTEST_OS_WINDOWS 1734 }; 1735 1736 // Integer types of known sizes. 1737 typedef TypeWithSize<4>::Int Int32; 1738 typedef TypeWithSize<4>::UInt UInt32; 1739 typedef TypeWithSize<8>::Int Int64; 1740 typedef TypeWithSize<8>::UInt UInt64; 1741 typedef TypeWithSize<8>::Int TimeInMillis; // Represents time in milliseconds. 1742 1743 // Utilities for command line flags and environment variables. 1744 1745 // Macro for referencing flags. 1746 #define GTEST_FLAG(name) FLAGS_gtest_##name 1747 1748 // Macros for declaring flags. 1749 #define GTEST_DECLARE_bool_(name) GTEST_API_ extern bool GTEST_FLAG(name) 1750 #define GTEST_DECLARE_int32_(name) \ 1751 GTEST_API_ extern ::testing::internal::Int32 GTEST_FLAG(name) 1752 #define GTEST_DECLARE_string_(name) \ 1753 GTEST_API_ extern ::testing::internal::String GTEST_FLAG(name) 1754 1755 // Macros for defining flags. 1756 #define GTEST_DEFINE_bool_(name, default_val, doc) \ 1757 GTEST_API_ bool GTEST_FLAG(name) = (default_val) 1758 #define GTEST_DEFINE_int32_(name, default_val, doc) \ 1759 GTEST_API_ ::testing::internal::Int32 GTEST_FLAG(name) = (default_val) 1760 #define GTEST_DEFINE_string_(name, default_val, doc) \ 1761 GTEST_API_ ::testing::internal::String GTEST_FLAG(name) = (default_val) 1762 1763 // Parses 'str' for a 32-bit signed integer. If successful, writes the result 1764 // to *value and returns true; otherwise leaves *value unchanged and returns 1765 // false. 1766 // TODO(chandlerc): Find a better way to refactor flag and environment parsing 1767 // out of both gtest-port.cc and gtest.cc to avoid exporting this utility 1768 // function. 1769 bool ParseInt32(const Message& src_text, const char* str, Int32* value); 1770 1771 // Parses a bool/Int32/string from the environment variable 1772 // corresponding to the given Google Test flag. 1773 bool BoolFromGTestEnv(const char* flag, bool default_val); 1774 GTEST_API_ Int32 Int32FromGTestEnv(const char* flag, Int32 default_val); 1775 const char* StringFromGTestEnv(const char* flag, const char* default_val); 1776 1777 } // namespace internal 1778 } // namespace testing 1779 1780 #endif // GTEST_INCLUDE_GTEST_INTERNAL_GTEST_PORT_H_ 1781