bsls_review_macroreset.h

Go to the documentation of this file.

/// @file bsls_review_macroreset.h
///
/// The content of this file has been pre-processed for Doxygen.
///
 
 
// bsls_review_macroreset.h                                           -*-C++-*-
#ifndef INCLUDED_BSLS_REVIEW_MACRORESET
#define INCLUDED_BSLS_REVIEW_MACRORESET
 
#include <bsls_ident.h>
BSLS_IDENT("$Id: $")
 
/// @defgroup bsls_review_macroreset bsls_review_macroreset
/// @brief  Test driver utility to undefine all macros from `bsls_review.h`.
/// @addtogroup bsl
/// @{
/// @addtogroup bsls
/// @{
/// @addtogroup bsls_review_macroreset
/// @{
///
/// <h1> Outline </h1>
/// * <a href="#bsls_review_macroreset-purpose"> Purpose</a>
/// * <a href="#bsls_review_macroreset-description"> Description </a>
///   * <a href="#bsls_review_macroreset-usage"> Usage </a>
///
/// # Purpose {#bsls_review_macroreset-purpose}
/// Test driver utility to undefine all macros from `bsls_review.h`.
///
/// # Description {#bsls_review_macroreset-description}
/// This component provides a header that is *included* to undefine
/// all macros defined in `bsls_review.h`; it is designed to be re-includable.
/// This is for the use of the @ref bsls_review  test driver to enable it to
/// re-include the `bsls_review.h` header with different input macros and verify
/// that they output the correct resulting macro definitions.
///
/// ## Usage {#bsls_review_macroreset-usage}
///
///
/// To undefine all macros defined in `bsls_review.h`, first disable the header
/// include guard for this header (`bsls_review_macroreset.h`):
/// @code
/// #undef INCLUDED_BSLS_REVIEW_MACRORESET
/// @endcode
/// Then re-include this header, which will undefine the macros that were
/// defined by `bsls_review.h`:
/// @code
/// #include <bsls_review_macroreset.h>
/// @endcode
/// Then define any macros that control the behavior of `bsls_review.h` for this
/// particular test, then re-include `bsls_review.h`:
/// @code
/// #include <bsls_review.h>
/// @endcode
/// @}
/** @} */
/** @} */
 
/** @addtogroup bsl
 * @{
 */
/** @addtogroup bsls
 * @{
 */
/** @addtogroup bsls_review_macroreset
 * @{
 */
 
// Undefine the external header guard so that the component header can be
// re-included and re-evaluated.
#undef INCLUDED_BSLS_REVIEW
 
// Undefine the build mode so it can be set to whatever the test wants to
// verify next.
#undef BDE_BUILD_TARGET_DBG
#undef BDE_BUILD_TARGET_OPT
#undef BDE_BUILD_TARGET_SAFE
#undef BDE_BUILD_TARGET_SAFE_2
 
// Undefine the explicit review level and assert level macros.
#undef BSLS_REVIEW_LEVEL_NONE
#undef BSLS_REVIEW_LEVEL_REVIEW
#undef BSLS_REVIEW_LEVEL_REVIEW_OPT
#undef BSLS_REVIEW_LEVEL_REVIEW_SAFE
 
#undef BSLS_ASSERT_LEVEL_ASSERT
#undef BSLS_ASSERT_LEVEL_ASSERT_OPT
#undef BSLS_ASSERT_LEVEL_ASSERT_SAFE
#undef BSLS_ASSERT_LEVEL_ASSUME_ASSERT
#undef BSLS_ASSERT_LEVEL_ASSUME_OPT
#undef BSLS_ASSERT_LEVEL_ASSUME_SAFE
#undef BSLS_ASSERT_LEVEL_NONE
 
// Undefine other control macros
#undef BSLS_REVIEW_VALIDATE_DISABLED_MACROS
 
// Undefine the macros actually defined by 'bsls_review.h'.
#undef BSLS_REVIEW
#undef BSLS_REVIEW_REVIEW_IMP
#undef BSLS_REVIEW_REVIEW_COUNT_IMP
#undef BSLS_REVIEW_DISABLED_IMP
#undef BSLS_REVIEW_INVOKE
#undef BSLS_REVIEW_IS_ACTIVE
#undef BSLS_REVIEW_IS_USED
#undef BSLS_REVIEW_OPT
#undef BSLS_REVIEW_OPT_IS_ACTIVE
#undef BSLS_REVIEW_OPT_IS_USED
#undef BSLS_REVIEW_SAFE
#undef BSLS_REVIEW_SAFE_IS_ACTIVE
#undef BSLS_REVIEW_SAFE_IS_USED
 
#endif
 
// ----------------------------------------------------------------------------
// Copyright 2018 Bloomberg Finance L.P.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// ----------------------------- END-OF-FILE ----------------------------------
 
/** @} */
/** @} */
/** @} */