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 |