| 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, |
| (...skipping 17 matching lines...) Expand all Loading... |
| 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 `#%ifdef`s. |
| 39 //! | 39 //! |
| 40 //! This implementation concentrates the ugly #ifdefs in one location. | 40 //! This implementation concentrates the ugly `#%ifdef`s in one location. |
| 41 //! | 41 //! |
| 42 //! Usage: | 42 //! Usage: |
| 43 //! | 43 //! |
| 44 //! \code | 44 //! \code |
| 45 //! class Class { | 45 //! class Class { |
| 46 //! public: | 46 //! public: |
| 47 //! Class() : initialized_() {} | 47 //! Class() : initialized_() {} |
| 48 //! | 48 //! |
| 49 //! void Initialize() { | 49 //! void Initialize() { |
| 50 //! INITIALIZATION_STATE_SET_INITIALIZING(initialized_); | 50 //! INITIALIZATION_STATE_SET_INITIALIZING(initialized_); |
| (...skipping 128 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 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 |