OLD | NEW |
1 /* | 1 /* |
2 * Copyright 2006 The WebRTC Project Authors. All rights reserved. | 2 * Copyright 2006 The WebRTC Project Authors. All rights reserved. |
3 * | 3 * |
4 * Use of this source code is governed by a BSD-style license | 4 * Use of this source code is governed by a BSD-style license |
5 * that can be found in the LICENSE file in the root of the source | 5 * that can be found in the LICENSE file in the root of the source |
6 * tree. An additional intellectual property rights grant can be found | 6 * tree. An additional intellectual property rights grant can be found |
7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
9 */ | 9 */ |
10 | 10 |
11 #ifndef WEBRTC_BASE_CHECKS_H_ | 11 #ifndef WEBRTC_BASE_CHECKS_H_ |
12 #define WEBRTC_BASE_CHECKS_H_ | 12 #define WEBRTC_BASE_CHECKS_H_ |
13 | 13 |
14 #include <sstream> | 14 #include <sstream> |
15 #include <string> | 15 #include <string> |
16 | 16 |
17 #ifdef WEBRTC_CHROMIUM_BUILD | |
18 // Include logging.h in a Chromium build to enable the overrides mechanism for | |
19 // using Chromium's macros. Otherwise, don't depend on logging.h. | |
20 // TODO(ajm): Ideally, checks.h would be combined with logging.h, but | |
21 // consolidation with system_wrappers/logging.h should happen first. | |
22 #include "webrtc/base/logging.h" | |
23 #endif | |
24 #include "webrtc/typedefs.h" | 17 #include "webrtc/typedefs.h" |
25 | 18 |
26 // The macros here print a message to stderr and abort under various | 19 // The macros here print a message to stderr and abort under various |
27 // conditions. All will accept additional stream messages. For example: | 20 // conditions. All will accept additional stream messages. For example: |
28 // RTC_DCHECK_EQ(foo, bar) << "I'm printed when foo != bar."; | 21 // RTC_DCHECK_EQ(foo, bar) << "I'm printed when foo != bar."; |
29 // | 22 // |
30 // - RTC_CHECK(x) is an assertion that x is always true, and that if it isn't, | 23 // - RTC_CHECK(x) is an assertion that x is always true, and that if it isn't, |
31 // it's better to terminate the process than to continue. During development, | 24 // it's better to terminate the process than to continue. During development, |
32 // the reason that it's better to terminate might simply be that the error | 25 // the reason that it's better to terminate might simply be that the error |
33 // handling code isn't in place yet; in production, the reason might be that | 26 // handling code isn't in place yet; in production, the reason might be that |
(...skipping 18 matching lines...) Expand all Loading... |
52 // RTC_DCHECK only evaluates its argument in debug builds, so if x has visible | 45 // RTC_DCHECK only evaluates its argument in debug builds, so if x has visible |
53 // side effects, you need to write e.g. | 46 // side effects, you need to write e.g. |
54 // bool w = x; RTC_DCHECK(w); | 47 // bool w = x; RTC_DCHECK(w); |
55 // | 48 // |
56 // - RTC_CHECK_EQ, _NE, _GT, ..., and RTC_DCHECK_EQ, _NE, _GT, ... are | 49 // - RTC_CHECK_EQ, _NE, _GT, ..., and RTC_DCHECK_EQ, _NE, _GT, ... are |
57 // specialized variants of RTC_CHECK and RTC_DCHECK that print prettier | 50 // specialized variants of RTC_CHECK and RTC_DCHECK that print prettier |
58 // messages if the condition doesn't hold. Prefer them to raw RTC_CHECK and | 51 // messages if the condition doesn't hold. Prefer them to raw RTC_CHECK and |
59 // RTC_DCHECK. | 52 // RTC_DCHECK. |
60 // | 53 // |
61 // - FATAL() aborts unconditionally. | 54 // - FATAL() aborts unconditionally. |
| 55 // |
| 56 // TODO(ajm): Ideally, checks.h would be combined with logging.h, but |
| 57 // consolidation with system_wrappers/logging.h should happen first. |
62 | 58 |
63 namespace rtc { | 59 namespace rtc { |
64 | 60 |
65 // Helper macro which avoids evaluating the arguments to a stream if | 61 // Helper macro which avoids evaluating the arguments to a stream if |
66 // the condition doesn't hold. | 62 // the condition doesn't hold. |
67 #define RTC_LAZY_STREAM(stream, condition) \ | 63 #define RTC_LAZY_STREAM(stream, condition) \ |
68 !(condition) ? static_cast<void>(0) : rtc::FatalMessageVoidify() & (stream) | 64 !(condition) ? static_cast<void>(0) : rtc::FatalMessageVoidify() & (stream) |
69 | 65 |
70 // The actual stream used isn't important. We reference condition in the code | 66 // The actual stream used isn't important. We reference condition in the code |
71 // but don't evaluate it; this is to avoid "unused variable" warnings (we do so | 67 // but don't evaluate it; this is to avoid "unused variable" warnings (we do so |
(...skipping 150 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
222 // remainder is zero. | 218 // remainder is zero. |
223 template <typename T> | 219 template <typename T> |
224 inline T CheckedDivExact(T a, T b) { | 220 inline T CheckedDivExact(T a, T b) { |
225 RTC_CHECK_EQ(a % b, static_cast<T>(0)); | 221 RTC_CHECK_EQ(a % b, static_cast<T>(0)); |
226 return a / b; | 222 return a / b; |
227 } | 223 } |
228 | 224 |
229 } // namespace rtc | 225 } // namespace rtc |
230 | 226 |
231 #endif // WEBRTC_BASE_CHECKS_H_ | 227 #endif // WEBRTC_BASE_CHECKS_H_ |
OLD | NEW |