#define 详解

一、概述

1.1 概念定义

#define 是 C 语言中的预处理指令，用于定义宏。它在编译预处理阶段进行文本替换，不会进行类型检查，也不会分配内存。

1.2 作用

• 定义常量：为常用数值、字符串等创建有意义的名称
• 定义函数宏：创建类似函数的宏，在预处理时展开
• 条件编译：配合 #ifdef、#ifndef 等实现条件编译
• 提高代码可读性：使用有意义的名称使代码更易理解
• 增强代码可维护性：只需修改宏定义处即可统一更改

二、基本语法

2.1 定义对象宏（常量）

#define 宏名 替换文本

示例：

#define PI 3.1415926
#define MAX_SIZE 100
#define GREETING "Hello, World!"

2.2 定义函数宏

#define 宏名(参数列表) 替换文本

示例：

#define SQUARE(x) ((x) * (x))
#define MAX(a, b) ((a) > (b) ? (a) : (b))
#define ADD(a, b) ((a) + (b))

提示

函数宏中，参数和整个表达式都应该用括号括起来，避免运算符优先级导致的问题：

• 错误示例：#define SQUARE(x) x * x
• 正确示例：#define SQUARE(x) ((x) * (x))

三、常见用法

3.1 定义简单常量

#define PI 3.1415926
#define MAX_NUM 100
#define BUFFER_SIZE 512
#define TRUE 1
#define FALSE 0

// 使用示例
float circle_area = PI * radius * radius;
int buffer[BUFFER_SIZE];

3.2 定义字符串常量

#define PRODUCT_NAME "OneOS-Lite"
#define VERSION "1.0.0"
#define WELCOME_MSG "Welcome to OneOS-Lite!"

// 使用示例
printf("Product: %s\n", PRODUCT_NAME);

3.3 定义函数宏

// 计算平方
#define SQUARE(x) ((x) * (x))

// 求最大值
#define MAX(a, b) ((a) > (b) ? (a) : (b))

// 求最小值
#define MIN(a, b) ((a) < (b) ? (a) : (b))

// 求绝对值
#define ABS(x) ((x) < 0 ? -(x) : (x))

// 使用示例
int result = SQUARE(5);  // 展开为 ((5) * (5))
int max_val = MAX(10, 20);

3.4 定义多行宏

// 使用 \ 换行
#define PRINT_INFO(msg) \
    do { \
        printf("Info: %s\n", msg); \
        printf("File: %s\n", __FILE__); \
        printf("Line: %d\n", __LINE__); \
    } while(0)

// 使用示例
PRINT_INFO("System initialized");

提示

多行宏建议使用 do { ... } while(0) 包裹，这样可以避免大括号或分号带来的语法问题，使其在代码中的行为更像普通语句。

3.5 条件编译相关宏

#define DEBUG
#define OS_USING_SMP

// 使用 #ifdef 和 #ifndef
#ifdef DEBUG
#define LOG(msg) printf("[DEBUG] %s\n", msg)
#else
#define LOG(msg)
#endif

四、#define 在 OneOS 中的应用

4.1 初始化级别宏

在 kernel/include/os_stddef.h 中：

#define OS_INIT_LEVEL_PRE_KERNEL_1 1
#define OS_INIT_LEVEL_PRE_KERNEL_2 2
#define OS_INIT_LEVEL_POST_KERNEL 3
#define OS_INIT_LEVEL_PRE_DEVICE 4
#define OS_INIT_LEVEL_DEVICE 5
#define OS_INIT_LEVEL_COMPONENT 6
#define OS_INIT_LEVEL_APPLICATION 7

#define OS_INIT_SUBLEVEL_HIGH 1
#define OS_INIT_SUBLEVEL_MIDDLE 2
#define OS_INIT_SUBLEVEL_LOW 3

4.2 OS_INIT_CALL 宏（重点）

#define OS_INIT_CALL(fn, level, sublevel) \
    OS_USED static const init_call_entry_t _os_init_call_##fn OS_SECTION( \
        ".init_call." OS_STRING(level) "." OS_STRING(sublevel)) = {fn}

这个宏使用了多个预处理操作符：

• ##：标记拼接运算符，将两个标记连接成一个
• #：字符串化运算符，将标记转换为字符串

4.3 编译器属性宏

#define OS_SECTION(x) __attribute__((section(x)))
#define OS_USED       __attribute__((used))
#define OS_STRING(x)  #x

五、#define vs typedef

5.1 区别对比

特性	#define	typedef
处理时机	预处理阶段	编译阶段
作用	文本替换	创建类型别名
类型检查	不进行类型检查	进行类型检查
作用域	从定义处到文件结束或#undef	遵循C语言作用域规则
指针类型	可能产生意外行为	安全
适用场景	常量、简单函数宏	复杂类型定义

5.2 示例对比

// #define 方式
#define INTPTR int*
INTPTR p1, p2;  // 等价于 int* p1, p2; p1是指针，p2是int

// typedef 方式
typedef int* IntPtr;
IntPtr p3, p4;  // p3 和 p4 都是 int* 类型

六、#undef 取消宏定义

可以使用 #undef 取消之前定义的宏：

#define MAX_SIZE 100
// 使用 MAX_SIZE...

#undef MAX_SIZE  // 取消定义
// 之后不能再使用 MAX_SIZE

七、预定义宏

C 语言和编译器提供了一些预定义宏：

__FILE__    // 当前源文件名（字符串）
__LINE__    // 当前行号（整数）
__DATE__    // 编译日期（字符串，格式："MMM DD YYYY"）
__TIME__    // 编译时间（字符串，格式："HH:MM:SS"）
__func__    // 当前函数名（C99）
__STDC__    // 标准C编译器

使用示例：

#define LOG(msg) printf("[%s:%d] %s\n", __FILE__, __LINE__, msg)

LOG("System initialized");

八、最佳实践

1. 命名约定：

   • 宏名通常使用大写字母
   • 使用有意义的名称，避免过于简略
   • 多个单词使用下划线分隔（如 MAX_SIZE）

2. 使用括号：

   • 函数宏的每个参数都要用括号括起来
   • 整个表达式也要用括号括起来

3. 避免过度使用：

   • 简单的函数考虑用 inline 函数代替
   • 优先使用 enum 而非宏定义枚举值
   • 保持代码的清晰性

4. 多行宏的处理：

   • 使用 do { ... } while(0) 包裹多行宏
   • 每行末尾用 \ 续行

5. 使用注释：

   • 为复杂的宏添加注释说明用途
   • 说明宏的参数含义和注意事项

九、总结

#define 是 C 语言中强大且实用的预处理指令，在 OneOS 等嵌入式系统中广泛应用。掌握 #define 的使用可以：

• 定义有意义的常量和函数宏
• 利用预处理操作符（## 和 #）实现高级功能
• 提高代码的可读性和可维护性
• 实现条件编译和跨平台适配

但也要注意宏的局限性，避免常见陷阱，合理使用宏以发挥其最大优势。