ut/gtest/googletest/src/gtest-port.cc

   1 // Copyright 2008, 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 // Author: wan@google.com (Zhanyong Wan)
  31
  32 #include "gtest/internal/gtest-port.h"
  33
  34 #include <limits.h>
  35 #include <stdlib.h>
  36 #include <stdio.h>
  37 #include <string.h>
  38 #include <fstream>
  39
  40 #if GTEST_OS_WINDOWS
  41 # include <windows.h>
  42 # include <io.h>
  43 # include <sys/stat.h>
  44 # include <map>  // Used in ThreadLocal.
  45 #else
  46 # include <unistd.h>
  47 #endif  // GTEST_OS_WINDOWS
  48
  49 #if GTEST_OS_MAC
  50 # include <mach/mach_init.h>
  51 # include <mach/task.h>
  52 # include <mach/vm_map.h>
  53 #endif  // GTEST_OS_MAC
  54
  55 #if GTEST_OS_QNX
  56 # include <devctl.h>
  57 # include <fcntl.h>
  58 # include <sys/procfs.h>
  59 #endif  // GTEST_OS_QNX
  60
  61 #if GTEST_OS_AIX
  62 # include <procinfo.h>
  63 # include <sys/types.h>
  64 #endif  // GTEST_OS_AIX
  65
  66 #include "gtest/gtest-spi.h"
  67 #include "gtest/gtest-message.h"
  68 #include "gtest/internal/gtest-internal.h"
  69 #include "gtest/internal/gtest-string.h"
  70
  71 // Indicates that this translation unit is part of Google Test's
  72 // implementation.  It must come before gtest-internal-inl.h is
  73 // included, or there will be a compiler error.  This trick exists to
  74 // prevent the accidental inclusion of gtest-internal-inl.h in the
  75 // user's code.
  76 #define GTEST_IMPLEMENTATION_ 1
  77 #include "src/gtest-internal-inl.h"
  78 #undef GTEST_IMPLEMENTATION_
  79
  80 namespace testing {
  81 namespace internal {
  82
  83 #if defined(_MSC_VER) || defined(__BORLANDC__)
  84 // MSVC and C++Builder do not provide a definition of STDERR_FILENO.
  85 const int kStdOutFileno = 1;
  86 const int kStdErrFileno = 2;
  87 #else
  88 const int kStdOutFileno = STDOUT_FILENO;
  89 const int kStdErrFileno = STDERR_FILENO;
  90 #endif  // _MSC_VER
  91
  92 #if GTEST_OS_LINUX
  93
  94 namespace {
  95 template <typename T>
  96 T ReadProcFileField(const string& filename, int field) {
  97   std::string dummy;
  98   std::ifstream file(filename.c_str());
  99   while (field-- > 0) {
 100     file >> dummy;
 101   }
 102   T output = 0;
 103   file >> output;
 104   return output;
 105 }
 106 }  // namespace
 107
 108 // Returns the number of active threads, or 0 when there is an error.
 109 size_t GetThreadCount() {
 110   const string filename =
 111       (Message() << "/proc/" << getpid() << "/stat").GetString();
 112   return ReadProcFileField<int>(filename, 19);
 113 }
 114
 115 #elif GTEST_OS_MAC
 116
 117 size_t GetThreadCount() {
 118   const task_t task = mach_task_self();
 119   mach_msg_type_number_t thread_count;
 120   thread_act_array_t thread_list;
 121   const kern_return_t status = task_threads(task, &thread_list, &thread_count);
 122   if (status == KERN_SUCCESS) {
 123     // task_threads allocates resources in thread_list and we need to free them
 124     // to avoid leaks.
 125     vm_deallocate(task,
 126                   reinterpret_cast<vm_address_t>(thread_list),
 127                   sizeof(thread_t) * thread_count);
 128     return static_cast<size_t>(thread_count);
 129   } else {
 130     return 0;
 131   }
 132 }
 133
 134 #elif GTEST_OS_QNX
 135
 136 // Returns the number of threads running in the process, or 0 to indicate that
 137 // we cannot detect it.
 138 size_t GetThreadCount() {
 139   const int fd = open("/proc/self/as", O_RDONLY);
 140   if (fd < 0) {
 141     return 0;
 142   }
 143   procfs_info process_info;
 144   const int status =
 145       devctl(fd, DCMD_PROC_INFO, &process_info, sizeof(process_info), NULL);
 146   close(fd);
 147   if (status == EOK) {
 148     return static_cast<size_t>(process_info.num_threads);
 149   } else {
 150     return 0;
 151   }
 152 }
 153
 154 #elif GTEST_OS_AIX
 155
 156 size_t GetThreadCount() {
 157   struct procentry64 entry;
 158   pid_t pid = getpid();
 159   int status = getprocs64(&entry, sizeof(entry), NULL, 0, &pid, 1);
 160   if (status == 1) {
 161     return entry.pi_thcount;
 162   } else {
 163     return 0;
 164   }
 165 }
 166
 167 #else
 168
 169 size_t GetThreadCount() {
 170   // There's no portable way to detect the number of threads, so we just
 171   // return 0 to indicate that we cannot detect it.
 172   return 0;
 173 }
 174
 175 #endif  // GTEST_OS_LINUX
 176
 177 #if GTEST_IS_THREADSAFE && GTEST_OS_WINDOWS
 178
 179 void SleepMilliseconds(int n) {
 180   ::Sleep(n);
 181 }
 182
 183 AutoHandle::AutoHandle()
 184     : handle_(INVALID_HANDLE_VALUE) {}
 185
 186 AutoHandle::AutoHandle(Handle handle)
 187     : handle_(handle) {}
 188
 189 AutoHandle::~AutoHandle() {
 190   Reset();
 191 }
 192
 193 AutoHandle::Handle AutoHandle::Get() const {
 194   return handle_;
 195 }
 196
 197 void AutoHandle::Reset() {
 198   Reset(INVALID_HANDLE_VALUE);
 199 }
 200
 201 void AutoHandle::Reset(HANDLE handle) {
 202   // Resetting with the same handle we already own is invalid.
 203   if (handle_ != handle) {
 204     if (IsCloseable()) {
 205       ::CloseHandle(handle_);
 206     }
 207     handle_ = handle;
 208   } else {
 209     GTEST_CHECK_(!IsCloseable())
 210         << "Resetting a valid handle to itself is likely a programmer error "
 211             "and thus not allowed.";
 212   }
 213 }
 214
 215 bool AutoHandle::IsCloseable() const {
 216   // Different Windows APIs may use either of these values to represent an
 217   // invalid handle.
 218   return handle_ != NULL && handle_ != INVALID_HANDLE_VALUE;
 219 }
 220
 221 Notification::Notification()
 222     : event_(::CreateEvent(NULL,   // Default security attributes.
 223                            TRUE,   // Do not reset automatically.
 224                            FALSE,  // Initially unset.
 225                            NULL)) {  // Anonymous event.
 226   GTEST_CHECK_(event_.Get() != NULL);
 227 }
 228
 229 void Notification::Notify() {
 230   GTEST_CHECK_(::SetEvent(event_.Get()) != FALSE);
 231 }
 232
 233 void Notification::WaitForNotification() {
 234   GTEST_CHECK_(
 235       ::WaitForSingleObject(event_.Get(), INFINITE) == WAIT_OBJECT_0);
 236 }
 237
 238 Mutex::Mutex()
 239     : owner_thread_id_(0),
 240       type_(kDynamic),
 241       critical_section_init_phase_(0),
 242       critical_section_(new CRITICAL_SECTION) {
 243   ::InitializeCriticalSection(critical_section_);
 244 }
 245
 246 Mutex::~Mutex() {
 247   // Static mutexes are leaked intentionally. It is not thread-safe to try
 248   // to clean them up.
 249   // TODO(yukawa): Switch to Slim Reader/Writer (SRW) Locks, which requires
 250   // nothing to clean it up but is available only on Vista and later.
 251   // http://msdn.microsoft.com/en-us/library/windows/desktop/aa904937.aspx
 252   if (type_ == kDynamic) {
 253     ::DeleteCriticalSection(critical_section_);
 254     delete critical_section_;
 255     critical_section_ = NULL;
 256   }
 257 }
 258
 259 void Mutex::Lock() {
 260   ThreadSafeLazyInit();
 261   ::EnterCriticalSection(critical_section_);
 262   owner_thread_id_ = ::GetCurrentThreadId();
 263 }
 264
 265 void Mutex::Unlock() {
 266   ThreadSafeLazyInit();
 267   // We don't protect writing to owner_thread_id_ here, as it's the
 268   // caller's responsibility to ensure that the current thread holds the
 269   // mutex when this is called.
 270   owner_thread_id_ = 0;
 271   ::LeaveCriticalSection(critical_section_);
 272 }
 273
 274 // Does nothing if the current thread holds the mutex. Otherwise, crashes
 275 // with high probability.
 276 void Mutex::AssertHeld() {
 277   ThreadSafeLazyInit();
 278   GTEST_CHECK_(owner_thread_id_ == ::GetCurrentThreadId())
 279       << "The current thread is not holding the mutex @" << this;
 280 }
 281
 282 // Initializes owner_thread_id_ and critical_section_ in static mutexes.
 283 void Mutex::ThreadSafeLazyInit() {
 284   // Dynamic mutexes are initialized in the constructor.
 285   if (type_ == kStatic) {
 286     switch (
 287         ::InterlockedCompareExchange(&critical_section_init_phase_, 1L, 0L)) {
 288       case 0:
 289         // If critical_section_init_phase_ was 0 before the exchange, we
 290         // are the first to test it and need to perform the initialization.
 291         owner_thread_id_ = 0;
 292         critical_section_ = new CRITICAL_SECTION;
 293         ::InitializeCriticalSection(critical_section_);
 294         // Updates the critical_section_init_phase_ to 2 to signal
 295         // initialization complete.
 296         GTEST_CHECK_(::InterlockedCompareExchange(
 297                           &critical_section_init_phase_, 2L, 1L) ==
 298                       1L);
 299         break;
 300       case 1:
 301         // Somebody else is already initializing the mutex; spin until they
 302         // are done.
 303         while (::InterlockedCompareExchange(&critical_section_init_phase_,
 304                                             2L,
 305                                             2L) != 2L) {
 306           // Possibly yields the rest of the thread's time slice to other
 307           // threads.
 308           ::Sleep(0);
 309         }
 310         break;
 311
 312       case 2:
 313         break;  // The mutex is already initialized and ready for use.
 314
 315       default:
 316         GTEST_CHECK_(false)
 317             << "Unexpected value of critical_section_init_phase_ "
 318             << "while initializing a static mutex.";
 319     }
 320   }
 321 }
 322
 323 namespace {
 324
 325 class ThreadWithParamSupport : public ThreadWithParamBase {
 326  public:
 327   static HANDLE CreateThread(Runnable* runnable,
 328                              Notification* thread_can_start) {
 329     ThreadMainParam* param = new ThreadMainParam(runnable, thread_can_start);
 330     DWORD thread_id;
 331     // TODO(yukawa): Consider to use _beginthreadex instead.
 332     HANDLE thread_handle = ::CreateThread(
 333         NULL,    // Default security.
 334         0,       // Default stack size.
 335         &ThreadWithParamSupport::ThreadMain,
 336         param,   // Parameter to ThreadMainStatic
 337         0x0,     // Default creation flags.
 338         &thread_id);  // Need a valid pointer for the call to work under Win98.
 339     GTEST_CHECK_(thread_handle != NULL) << "CreateThread failed with error "
 340                                         << ::GetLastError() << ".";
 341     if (thread_handle == NULL) {
 342       delete param;
 343     }
 344     return thread_handle;
 345   }
 346
 347  private:
 348   struct ThreadMainParam {
 349     ThreadMainParam(Runnable* runnable, Notification* thread_can_start)
 350         : runnable_(runnable),
 351           thread_can_start_(thread_can_start) {
 352     }
 353     scoped_ptr<Runnable> runnable_;
 354     // Does not own.
 355     Notification* thread_can_start_;
 356   };
 357
 358   static DWORD WINAPI ThreadMain(void* ptr) {
 359     // Transfers ownership.
 360     scoped_ptr<ThreadMainParam> param(static_cast<ThreadMainParam*>(ptr));
 361     if (param->thread_can_start_ != NULL)
 362       param->thread_can_start_->WaitForNotification();
 363     param->runnable_->Run();
 364     return 0;
 365   }
 366
 367   // Prohibit instantiation.
 368   ThreadWithParamSupport();
 369
 370   GTEST_DISALLOW_COPY_AND_ASSIGN_(ThreadWithParamSupport);
 371 };
 372
 373 }  // namespace
 374
 375 ThreadWithParamBase::ThreadWithParamBase(Runnable *runnable,
 376                                          Notification* thread_can_start)
 377       : thread_(ThreadWithParamSupport::CreateThread(runnable,
 378                                                      thread_can_start)) {
 379 }
 380
 381 ThreadWithParamBase::~ThreadWithParamBase() {
 382   Join();
 383 }
 384
 385 void ThreadWithParamBase::Join() {
 386   GTEST_CHECK_(::WaitForSingleObject(thread_.Get(), INFINITE) == WAIT_OBJECT_0)
 387       << "Failed to join the thread with error " << ::GetLastError() << ".";
 388 }
 389
 390 // Maps a thread to a set of ThreadIdToThreadLocals that have values
 391 // instantiated on that thread and notifies them when the thread exits.  A
 392 // ThreadLocal instance is expected to persist until all threads it has
 393 // values on have terminated.
 394 class ThreadLocalRegistryImpl {
 395  public:
 396   // Registers thread_local_instance as having value on the current thread.
 397   // Returns a value that can be used to identify the thread from other threads.
 398   static ThreadLocalValueHolderBase* GetValueOnCurrentThread(
 399       const ThreadLocalBase* thread_local_instance) {
 400     DWORD current_thread = ::GetCurrentThreadId();
 401     MutexLock lock(&mutex_);
 402     ThreadIdToThreadLocals* const thread_to_thread_locals =
 403         GetThreadLocalsMapLocked();
 404     ThreadIdToThreadLocals::iterator thread_local_pos =
 405         thread_to_thread_locals->find(current_thread);
 406     if (thread_local_pos == thread_to_thread_locals->end()) {
 407       thread_local_pos = thread_to_thread_locals->insert(
 408           std::make_pair(current_thread, ThreadLocalValues())).first;
 409       StartWatcherThreadFor(current_thread);
 410     }
 411     ThreadLocalValues& thread_local_values = thread_local_pos->second;
 412     ThreadLocalValues::iterator value_pos =
 413         thread_local_values.find(thread_local_instance);
 414     if (value_pos == thread_local_values.end()) {
 415       value_pos =
 416           thread_local_values
 417               .insert(std::make_pair(
 418                   thread_local_instance,
 419                   linked_ptr<ThreadLocalValueHolderBase>(
 420                       thread_local_instance->NewValueForCurrentThread())))
 421               .first;
 422     }
 423     return value_pos->second.get();
 424   }
 425
 426   static void OnThreadLocalDestroyed(
 427       const ThreadLocalBase* thread_local_instance) {
 428     std::vector<linked_ptr<ThreadLocalValueHolderBase> > value_holders;
 429     // Clean up the ThreadLocalValues data structure while holding the lock, but
 430     // defer the destruction of the ThreadLocalValueHolderBases.
 431     {
 432       MutexLock lock(&mutex_);
 433       ThreadIdToThreadLocals* const thread_to_thread_locals =
 434           GetThreadLocalsMapLocked();
 435       for (ThreadIdToThreadLocals::iterator it =
 436           thread_to_thread_locals->begin();
 437           it != thread_to_thread_locals->end();
 438           ++it) {
 439         ThreadLocalValues& thread_local_values = it->second;
 440         ThreadLocalValues::iterator value_pos =
 441             thread_local_values.find(thread_local_instance);
 442         if (value_pos != thread_local_values.end()) {
 443           value_holders.push_back(value_pos->second);
 444           thread_local_values.erase(value_pos);
 445           // This 'if' can only be successful at most once, so theoretically we
 446           // could break out of the loop here, but we don't bother doing so.
 447         }
 448       }
 449     }
 450     // Outside the lock, let the destructor for 'value_holders' deallocate the
 451     // ThreadLocalValueHolderBases.
 452   }
 453
 454   static void OnThreadExit(DWORD thread_id) {
 455     GTEST_CHECK_(thread_id != 0) << ::GetLastError();
 456     std::vector<linked_ptr<ThreadLocalValueHolderBase> > value_holders;
 457     // Clean up the ThreadIdToThreadLocals data structure while holding the
 458     // lock, but defer the destruction of the ThreadLocalValueHolderBases.
 459     {
 460       MutexLock lock(&mutex_);
 461       ThreadIdToThreadLocals* const thread_to_thread_locals =
 462           GetThreadLocalsMapLocked();
 463       ThreadIdToThreadLocals::iterator thread_local_pos =
 464           thread_to_thread_locals->find(thread_id);
 465       if (thread_local_pos != thread_to_thread_locals->end()) {
 466         ThreadLocalValues& thread_local_values = thread_local_pos->second;
 467         for (ThreadLocalValues::iterator value_pos =
 468             thread_local_values.begin();
 469             value_pos != thread_local_values.end();
 470             ++value_pos) {
 471           value_holders.push_back(value_pos->second);
 472         }
 473         thread_to_thread_locals->erase(thread_local_pos);
 474       }
 475     }
 476     // Outside the lock, let the destructor for 'value_holders' deallocate the
 477     // ThreadLocalValueHolderBases.
 478   }
 479
 480  private:
 481   // In a particular thread, maps a ThreadLocal object to its value.
 482   typedef std::map<const ThreadLocalBase*,
 483                    linked_ptr<ThreadLocalValueHolderBase> > ThreadLocalValues;
 484   // Stores all ThreadIdToThreadLocals having values in a thread, indexed by
 485   // thread's ID.
 486   typedef std::map<DWORD, ThreadLocalValues> ThreadIdToThreadLocals;
 487
 488   // Holds the thread id and thread handle that we pass from
 489   // StartWatcherThreadFor to WatcherThreadFunc.
 490   typedef std::pair<DWORD, HANDLE> ThreadIdAndHandle;
 491
 492   static void StartWatcherThreadFor(DWORD thread_id) {
 493     // The returned handle will be kept in thread_map and closed by
 494     // watcher_thread in WatcherThreadFunc.
 495     HANDLE thread = ::OpenThread(SYNCHRONIZE | THREAD_QUERY_INFORMATION,
 496                                  FALSE,
 497                                  thread_id);
 498     GTEST_CHECK_(thread != NULL);
 499     // We need to to pass a valid thread ID pointer into CreateThread for it
 500     // to work correctly under Win98.
 501     DWORD watcher_thread_id;
 502     HANDLE watcher_thread = ::CreateThread(
 503         NULL,   // Default security.
 504         0,      // Default stack size
 505         &ThreadLocalRegistryImpl::WatcherThreadFunc,
 506         reinterpret_cast<LPVOID>(new ThreadIdAndHandle(thread_id, thread)),
 507         CREATE_SUSPENDED,
 508         &watcher_thread_id);
 509     GTEST_CHECK_(watcher_thread != NULL);
 510     // Give the watcher thread the same priority as ours to avoid being
 511     // blocked by it.
 512     ::SetThreadPriority(watcher_thread,
 513                         ::GetThreadPriority(::GetCurrentThread()));
 514     ::ResumeThread(watcher_thread);
 515     ::CloseHandle(watcher_thread);
 516   }
 517
 518   // Monitors exit from a given thread and notifies those
 519   // ThreadIdToThreadLocals about thread termination.
 520   static DWORD WINAPI WatcherThreadFunc(LPVOID param) {
 521     const ThreadIdAndHandle* tah =
 522         reinterpret_cast<const ThreadIdAndHandle*>(param);
 523     GTEST_CHECK_(
 524         ::WaitForSingleObject(tah->second, INFINITE) == WAIT_OBJECT_0);
 525     OnThreadExit(tah->first);
 526     ::CloseHandle(tah->second);
 527     delete tah;
 528     return 0;
 529   }
 530
 531   // Returns map of thread local instances.
 532   static ThreadIdToThreadLocals* GetThreadLocalsMapLocked() {
 533     mutex_.AssertHeld();
 534     static ThreadIdToThreadLocals* map = new ThreadIdToThreadLocals;
 535     return map;
 536   }
 537
 538   // Protects access to GetThreadLocalsMapLocked() and its return value.
 539   static Mutex mutex_;
 540   // Protects access to GetThreadMapLocked() and its return value.
 541   static Mutex thread_map_mutex_;
 542 };
 543
 544 Mutex ThreadLocalRegistryImpl::mutex_(Mutex::kStaticMutex);
 545 Mutex ThreadLocalRegistryImpl::thread_map_mutex_(Mutex::kStaticMutex);
 546
 547 ThreadLocalValueHolderBase* ThreadLocalRegistry::GetValueOnCurrentThread(
 548       const ThreadLocalBase* thread_local_instance) {
 549   return ThreadLocalRegistryImpl::GetValueOnCurrentThread(
 550       thread_local_instance);
 551 }
 552
 553 void ThreadLocalRegistry::OnThreadLocalDestroyed(
 554       const ThreadLocalBase* thread_local_instance) {
 555   ThreadLocalRegistryImpl::OnThreadLocalDestroyed(thread_local_instance);
 556 }
 557
 558 #endif  // GTEST_IS_THREADSAFE && GTEST_OS_WINDOWS
 559
 560 #if GTEST_USES_POSIX_RE
 561
 562 // Implements RE.  Currently only needed for death tests.
 563
 564 RE::~RE() {
 565   if (is_valid_) {
 566     // regfree'ing an invalid regex might crash because the content
 567     // of the regex is undefined. Since the regex's are essentially
 568     // the same, one cannot be valid (or invalid) without the other
 569     // being so too.
 570     regfree(&partial_regex_);
 571     regfree(&full_regex_);
 572   }
 573   free(const_cast<char*>(pattern_));
 574 }
 575
 576 // Returns true iff regular expression re matches the entire str.
 577 bool RE::FullMatch(const char* str, const RE& re) {
 578   if (!re.is_valid_) return false;
 579
 580   regmatch_t match;
 581   return regexec(&re.full_regex_, str, 1, &match, 0) == 0;
 582 }
 583
 584 // Returns true iff regular expression re matches a substring of str
 585 // (including str itself).
 586 bool RE::PartialMatch(const char* str, const RE& re) {
 587   if (!re.is_valid_) return false;
 588
 589   regmatch_t match;
 590   return regexec(&re.partial_regex_, str, 1, &match, 0) == 0;
 591 }
 592
 593 // Initializes an RE from its string representation.
 594 void RE::Init(const char* regex) {
 595   pattern_ = posix::StrDup(regex);
 596
 597   // Reserves enough bytes to hold the regular expression used for a
 598   // full match.
 599   const size_t full_regex_len = strlen(regex) + 10;
 600   char* const full_pattern = new char[full_regex_len];
 601
 602   snprintf(full_pattern, full_regex_len, "^(%s)$", regex);
 603   is_valid_ = regcomp(&full_regex_, full_pattern, REG_EXTENDED) == 0;
 604   // We want to call regcomp(&partial_regex_, ...) even if the
 605   // previous expression returns false.  Otherwise partial_regex_ may
 606   // not be properly initialized can may cause trouble when it's
 607   // freed.
 608   //
 609   // Some implementation of POSIX regex (e.g. on at least some
 610   // versions of Cygwin) doesn't accept the empty string as a valid
 611   // regex.  We change it to an equivalent form "()" to be safe.
 612   if (is_valid_) {
 613     const char* const partial_regex = (*regex == '\0') ? "()" : regex;
 614     is_valid_ = regcomp(&partial_regex_, partial_regex, REG_EXTENDED) == 0;
 615   }
 616   EXPECT_TRUE(is_valid_)
 617       << "Regular expression \"" << regex
 618       << "\" is not a valid POSIX Extended regular expression.";
 619
 620   delete[] full_pattern;
 621 }
 622
 623 #elif GTEST_USES_SIMPLE_RE
 624
 625 // Returns true iff ch appears anywhere in str (excluding the
 626 // terminating '\0' character).
 627 bool IsInSet(char ch, const char* str) {
 628   return ch != '\0' && strchr(str, ch) != NULL;
 629 }
 630
 631 // Returns true iff ch belongs to the given classification.  Unlike
 632 // similar functions in <ctype.h>, these aren't affected by the
 633 // current locale.
 634 bool IsAsciiDigit(char ch) { return '0' <= ch && ch <= '9'; }
 635 bool IsAsciiPunct(char ch) {
 636   return IsInSet(ch, "^-!\"#$%&'()*+,./:;<=>?@[\\]_`{|}~");
 637 }
 638 bool IsRepeat(char ch) { return IsInSet(ch, "?*+"); }
 639 bool IsAsciiWhiteSpace(char ch) { return IsInSet(ch, " \f\n\r\t\v"); }
 640 bool IsAsciiWordChar(char ch) {
 641   return ('a' <= ch && ch <= 'z') || ('A' <= ch && ch <= 'Z') ||
 642       ('0' <= ch && ch <= '9') || ch == '_';
 643 }
 644
 645 // Returns true iff "\\c" is a supported escape sequence.
 646 bool IsValidEscape(char c) {
 647   return (IsAsciiPunct(c) || IsInSet(c, "dDfnrsStvwW"));
 648 }
 649
 650 // Returns true iff the given atom (specified by escaped and pattern)
 651 // matches ch.  The result is undefined if the atom is invalid.
 652 bool AtomMatchesChar(bool escaped, char pattern_char, char ch) {
 653   if (escaped) {  // "\\p" where p is pattern_char.
 654     switch (pattern_char) {
 655       case 'd': return IsAsciiDigit(ch);
 656       case 'D': return !IsAsciiDigit(ch);
 657       case 'f': return ch == '\f';
 658       case 'n': return ch == '\n';
 659       case 'r': return ch == '\r';
 660       case 's': return IsAsciiWhiteSpace(ch);
 661       case 'S': return !IsAsciiWhiteSpace(ch);
 662       case 't': return ch == '\t';
 663       case 'v': return ch == '\v';
 664       case 'w': return IsAsciiWordChar(ch);
 665       case 'W': return !IsAsciiWordChar(ch);
 666     }
 667     return IsAsciiPunct(pattern_char) && pattern_char == ch;
 668   }
 669
 670   return (pattern_char == '.' && ch != '\n') || pattern_char == ch;
 671 }
 672
 673 // Helper function used by ValidateRegex() to format error messages.
 674 std::string FormatRegexSyntaxError(const char* regex, int index) {
 675   return (Message() << "Syntax error at index " << index
 676           << " in simple regular expression \"" << regex << "\": ").GetString();
 677 }
 678
 679 // Generates non-fatal failures and returns false if regex is invalid;
 680 // otherwise returns true.
 681 bool ValidateRegex(const char* regex) {
 682   if (regex == NULL) {
 683     // TODO(wan@google.com): fix the source file location in the
 684     // assertion failures to match where the regex is used in user
 685     // code.
 686     ADD_FAILURE() << "NULL is not a valid simple regular expression.";
 687     return false;
 688   }
 689
 690   bool is_valid = true;
 691
 692   // True iff ?, *, or + can follow the previous atom.
 693   bool prev_repeatable = false;
 694   for (int i = 0; regex[i]; i++) {
 695     if (regex[i] == '\\') {  // An escape sequence
 696       i++;
 697       if (regex[i] == '\0') {
 698         ADD_FAILURE() << FormatRegexSyntaxError(regex, i - 1)
 699                       << "'\\' cannot appear at the end.";
 700         return false;
 701       }
 702
 703       if (!IsValidEscape(regex[i])) {
 704         ADD_FAILURE() << FormatRegexSyntaxError(regex, i - 1)
 705                       << "invalid escape sequence \"\\" << regex[i] << "\".";
 706         is_valid = false;
 707       }
 708       prev_repeatable = true;
 709     } else {  // Not an escape sequence.
 710       const char ch = regex[i];
 711
 712       if (ch == '^' && i > 0) {
 713         ADD_FAILURE() << FormatRegexSyntaxError(regex, i)
 714                       << "'^' can only appear at the beginning.";
 715         is_valid = false;
 716       } else if (ch == '$' && regex[i + 1] != '\0') {
 717         ADD_FAILURE() << FormatRegexSyntaxError(regex, i)
 718                       << "'$' can only appear at the end.";
 719         is_valid = false;
 720       } else if (IsInSet(ch, "()[]{}|")) {
 721         ADD_FAILURE() << FormatRegexSyntaxError(regex, i)
 722                       << "'" << ch << "' is unsupported.";
 723         is_valid = false;
 724       } else if (IsRepeat(ch) && !prev_repeatable) {
 725         ADD_FAILURE() << FormatRegexSyntaxError(regex, i)
 726                       << "'" << ch << "' can only follow a repeatable token.";
 727         is_valid = false;
 728       }
 729
 730       prev_repeatable = !IsInSet(ch, "^$?*+");
 731     }
 732   }
 733
 734   return is_valid;
 735 }
 736
 737 // Matches a repeated regex atom followed by a valid simple regular
 738 // expression.  The regex atom is defined as c if escaped is false,
 739 // or \c otherwise.  repeat is the repetition meta character (?, *,
 740 // or +).  The behavior is undefined if str contains too many
 741 // characters to be indexable by size_t, in which case the test will
 742 // probably time out anyway.  We are fine with this limitation as
 743 // std::string has it too.
 744 bool MatchRepetitionAndRegexAtHead(
 745     bool escaped, char c, char repeat, const char* regex,
 746     const char* str) {
 747   const size_t min_count = (repeat == '+') ? 1 : 0;
 748   const size_t max_count = (repeat == '?') ? 1 :
 749       static_cast<size_t>(-1) - 1;
 750   // We cannot call numeric_limits::max() as it conflicts with the
 751   // max() macro on Windows.
 752
 753   for (size_t i = 0; i <= max_count; ++i) {
 754     // We know that the atom matches each of the first i characters in str.
 755     if (i >= min_count && MatchRegexAtHead(regex, str + i)) {
 756       // We have enough matches at the head, and the tail matches too.
 757       // Since we only care about *whether* the pattern matches str
 758       // (as opposed to *how* it matches), there is no need to find a
 759       // greedy match.
 760       return true;
 761     }
 762     if (str[i] == '\0' || !AtomMatchesChar(escaped, c, str[i]))
 763       return false;
 764   }
 765   return false;
 766 }
 767
 768 // Returns true iff regex matches a prefix of str.  regex must be a
 769 // valid simple regular expression and not start with "^", or the
 770 // result is undefined.
 771 bool MatchRegexAtHead(const char* regex, const char* str) {
 772   if (*regex == '\0')  // An empty regex matches a prefix of anything.
 773     return true;
 774
 775   // "$" only matches the end of a string.  Note that regex being
 776   // valid guarantees that there's nothing after "$" in it.
 777   if (*regex == '$')
 778     return *str == '\0';
 779
 780   // Is the first thing in regex an escape sequence?
 781   const bool escaped = *regex == '\\';
 782   if (escaped)
 783     ++regex;
 784   if (IsRepeat(regex[1])) {
 785     // MatchRepetitionAndRegexAtHead() calls MatchRegexAtHead(), so
 786     // here's an indirect recursion.  It terminates as the regex gets
 787     // shorter in each recursion.
 788     return MatchRepetitionAndRegexAtHead(
 789         escaped, regex[0], regex[1], regex + 2, str);
 790   } else {
 791     // regex isn't empty, isn't "$", and doesn't start with a
 792     // repetition.  We match the first atom of regex with the first
 793     // character of str and recurse.
 794     return (*str != '\0') && AtomMatchesChar(escaped, *regex, *str) &&
 795         MatchRegexAtHead(regex + 1, str + 1);
 796   }
 797 }
 798
 799 // Returns true iff regex matches any substring of str.  regex must be
 800 // a valid simple regular expression, or the result is undefined.
 801 //
 802 // The algorithm is recursive, but the recursion depth doesn't exceed
 803 // the regex length, so we won't need to worry about running out of
 804 // stack space normally.  In rare cases the time complexity can be
 805 // exponential with respect to the regex length + the string length,
 806 // but usually it's must faster (often close to linear).
 807 bool MatchRegexAnywhere(const char* regex, const char* str) {
 808   if (regex == NULL || str == NULL)
 809     return false;
 810
 811   if (*regex == '^')
 812     return MatchRegexAtHead(regex + 1, str);
 813
 814   // A successful match can be anywhere in str.
 815   do {
 816     if (MatchRegexAtHead(regex, str))
 817       return true;
 818   } while (*str++ != '\0');
 819   return false;
 820 }
 821
 822 // Implements the RE class.
 823
 824 RE::~RE() {
 825   free(const_cast<char*>(pattern_));
 826   free(const_cast<char*>(full_pattern_));
 827 }
 828
 829 // Returns true iff regular expression re matches the entire str.
 830 bool RE::FullMatch(const char* str, const RE& re) {
 831   return re.is_valid_ && MatchRegexAnywhere(re.full_pattern_, str);
 832 }
 833
 834 // Returns true iff regular expression re matches a substring of str
 835 // (including str itself).
 836 bool RE::PartialMatch(const char* str, const RE& re) {
 837   return re.is_valid_ && MatchRegexAnywhere(re.pattern_, str);
 838 }
 839
 840 // Initializes an RE from its string representation.
 841 void RE::Init(const char* regex) {
 842   pattern_ = full_pattern_ = NULL;
 843   if (regex != NULL) {
 844     pattern_ = posix::StrDup(regex);
 845   }
 846
 847   is_valid_ = ValidateRegex(regex);
 848   if (!is_valid_) {
 849     // No need to calculate the full pattern when the regex is invalid.
 850     return;
 851   }
 852
 853   const size_t len = strlen(regex);
 854   // Reserves enough bytes to hold the regular expression used for a
 855   // full match: we need space to prepend a '^', append a '$', and
 856   // terminate the string with '\0'.
 857   char* buffer = static_cast<char*>(malloc(len + 3));
 858   full_pattern_ = buffer;
 859
 860   if (*regex != '^')
 861     *buffer++ = '^';  // Makes sure full_pattern_ starts with '^'.
 862
 863   // We don't use snprintf or strncpy, as they trigger a warning when
 864   // compiled with VC++ 8.0.
 865   memcpy(buffer, regex, len);
 866   buffer += len;
 867
 868   if (len == 0 || regex[len - 1] != '$')
 869     *buffer++ = '$';  // Makes sure full_pattern_ ends with '$'.
 870
 871   *buffer = '\0';
 872 }
 873
 874 #endif  // GTEST_USES_POSIX_RE
 875
 876 const char kUnknownFile[] = "unknown file";
 877
 878 // Formats a source file path and a line number as they would appear
 879 // in an error message from the compiler used to compile this code.
 880 GTEST_API_ ::std::string FormatFileLocation(const char* file, int line) {
 881   const std::string file_name(file == NULL ? kUnknownFile : file);
 882
 883   if (line < 0) {
 884     return file_name + ":";
 885   }
 886 #ifdef _MSC_VER
 887   return file_name + "(" + StreamableToString(line) + "):";
 888 #else
 889   return file_name + ":" + StreamableToString(line) + ":";
 890 #endif  // _MSC_VER
 891 }
 892
 893 // Formats a file location for compiler-independent XML output.
 894 // Although this function is not platform dependent, we put it next to
 895 // FormatFileLocation in order to contrast the two functions.
 896 // Note that FormatCompilerIndependentFileLocation() does NOT append colon
 897 // to the file location it produces, unlike FormatFileLocation().
 898 GTEST_API_ ::std::string FormatCompilerIndependentFileLocation(
 899     const char* file, int line) {
 900   const std::string file_name(file == NULL ? kUnknownFile : file);
 901
 902   if (line < 0)
 903     return file_name;
 904   else
 905     return file_name + ":" + StreamableToString(line);
 906 }
 907
 908 GTestLog::GTestLog(GTestLogSeverity severity, const char* file, int line)
 909     : severity_(severity) {
 910   const char* const marker =
 911       severity == GTEST_INFO ?    "[  INFO ]" :
 912       severity == GTEST_WARNING ? "[WARNING]" :
 913       severity == GTEST_ERROR ?   "[ ERROR ]" : "[ FATAL ]";
 914   GetStream() << ::std::endl << marker << " "
 915               << FormatFileLocation(file, line).c_str() << ": ";
 916 }
 917
 918 // Flushes the buffers and, if severity is GTEST_FATAL, aborts the program.
 919 GTestLog::~GTestLog() {
 920   GetStream() << ::std::endl;
 921   if (severity_ == GTEST_FATAL) {
 922     fflush(stderr);
 923     posix::Abort();
 924   }
 925 }
 926 // Disable Microsoft deprecation warnings for POSIX functions called from
 927 // this class (creat, dup, dup2, and close)
 928 GTEST_DISABLE_MSC_WARNINGS_PUSH_(4996)
 929
 930 #if GTEST_HAS_STREAM_REDIRECTION
 931
 932 // Object that captures an output stream (stdout/stderr).
 933 class CapturedStream {
 934  public:
 935   // The ctor redirects the stream to a temporary file.
 936   explicit CapturedStream(int fd) : fd_(fd), uncaptured_fd_(dup(fd)) {
 937 # if GTEST_OS_WINDOWS
 938     char temp_dir_path[MAX_PATH + 1] = { '\0' };  // NOLINT
 939     char temp_file_path[MAX_PATH + 1] = { '\0' };  // NOLINT
 940
 941     ::GetTempPathA(sizeof(temp_dir_path), temp_dir_path);
 942     const UINT success = ::GetTempFileNameA(temp_dir_path,
 943                                             "gtest_redir",
 944                                             0,  // Generate unique file name.
 945                                             temp_file_path);
 946     GTEST_CHECK_(success != 0)
 947         << "Unable to create a temporary file in " << temp_dir_path;
 948     const int captured_fd = creat(temp_file_path, _S_IREAD | _S_IWRITE);
 949     GTEST_CHECK_(captured_fd != -1) << "Unable to open temporary file "
 950                                     << temp_file_path;
 951     filename_ = temp_file_path;
 952 # else
 953     // There's no guarantee that a test has write access to the current
 954     // directory, so we create the temporary file in the /tmp directory
 955     // instead. We use /tmp on most systems, and /sdcard on Android.
 956     // That's because Android doesn't have /tmp.
 957 #  if GTEST_OS_LINUX_ANDROID
 958     // Note: Android applications are expected to call the framework's
 959     // Context.getExternalStorageDirectory() method through JNI to get
 960     // the location of the world-writable SD Card directory. However,
 961     // this requires a Context handle, which cannot be retrieved
 962     // globally from native code. Doing so also precludes running the
 963     // code as part of a regular standalone executable, which doesn't
 964     // run in a Dalvik process (e.g. when running it through 'adb shell').
 965     //
 966     // The location /sdcard is directly accessible from native code
 967     // and is the only location (unofficially) supported by the Android
 968     // team. It's generally a symlink to the real SD Card mount point
 969     // which can be /mnt/sdcard, /mnt/sdcard0, /system/media/sdcard, or
 970     // other OEM-customized locations. Never rely on these, and always
 971     // use /sdcard.
 972     char name_template[] = "/sdcard/gtest_captured_stream.XXXXXX";
 973 #  else
 974     char name_template[] = "/tmp/captured_stream.XXXXXX";
 975 #  endif  // GTEST_OS_LINUX_ANDROID
 976     const int captured_fd = mkstemp(name_template);
 977     filename_ = name_template;
 978 # endif  // GTEST_OS_WINDOWS
 979     fflush(NULL);
 980     dup2(captured_fd, fd_);
 981     close(captured_fd);
 982   }
 983
 984   ~CapturedStream() {
 985     remove(filename_.c_str());
 986   }
 987
 988   std::string GetCapturedString() {
 989     if (uncaptured_fd_ != -1) {
 990       // Restores the original stream.
 991       fflush(NULL);
 992       dup2(uncaptured_fd_, fd_);
 993       close(uncaptured_fd_);
 994       uncaptured_fd_ = -1;
 995     }
 996
 997     FILE* const file = posix::FOpen(filename_.c_str(), "r");
 998     const std::string content = ReadEntireFile(file);
 999     posix::FClose(file);
1000     return content;
1001   }
1002
1003  private:
1004   const int fd_;  // A stream to capture.
1005   int uncaptured_fd_;
1006   // Name of the temporary file holding the stderr output.
1007   ::std::string filename_;
1008
1009   GTEST_DISALLOW_COPY_AND_ASSIGN_(CapturedStream);
1010 };
1011
1012 GTEST_DISABLE_MSC_WARNINGS_POP_()
1013
1014 static CapturedStream* g_captured_stderr = NULL;
1015 static CapturedStream* g_captured_stdout = NULL;
1016
1017 // Starts capturing an output stream (stdout/stderr).
1018 void CaptureStream(int fd, const char* stream_name, CapturedStream** stream) {
1019   if (*stream != NULL) {
1020     GTEST_LOG_(FATAL) << "Only one " << stream_name
1021                       << " capturer can exist at a time.";
1022   }
1023   *stream = new CapturedStream(fd);
1024 }
1025
1026 // Stops capturing the output stream and returns the captured string.
1027 std::string GetCapturedStream(CapturedStream** captured_stream) {
1028   const std::string content = (*captured_stream)->GetCapturedString();
1029
1030   delete *captured_stream;
1031   *captured_stream = NULL;
1032
1033   return content;
1034 }
1035
1036 // Starts capturing stdout.
1037 void CaptureStdout() {
1038   CaptureStream(kStdOutFileno, "stdout", &g_captured_stdout);
1039 }
1040
1041 // Starts capturing stderr.
1042 void CaptureStderr() {
1043   CaptureStream(kStdErrFileno, "stderr", &g_captured_stderr);
1044 }
1045
1046 // Stops capturing stdout and returns the captured string.
1047 std::string GetCapturedStdout() {
1048   return GetCapturedStream(&g_captured_stdout);
1049 }
1050
1051 // Stops capturing stderr and returns the captured string.
1052 std::string GetCapturedStderr() {
1053   return GetCapturedStream(&g_captured_stderr);
1054 }
1055
1056 #endif  // GTEST_HAS_STREAM_REDIRECTION
1057
1058 std::string TempDir() {
1059 #if GTEST_OS_WINDOWS_MOBILE
1060   return "\\temp\\";
1061 #elif GTEST_OS_WINDOWS
1062   const char* temp_dir = posix::GetEnv("TEMP");
1063   if (temp_dir == NULL || temp_dir[0] == '\0')
1064     return "\\temp\\";
1065   else if (temp_dir[strlen(temp_dir) - 1] == '\\')
1066     return temp_dir;
1067   else
1068     return std::string(temp_dir) + "\\";
1069 #elif GTEST_OS_LINUX_ANDROID
1070   return "/sdcard/";
1071 #else
1072   return "/tmp/";
1073 #endif  // GTEST_OS_WINDOWS_MOBILE
1074 }
1075
1076 size_t GetFileSize(FILE* file) {
1077   fseek(file, 0, SEEK_END);
1078   return static_cast<size_t>(ftell(file));
1079 }
1080
1081 std::string ReadEntireFile(FILE* file) {
1082   const size_t file_size = GetFileSize(file);
1083   char* const buffer = new char[file_size];
1084
1085   size_t bytes_last_read = 0;  // # of bytes read in the last fread()
1086   size_t bytes_read = 0;       // # of bytes read so far
1087
1088   fseek(file, 0, SEEK_SET);
1089
1090   // Keeps reading the file until we cannot read further or the
1091   // pre-determined file size is reached.
1092   do {
1093     bytes_last_read = fread(buffer+bytes_read, 1, file_size-bytes_read, file);
1094     bytes_read += bytes_last_read;
1095   } while (bytes_last_read > 0 && bytes_read < file_size);
1096
1097   const std::string content(buffer, bytes_read);
1098   delete[] buffer;
1099
1100   return content;
1101 }
1102
1103 #if GTEST_HAS_DEATH_TEST
1104
1105 static const ::std::vector<testing::internal::string>* g_injected_test_argvs =
1106                                         NULL;  // Owned.
1107
1108 void SetInjectableArgvs(const ::std::vector<testing::internal::string>* argvs) {
1109   if (g_injected_test_argvs != argvs)
1110     delete g_injected_test_argvs;
1111   g_injected_test_argvs = argvs;
1112 }
1113
1114 const ::std::vector<testing::internal::string>& GetInjectableArgvs() {
1115   if (g_injected_test_argvs != NULL) {
1116     return *g_injected_test_argvs;
1117   }
1118   return GetArgvs();
1119 }
1120 #endif  // GTEST_HAS_DEATH_TEST
1121
1122 #if GTEST_OS_WINDOWS_MOBILE
1123 namespace posix {
1124 void Abort() {
1125   DebugBreak();
1126   TerminateProcess(GetCurrentProcess(), 1);
1127 }
1128 }  // namespace posix
1129 #endif  // GTEST_OS_WINDOWS_MOBILE
1130
1131 // Returns the name of the environment variable corresponding to the
1132 // given flag.  For example, FlagToEnvVar("foo") will return
1133 // "GTEST_FOO" in the open-source version.
1134 static std::string FlagToEnvVar(const char* flag) {
1135   const std::string full_flag =
1136       (Message() << GTEST_FLAG_PREFIX_ << flag).GetString();
1137
1138   Message env_var;
1139   for (size_t i = 0; i != full_flag.length(); i++) {
1140     env_var << ToUpper(full_flag.c_str()[i]);
1141   }
1142
1143   return env_var.GetString();
1144 }
1145
1146 // Parses 'str' for a 32-bit signed integer.  If successful, writes
1147 // the result to *value and returns true; otherwise leaves *value
1148 // unchanged and returns false.
1149 bool ParseInt32(const Message& src_text, const char* str, Int32* value) {
1150   // Parses the environment variable as a decimal integer.
1151   char* end = NULL;
1152   const long long_value = strtol(str, &end, 10);  // NOLINT
1153
1154   // Has strtol() consumed all characters in the string?
1155   if (*end != '\0') {
1156     // No - an invalid character was encountered.
1157     Message msg;
1158     msg << "WARNING: " << src_text
1159         << " is expected to be a 32-bit integer, but actually"
1160         << " has value \"" << str << "\".\n";
1161     printf("%s", msg.GetString().c_str());
1162     fflush(stdout);
1163     return false;
1164   }
1165
1166   // Is the parsed value in the range of an Int32?
1167   const Int32 result = static_cast<Int32>(long_value);
1168   if (long_value == LONG_MAX || long_value == LONG_MIN ||
1169       // The parsed value overflows as a long.  (strtol() returns
1170       // LONG_MAX or LONG_MIN when the input overflows.)
1171       result != long_value
1172       // The parsed value overflows as an Int32.
1173       ) {
1174     Message msg;
1175     msg << "WARNING: " << src_text
1176         << " is expected to be a 32-bit integer, but actually"
1177         << " has value " << str << ", which overflows.\n";
1178     printf("%s", msg.GetString().c_str());
1179     fflush(stdout);
1180     return false;
1181   }
1182
1183   *value = result;
1184   return true;
1185 }
1186
1187 // Reads and returns the Boolean environment variable corresponding to
1188 // the given flag; if it's not set, returns default_value.
1189 //
1190 // The value is considered true iff it's not "0".
1191 bool BoolFromGTestEnv(const char* flag, bool default_value) {
1192 #if defined(GTEST_GET_BOOL_FROM_ENV_)
1193   return GTEST_GET_BOOL_FROM_ENV_(flag, default_value);
1194 #endif  // defined(GTEST_GET_BOOL_FROM_ENV_)
1195   const std::string env_var = FlagToEnvVar(flag);
1196   const char* const string_value = posix::GetEnv(env_var.c_str());
1197   return string_value == NULL ?
1198       default_value : strcmp(string_value, "0") != 0;
1199 }
1200
1201 // Reads and returns a 32-bit integer stored in the environment
1202 // variable corresponding to the given flag; if it isn't set or
1203 // doesn't represent a valid 32-bit integer, returns default_value.
1204 Int32 Int32FromGTestEnv(const char* flag, Int32 default_value) {
1205 #if defined(GTEST_GET_INT32_FROM_ENV_)
1206   return GTEST_GET_INT32_FROM_ENV_(flag, default_value);
1207 #endif  // defined(GTEST_GET_INT32_FROM_ENV_)
1208   const std::string env_var = FlagToEnvVar(flag);
1209   const char* const string_value = posix::GetEnv(env_var.c_str());
1210   if (string_value == NULL) {
1211     // The environment variable is not set.
1212     return default_value;
1213   }
1214
1215   Int32 result = default_value;
1216   if (!ParseInt32(Message() << "Environment variable " << env_var,
1217                   string_value, &result)) {
1218     printf("The default value %s is used.\n",
1219            (Message() << default_value).GetString().c_str());
1220     fflush(stdout);
1221     return default_value;
1222   }
1223
1224   return result;
1225 }
1226
1227 // Reads and returns the string environment variable corresponding to
1228 // the given flag; if it's not set, returns default_value.
1229 std::string StringFromGTestEnv(const char* flag, const char* default_value) {
1230 #if defined(GTEST_GET_STRING_FROM_ENV_)
1231   return GTEST_GET_STRING_FROM_ENV_(flag, default_value);
1232 #endif  // defined(GTEST_GET_STRING_FROM_ENV_)
1233   const std::string env_var = FlagToEnvVar(flag);
1234   const char* value = posix::GetEnv(env_var.c_str());
1235   if (value != NULL) {
1236     return value;
1237   }
1238
1239   // As a special case for the 'output' flag, if GTEST_OUTPUT is not
1240   // set, we look for XML_OUTPUT_FILE, which is set by the Bazel build
1241   // system.  The value of XML_OUTPUT_FILE is a filename without the
1242   // "xml:" prefix of GTEST_OUTPUT.
1243   //
1244   // The net priority order after flag processing is thus:
1245   //   --gtest_output command line flag
1246   //   GTEST_OUTPUT environment variable
1247   //   XML_OUTPUT_FILE environment variable
1248   //   'default_value'
1249   if (strcmp(flag, "output") == 0) {
1250     value = posix::GetEnv("XML_OUTPUT_FILE");
1251     if (value != NULL) {
1252       return std::string("xml:") + value;
1253     }
1254   }
1255   return default_value;
1256 }
1257
1258 }  // namespace internal
1259 }  // namespace testing