[InstCombine] Signed saturation tests. NFC
[llvm-complete.git] / utils / unittest / googletest / src / gtest-port.cc
blob6aeef4957cf505129a8eba0bddd6aa87cedcfdef
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.
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.
30 // Author: wan@google.com (Zhanyong Wan)
32 #include "gtest/internal/gtest-port.h"
34 #include <limits.h>
35 #include <stdlib.h>
36 #include <stdio.h>
37 #include <string.h>
38 #include <fstream>
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
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
55 #if GTEST_OS_QNX
56 # include <devctl.h>
57 # include <fcntl.h>
58 # include <sys/procfs.h>
59 #endif // GTEST_OS_QNX
61 #if GTEST_OS_AIX
62 # include <procinfo.h>
63 # include <sys/types.h>
64 #endif // GTEST_OS_AIX
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"
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_
80 namespace testing {
81 namespace internal {
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
92 #if GTEST_OS_LINUX
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;
102 T output = 0;
103 file >> output;
104 return output;
106 } // namespace
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);
115 #elif GTEST_OS_MAC
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;
134 #elif GTEST_OS_QNX
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;
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;
154 #elif GTEST_OS_AIX
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;
167 #else
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;
175 #endif // GTEST_OS_LINUX
177 #if GTEST_IS_THREADSAFE && GTEST_OS_WINDOWS
179 void SleepMilliseconds(int n) {
180 ::Sleep(n);
183 AutoHandle::AutoHandle()
184 : handle_(INVALID_HANDLE_VALUE) {}
186 AutoHandle::AutoHandle(Handle handle)
187 : handle_(handle) {}
189 AutoHandle::~AutoHandle() {
190 Reset();
193 AutoHandle::Handle AutoHandle::Get() const {
194 return handle_;
197 void AutoHandle::Reset() {
198 Reset(INVALID_HANDLE_VALUE);
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_);
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.";
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;
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);
229 void Notification::Notify() {
230 GTEST_CHECK_(::SetEvent(event_.Get()) != FALSE);
233 void Notification::WaitForNotification() {
234 GTEST_CHECK_(
235 ::WaitForSingleObject(event_.Get(), INFINITE) == WAIT_OBJECT_0);
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_);
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;
259 void Mutex::Lock() {
260 ThreadSafeLazyInit();
261 ::EnterCriticalSection(critical_section_);
262 owner_thread_id_ = ::GetCurrentThreadId();
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_);
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;
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_,
305 2L) != 2L) {
306 // Possibly yields the rest of the thread's time slice to other
307 // threads.
308 ::Sleep(0);
310 break;
312 case 2:
313 break; // The mutex is already initialized and ready for use.
315 default:
316 GTEST_CHECK_(false)
317 << "Unexpected value of critical_section_init_phase_ "
318 << "while initializing a static mutex.";
323 namespace {
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;
344 return thread_handle;
347 private:
348 struct ThreadMainParam {
349 ThreadMainParam(Runnable* runnable, Notification* thread_can_start)
350 : runnable_(runnable),
351 thread_can_start_(thread_can_start) {
353 scoped_ptr<Runnable> runnable_;
354 // Does not own.
355 Notification* thread_can_start_;
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;
367 // Prohibit instantiation.
368 ThreadWithParamSupport();
370 GTEST_DISALLOW_COPY_AND_ASSIGN_(ThreadWithParamSupport);
373 } // namespace
375 ThreadWithParamBase::ThreadWithParamBase(Runnable *runnable,
376 Notification* thread_can_start)
377 : thread_(ThreadWithParamSupport::CreateThread(runnable,
378 thread_can_start)) {
381 ThreadWithParamBase::~ThreadWithParamBase() {
382 Join();
385 void ThreadWithParamBase::Join() {
386 GTEST_CHECK_(::WaitForSingleObject(thread_.Get(), INFINITE) == WAIT_OBJECT_0)
387 << "Failed to join the thread with error " << ::GetLastError() << ".";
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);
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;
423 return value_pos->second.get();
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.
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.
450 // Outside the lock, let the destructor for 'value_holders' deallocate the
451 // ThreadLocalValueHolderBases.
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.
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);
473 thread_to_thread_locals->erase(thread_local_pos);
476 // Outside the lock, let the destructor for 'value_holders' deallocate the
477 // ThreadLocalValueHolderBases.
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;
488 // Holds the thread id and thread handle that we pass from
489 // StartWatcherThreadFor to WatcherThreadFunc.
490 typedef std::pair<DWORD, HANDLE> ThreadIdAndHandle;
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 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);
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;
531 // Returns map of thread local instances.
532 static ThreadIdToThreadLocals* GetThreadLocalsMapLocked() {
533 mutex_.AssertHeld();
534 static ThreadIdToThreadLocals* map = new ThreadIdToThreadLocals;
535 return map;
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_;
544 Mutex ThreadLocalRegistryImpl::mutex_(Mutex::kStaticMutex);
545 Mutex ThreadLocalRegistryImpl::thread_map_mutex_(Mutex::kStaticMutex);
547 ThreadLocalValueHolderBase* ThreadLocalRegistry::GetValueOnCurrentThread(
548 const ThreadLocalBase* thread_local_instance) {
549 return ThreadLocalRegistryImpl::GetValueOnCurrentThread(
550 thread_local_instance);
553 void ThreadLocalRegistry::OnThreadLocalDestroyed(
554 const ThreadLocalBase* thread_local_instance) {
555 ThreadLocalRegistryImpl::OnThreadLocalDestroyed(thread_local_instance);
558 #endif // GTEST_IS_THREADSAFE && GTEST_OS_WINDOWS
560 #if GTEST_USES_POSIX_RE
562 // Implements RE. Currently only needed for death tests.
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_);
573 free(const_cast<char*>(pattern_));
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;
580 regmatch_t match;
581 return regexec(&re.full_regex_, str, 1, &match, 0) == 0;
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;
589 regmatch_t match;
590 return regexec(&re.partial_regex_, str, 1, &match, 0) == 0;
593 // Initializes an RE from its string representation.
594 void RE::Init(const char* regex) {
595 pattern_ = posix::StrDup(regex);
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];
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.
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;
616 EXPECT_TRUE(is_valid_)
617 << "Regular expression \"" << regex
618 << "\" is not a valid POSIX Extended regular expression.";
620 delete[] full_pattern;
623 #elif GTEST_USES_SIMPLE_RE
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;
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, "^-!\"#$%&'()*+,./:;<=>?@[\\]_`{|}~");
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 == '_';
645 // Returns true iff "\\c" is a supported escape sequence.
646 bool IsValidEscape(char c) {
647 return (IsAsciiPunct(c) || IsInSet(c, "dDfnrsStvwW"));
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);
667 return IsAsciiPunct(pattern_char) && pattern_char == ch;
670 return (pattern_char == '.' && ch != '\n') || pattern_char == ch;
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();
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;
690 bool is_valid = true;
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;
703 if (!IsValidEscape(regex[i])) {
704 ADD_FAILURE() << FormatRegexSyntaxError(regex, i - 1)
705 << "invalid escape sequence \"\\" << regex[i] << "\".";
706 is_valid = false;
708 prev_repeatable = true;
709 } else { // Not an escape sequence.
710 const char ch = regex[i];
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;
730 prev_repeatable = !IsInSet(ch, "^$?*+");
734 return is_valid;
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.
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;
762 if (str[i] == '\0' || !AtomMatchesChar(escaped, c, str[i]))
763 return false;
765 return false;
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;
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';
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);
799 // Returns true iff regex matches any substring of str. regex must be
800 // a valid simple regular expression, or the result is undefined.
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;
811 if (*regex == '^')
812 return MatchRegexAtHead(regex + 1, str);
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;
822 // Implements the RE class.
824 RE::~RE() {
825 free(const_cast<char*>(pattern_));
826 free(const_cast<char*>(full_pattern_));
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);
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);
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);
847 is_valid_ = ValidateRegex(regex);
848 if (!is_valid_) {
849 // No need to calculate the full pattern when the regex is invalid.
850 return;
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;
860 if (*regex != '^')
861 *buffer++ = '^'; // Makes sure full_pattern_ starts with '^'.
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;
868 if (len == 0 || regex[len - 1] != '$')
869 *buffer++ = '$'; // Makes sure full_pattern_ ends with '$'.
871 *buffer = '\0';
874 #endif // GTEST_USES_POSIX_RE
876 const char kUnknownFile[] = "unknown file";
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);
883 if (line < 0) {
884 return file_name + ":";
886 #ifdef _MSC_VER
887 return file_name + "(" + StreamableToString(line) + "):";
888 #else
889 return file_name + ":" + StreamableToString(line) + ":";
890 #endif // _MSC_VER
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);
902 if (line < 0)
903 return file_name;
904 else
905 return file_name + ":" + StreamableToString(line);
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() << ": ";
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();
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)
930 #if GTEST_HAS_STREAM_REDIRECTION
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
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').
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);
984 ~CapturedStream() {
985 remove(filename_.c_str());
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;
997 FILE* const file = posix::FOpen(filename_.c_str(), "r");
998 const std::string content = ReadEntireFile(file);
999 posix::FClose(file);
1000 return content;
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_;
1009 GTEST_DISALLOW_COPY_AND_ASSIGN_(CapturedStream);
1012 GTEST_DISABLE_MSC_WARNINGS_POP_()
1014 static CapturedStream* g_captured_stderr = NULL;
1015 static CapturedStream* g_captured_stdout = NULL;
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.";
1023 *stream = new CapturedStream(fd);
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();
1030 delete *captured_stream;
1031 *captured_stream = NULL;
1033 return content;
1036 // Starts capturing stdout.
1037 void CaptureStdout() {
1038 CaptureStream(kStdOutFileno, "stdout", &g_captured_stdout);
1041 // Starts capturing stderr.
1042 void CaptureStderr() {
1043 CaptureStream(kStdErrFileno, "stderr", &g_captured_stderr);
1046 // Stops capturing stdout and returns the captured string.
1047 std::string GetCapturedStdout() {
1048 return GetCapturedStream(&g_captured_stdout);
1051 // Stops capturing stderr and returns the captured string.
1052 std::string GetCapturedStderr() {
1053 return GetCapturedStream(&g_captured_stderr);
1056 #endif // GTEST_HAS_STREAM_REDIRECTION
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
1076 size_t GetFileSize(FILE* file) {
1077 fseek(file, 0, SEEK_END);
1078 return static_cast<size_t>(ftell(file));
1081 std::string ReadEntireFile(FILE* file) {
1082 const size_t file_size = GetFileSize(file);
1083 char* const buffer = new char[file_size];
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
1088 fseek(file, 0, SEEK_SET);
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);
1097 const std::string content(buffer, bytes_read);
1098 delete[] buffer;
1100 return content;
1103 #if GTEST_HAS_DEATH_TEST
1105 static const ::std::vector<testing::internal::string>* g_injected_test_argvs =
1106 NULL; // Owned.
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;
1114 const ::std::vector<testing::internal::string>& GetInjectableArgvs() {
1115 if (g_injected_test_argvs != NULL) {
1116 return *g_injected_test_argvs;
1118 return GetArgvs();
1120 #endif // GTEST_HAS_DEATH_TEST
1122 #if GTEST_OS_WINDOWS_MOBILE
1123 namespace posix {
1124 void Abort() {
1125 DebugBreak();
1126 TerminateProcess(GetCurrentProcess(), 1);
1128 } // namespace posix
1129 #endif // GTEST_OS_WINDOWS_MOBILE
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();
1138 Message env_var;
1139 for (size_t i = 0; i != full_flag.length(); i++) {
1140 env_var << ToUpper(full_flag.c_str()[i]);
1143 return env_var.GetString();
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
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;
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.
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;
1183 *value = result;
1184 return true;
1187 // Reads and returns the Boolean environment variable corresponding to
1188 // the given flag; if it's not set, returns default_value.
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;
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;
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;
1224 return result;
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;
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.
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;
1255 return default_value;
1258 } // namespace internal
1259 } // namespace testing