OLD | NEW |
1 // Copyright 2014 The Crashpad Authors. All rights reserved. | 1 // Copyright 2014 The Crashpad Authors. All rights reserved. |
2 // | 2 // |
3 // Licensed under the Apache License, Version 2.0 (the "License"); | 3 // Licensed under the Apache License, Version 2.0 (the "License"); |
4 // you may not use this file except in compliance with the License. | 4 // you may not use this file except in compliance with the License. |
5 // You may obtain a copy of the License at | 5 // You may obtain a copy of the License at |
6 // | 6 // |
7 // http://www.apache.org/licenses/LICENSE-2.0 | 7 // http://www.apache.org/licenses/LICENSE-2.0 |
8 // | 8 // |
9 // Unless required by applicable law or agreed to in writing, software | 9 // Unless required by applicable law or agreed to in writing, software |
10 // distributed under the License is distributed on an "AS IS" BASIS, | 10 // distributed under the License is distributed on an "AS IS" BASIS, |
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | 11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
12 // See the License for the specific language governing permissions and | 12 // See the License for the specific language governing permissions and |
13 // limitations under the License. | 13 // limitations under the License. |
14 | 14 |
15 #ifndef CRASHPAD_UTIL_MISC_INITIALIZATION_INITIALIZATION_STATE_DCHECK_H_ | 15 #ifndef CRASHPAD_UTIL_MISC_INITIALIZATION_INITIALIZATION_STATE_DCHECK_H_ |
16 #define CRASHPAD_UTIL_MISC_INITIALIZATION_INITIALIZATION_STATE_DCHECK_H_ | 16 #define CRASHPAD_UTIL_MISC_INITIALIZATION_INITIALIZATION_STATE_DCHECK_H_ |
17 | 17 |
18 //! \file | 18 //! \file |
19 | 19 |
20 #include "base/basictypes.h" | 20 #include "base/basictypes.h" |
21 #include "base/compiler_specific.h" | 21 #include "base/compiler_specific.h" |
22 #include "base/logging.h" | 22 #include "base/logging.h" |
23 #include "build/build_config.h" | 23 #include "build/build_config.h" |
24 #include "util/misc/initialization_state.h" | 24 #include "util/misc/initialization_state.h" |
25 | 25 |
26 namespace crashpad { | 26 namespace crashpad { |
27 | 27 |
28 #if DCHECK_IS_ON || DOXYGEN | 28 #if DCHECK_IS_ON() || DOXYGEN |
29 | 29 |
30 //! \brief Tracks whether data are initialized, triggering a DCHECK assertion | 30 //! \brief Tracks whether data are initialized, triggering a DCHECK assertion |
31 //! on an invalid data access. | 31 //! on an invalid data access. |
32 //! | 32 //! |
33 //! Put an InitializationStateDcheck member into a class to help DCHECK that | 33 //! Put an InitializationStateDcheck member into a class to help DCHECK that |
34 //! it’s in the right states at the right times. This is useful for classes with | 34 //! it’s in the right states at the right times. This is useful for classes with |
35 //! Initialize() methods. The chief advantage of InitializationStateDcheck over | 35 //! Initialize() methods. The chief advantage of InitializationStateDcheck over |
36 //! having a member variable to track state is that when the only use of the | 36 //! having a member variable to track state is that when the only use of the |
37 //! variable is to DCHECK, it wastes space (in memory and executable code) in | 37 //! variable is to DCHECK, it wastes space (in memory and executable code) in |
38 //! non-DCHECK builds unless the code is also peppered with ugly #ifdefs. | 38 //! non-DCHECK builds unless the code is also peppered with ugly #ifdefs. |
(...skipping 122 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
161 struct InitializationStateDcheck { | 161 struct InitializationStateDcheck { |
162 }; | 162 }; |
163 #else | 163 #else |
164 // Since this is to be used as a DCHECK (for debugging), it should be | 164 // Since this is to be used as a DCHECK (for debugging), it should be |
165 // non-intrusive in non-DCHECK (non-debug, release) builds. An empty struct | 165 // non-intrusive in non-DCHECK (non-debug, release) builds. An empty struct |
166 // would still have a nonzero size (rationale: | 166 // would still have a nonzero size (rationale: |
167 // http://www.stroustrup.com/bs_faq2.html#sizeof-empty). Zero-length arrays are | 167 // http://www.stroustrup.com/bs_faq2.html#sizeof-empty). Zero-length arrays are |
168 // technically invalid according to the standard, but clang and g++ accept them | 168 // technically invalid according to the standard, but clang and g++ accept them |
169 // without complaint even with warnings turned up. They take up no space at all, | 169 // without complaint even with warnings turned up. They take up no space at all, |
170 // and they can be “initialized” with the same () syntax used to initialize | 170 // and they can be “initialized” with the same () syntax used to initialize |
171 // objects of the DCHECK_IS_ON InitializationStateDcheck class above. | 171 // objects of the DCHECK_IS_ON() InitializationStateDcheck class above. |
172 using InitializationStateDcheck = bool[0]; | 172 using InitializationStateDcheck = bool[0]; |
173 #endif // COMPILER_MSVC | 173 #endif // COMPILER_MSVC |
174 | 174 |
175 // Avoid triggering warnings by repurposing these macros when DCHECKs are | 175 // Avoid triggering warnings by repurposing these macros when DCHECKs are |
176 // disabled. | 176 // disabled. |
177 #define INITIALIZATION_STATE_SET_INITIALIZING(initialization_state_dcheck) \ | 177 #define INITIALIZATION_STATE_SET_INITIALIZING(initialization_state_dcheck) \ |
178 ALLOW_UNUSED_LOCAL(initialization_state_dcheck) | 178 ALLOW_UNUSED_LOCAL(initialization_state_dcheck) |
179 #define INITIALIZATION_STATE_SET_VALID(initialization_state_dcheck) \ | 179 #define INITIALIZATION_STATE_SET_VALID(initialization_state_dcheck) \ |
180 ALLOW_UNUSED_LOCAL(initialization_state_dcheck) | 180 ALLOW_UNUSED_LOCAL(initialization_state_dcheck) |
181 #define INITIALIZATION_STATE_DCHECK_VALID(initialization_state_dcheck) \ | 181 #define INITIALIZATION_STATE_DCHECK_VALID(initialization_state_dcheck) \ |
182 ALLOW_UNUSED_LOCAL(initialization_state_dcheck) | 182 ALLOW_UNUSED_LOCAL(initialization_state_dcheck) |
183 | 183 |
184 #endif | 184 #endif |
185 | 185 |
186 } // namespace crashpad | 186 } // namespace crashpad |
187 | 187 |
188 #endif // CRASHPAD_UTIL_MISC_INITIALIZATION_INITIALIZATION_STATE_DCHECK_H_ | 188 #endif // CRASHPAD_UTIL_MISC_INITIALIZATION_INITIALIZATION_STATE_DCHECK_H_ |
OLD | NEW |