XWOS的标准头文件

XWOS的标准头文件 的协作图:

宏定义
#define	interface   struct
	接口
#define	xw_array_size(ay)   (sizeof(ay) / sizeof((ay)[0]))
	获取结构体数组中结构体的个数
#define	XWOS_BUG()   soc_bug()
#define	XWOS_BUG_ON(x)   if (x) XWOS_BUG()
#define	XWOS_LOOP_ON(x)   do {} while (x)
#define	XWOS_UNUSED_ARGUMENT   0
#define	XWOS_UNUSED(x)   ((void)(x))
#define	XWOS_VALIDATE(exp, errstr, ...)
	检查函数参数是否有效
#define	XWOS_PTRSIZE   4

详细描述

XWOS中所有源码文件的顶级头文件，此头文件中包含了一些基本定义：

• 配置
• 编译器的宏
• 基本类型
• 错误码
• 版本号
• 内存屏障

宏定义说明

interface

#define interface   struct

接口

在文件 standard.h 第 41 行定义.

xw_array_size

#define xw_array_size

(

ay

)

(sizeof(ay) / sizeof((ay)[0]))

获取结构体数组中结构体的个数

参数

[in]

ay

数组名

在文件 standard.h 第 48 行定义.

XWOS_BUG

#define XWOS_BUG

(

)

soc_bug()

报告BUG

在文件 standard.h 第 53 行定义.

XWOS_BUG_ON

#define XWOS_BUG_ON

(

x

)

if (x) XWOS_BUG()

当条件x成立时报告BUG

在文件 standard.h 第 57 行定义.

XWOS_LOOP_ON

#define XWOS_LOOP_ON

(

x

)

do {} while (x)

当条件x成立时循环

在文件 standard.h 第 62 行定义.

XWOS_PTRSIZE

#define XWOS_PTRSIZE   4

指针的长度

在文件 standard.h 第 90 行定义.

XWOS_UNUSED

#define XWOS_UNUSED

(

x

)

((void)(x))

去除未使用变量的警告

在文件 standard.h 第 66 行定义.

XWOS_UNUSED_ARGUMENT

#define XWOS_UNUSED_ARGUMENT   0

未使用的参数的占位符

在文件 standard.h 第 64 行定义.

XWOS_VALIDATE

#define XWOS_VALIDATE	(		exp,
			errstr,
			...
	)

值:

          if ((!(exp))) {                       \
              return __VA_ARGS__;               \
          }

检查函数参数是否有效

参数

[in]	exp	条件表达式
[in]	errstr	条件表达式为假时的错误信息
[in]	...	返回值

在文件 standard.h 第 76 行定义.