| 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 |