tool/mbed/mbed-sdk/libraries/mbed/api/mbed_assert.h

   1 /* mbed Microcontroller Library
   2  * Copyright (c) 2006-2013 ARM Limited
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *     http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16 #ifndef MBED_ASSERT_H
  17 #define MBED_ASSERT_H
  18
  19 #ifdef __cplusplus
  20 extern "C" {
  21 #endif
  22
  23 /** Internal mbed assert function which is invoked when MBED_ASSERT macro failes.
  24  *  This function is active only if NDEBUG is not defined prior to including this
  25  *  assert header file.
  26  *  In case of MBED_ASSERT failing condition, the assertation message is printed
  27  *  to stderr and mbed_die() is called.
  28  *  @param expr Expresion to be checked.
  29  *  @param file File where assertation failed.
  30  *  @param line Failing assertation line number.
  31  */
  32 void mbed_assert_internal(const char *expr, const char *file, int line);
  33
  34 #ifdef __cplusplus
  35 }
  36 #endif
  37
  38 #ifdef NDEBUG
  39 #define MBED_ASSERT(expr) ((void)0)
  40
  41 #else
  42 #define MBED_ASSERT(expr)                                \
  43 do {                                                     \
  44     if (!(expr)) {                                       \
  45         mbed_assert_internal(#expr, __FILE__, __LINE__); \
  46     }                                                    \
  47 } while (0)
  48 #endif
  49
  50 #endif