#if #ifdef #if defined 等几种常用的预处理指令的区别

在写shader时经常会出现一些预编译指令比如 #if #ifdef #if defined 等,有的时候会感到困惑,所以决定仔细查一下具体的使用方法,并做一个简单的测试。

#define

#define 指令用于定义一个宏或者常量
#define 有两种常用的格式:

  1. #define identifier token-string 定义一个宏,在预编译时会把所有identifier替换成token-string,可以用更容易理解的名称去代替一个常量,例如:#define PI 3.1415926
  2. #define identifier( argument0, ..., argumentN-1 ) token-string 定义一个类似函数一样的宏,例如:#define AREA(area, w, h) (area = w*h);

 

// #define 的使用 //
#define SOME_MACRO
#define PI 3.141593

定义宏时使用第一种方式,当没有指定 token-string 时,需要注意的两点是:

  1. 这个identifier依然是被定义了的,且可以使用#if defined 或 #ifdef 检测到的
  2. 所有identifier字符都会被移除,或者理解为所有identifier的地方都被替换成空字符串。

详细信息可以参考 #define文档
 

#if

#if 是一个预处理指令,用来控制源文件中哪一部分会被编译。
格式是: #if condition
简单来说就是 #if 后面的条件语句(condition)如果执行结果不为0,则该#if语句块内的代码会被编译,否则就不会被编译。
#elif 和 #else 可以类比为常规的用于判断条件的关键字 else if 和 else,区别是前面加了个#符号,用以表明该指令是在预处理阶段执行,而不是运行时执行。最后,在所有判断结束后需要用 #endif 来作为结尾,用于确定预处理语句的作用范围。

 

// #if 的使用 //
#define SOME_MACRO 0
#if SOME_MACRO
    return float4(1,1,1,1);
#else
    return float4(0,0,0,1);
#endif

以上代码结果返回黑色

 

// #if 的使用 //
#define SOME_MACRO
#if SOME_MACRO
    return float4(1,1,1,1);
#else
    return float4(0,0,0,1);
#endif

以上代码会报错: invalid or unsupported integer constant expression

详细信息可以参考 #if文档

 

#ifdef

#ifdef 用于判断一个常量或者宏是否被定义
格式是: #ifdef identifier
identifier是一个宏或者常量,可以通过#define指令来定义,如果identifier被定义过,则#ifdef 语句块内的代码会被编译,否则不会被编译。
#ifdef 只是判断一个常量或者宏是否被定义,不可以用于表达式判断,但是#if可以,例如:

 

#define CONST_VALUE 3
#if CONST_VALUE > 1
    return float4(1,1,1,1);
#else 
    return float4(0,0,0,1);
#endif

#ifdef CONST_VALUE > 1      // 这样写会报错 //

hlsl文档上的说法是#ifdef这种写法只是为了兼容以往版本,建议使用defined来判断,即使用 #if defined(MACRO) 这种形式,接下来就会说到。

 

These directives are provided only for compatibility with previous versions of the language. The use of the defined operator with the #if directive is preferred.

详细信息可以参考 #ifdef文档

 

#if defined

这是文档里更推荐的一种写法
#if defined 和 #ifdef 都可以用来判断一个宏是否被定义,#if !defined 等同于 #ifndef。

 

#define SOME_MACRO

// #if defined 的使用 //
#if defined(SOME_MACRO)
    // do something //
#elif defined(OTHER_MACRO)
    // do something else //
#endif

// #ifdef 的使用 //
#ifdef SOME_MACRO
    // do something //
#endif

#ifdef OTHER_MACRO
    // do something else //
#endif

 

总结

  1. 如果是根据一个宏是否被定义来决定一段代码要不要执行,建议使用 #if defined(MACRO) 方式
  2. 如果是根据一个表达式的值是否为0来决定一段代码要不要执行,建议使用 #if condition 方式
  3. #ifdef 用于判断宏或者常量是否被定义,不用于判断表达式,#if 可以用于判断表达式



作者:上午八点
链接:https://www.jianshu.com/p/5b763006b61e
来源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

已标记关键词 清除标记
©️2020 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页