C语言 — 宏命令的使用

宏的命名规则建议

规则1：对于数值或者字符串等常量的定义，建议采用全大写的英文字母，单词之间加下划线‘_’的方式命名（枚举常量同样建议使用此方式定义）。

示例：

#define PI_ROUNDED 3.14

获取结构体成员变量所占的内存空间大小的宏定义

#define member_size(type, member) sizeof(((type *)0)->member)

说明如下：

type：表示结构体类型名。

member：表示结构体成员变量名。

(type *) 0：０被强制转换了，转换成了一个TYPE类型的结构体的指针。

C标准库有一个宏定义：offsetof()，该宏的声明如下：

#include <stddef.h>
offsetof(type, member)

功能：计算一个结构体成员变量相对于结构体开头的字节偏移量，会返回一个类型为 size_t 的整型常量。

该宏的实现如下：

#ifndef offsetof
#define offsetof(TYPE, MEMBER) ((size_t) &((TYPE *)0)->MEMBER)
#endif

说明如下：

type：表示结构体类型名。

member：表示结构体成员变量名。

求数组大小的宏定义

#define ARRAY_SIZE(x)  (sizeof(x) / sizeof((x)[0]))

求两个元素的最小值宏定义

#define MIN(A, B) ((A) <= (B) ? (A):(B))

 求三个数中的最大值的宏定义

#define MAX_ABC(A, B, C) ((A) > (B) ? ((A)>(C)?(A):(C)) : ((B)>(C)?(B):(C)))

用预处理指令 #define 声明一个常数，用以表示一年中有多少秒？

#define SECONDS_PER_YEAR (60 * 60 * 24 * 365)UL

设置浮点数精度的宏定义

#define FLOAT_PRECISION_1(x)  (((double)((int32_t)((x) * 10))) / 10)

do-while (0) 在宏定义中的使用

do { 
    ... 
} while(0)

对于一个宏定义，如果是由多个语句构成，应该使用 do { ... } while(0) 结构来保护起来，最后的 while(0) 不要加分号。

示例：看下面的语句，只有宏的第一条语句被执行。

#define FOO(x) \
    printf("arg is %d\n", x); \
    do_something_useful(x);

为了说明这个问题，下面的 for 语句的书写稍不符规范

for (blah = 1; blah < 1; blah++)
    FOO(blah)

上面的 for 没有使用大括号进行保护(这是不规范的编程习惯！)，那么最终 FOO(blah) 宏的 do_something_useful(blah); 只会在 for 循环结束时执行一次，这显然是违背了编程者的最初设想的。

用大括号的定义方式可解决上面的问题：

#define FOO(x) { \
    printf("arg is %d\n", x); \
    do_something_useful(x); \
}

但是如果有人这样调用：

if (condition == 1)
    FOO(10);
else
    FOO(20);

那么这个宏还是不能正常使用，所以必须这样定义才能避免各种问题：

#define FOO(x) do { \
    printf("arg is %d\n", x); \
    do_something_useful(x); \
} while(0)

用 do-while(0) 方式定义宏，完全不用担心使用者如何使用宏，也不用给使用者加什么约束。