os_assert.h — 断言机制头文件

源文件路径: kernel/include/os_assert.h

引用章节: 4.6.1 断言机制

完整源码

/**
 ***********************************************************************************************************************
 * Copyright (c) 2020, China Mobile Communications Group Co.,Ltd.
 *
 * 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.
 *
 * @file        os_assert.h
 *
 * @brief       Support diagnostic functions
 *
 * @revision
 * Date         Author          Notes
 * 2020-02-12   OneOS Team      First version
 ***********************************************************************************************************************
 */

#ifndef __OS_ASSERT_H__
#define __OS_ASSERT_H__

#include <oneos_config.h>
#include <os_util.h>
#include <os_safety.h>

#ifdef __cplusplus
extern "C" {
#endif

#ifdef OS_USING_ASSERT
#define OS_ASSERT(condition)                                                           \
    do                                                                                 \
    {                                                                                  \
        if (!(condition))                                                              \
        {                                                                              \
            os_kprintf("Assert failed. Condition(%s). [%s][%d]\r\n",                   \
                       #condition, __FUNCTION__, __LINE__);                            \
            os_safety_assert_process();                                                \
        }                                                                              \
    } while (0)

#define OS_ASSERT_EX(condition, fmt, ...)                                              \
    do                                                                                 \
    {                                                                                  \
        if (!(condition))                                                              \
        {                                                                              \
            os_kprintf("Assert failed. " fmt " [%s][%d]\r\n",                          \
                       ##__VA_ARGS__, __FUNCTION__, __LINE__);                         \
            os_safety_assert_process();                                                \
        }                                                                              \
    } while (0)

#else
#define OS_ASSERT(condition)
#define OS_ASSERT_EX(condition, fmt, ...)
#endif /* OS_USING_ASSERT */

#ifdef __cplusplus
}
#endif

#endif /* __OS_ASSERT_H__ */

关键说明

宏	功能	行为
OS_ASSERT(cond)	基础断言	条件为假时打印文件/函数/行号，调用 os_safety_assert_process()
OS_ASSERT_EX(cond, fmt, ...)	扩展断言	支持自定义格式化消息，便于调试
未启用 OS_USING_ASSERT	空宏	编译时完全移除，零开销