注解
在这之前,我们已经接触了好几种注解了。
注解是一种特殊注释。更形象的说,注解是给编译器看的注释,它影响着编译器如何处理接下来的语句。
WhirlScript 的注解分为两种,分别是对语句的注解和对声明的注解。
语句注解
现有的语句注解包括这些:
注解 | 含义 |
---|---|
@sh | 接下来的语句或语句块只在编译到 sh 脚本时会被解析 |
@bat | 接下来的语句或语句块只在编译到 bat 脚本时会被解析 |
其中,@sh
和 @bat
的用法详见 目标限定 。
声明注解
现有的声明注解包括这些:
注解 | 含义 |
---|---|
@deprecated | 接下来声明的东西已被弃用。 |
@noMangle | 接下来声明的量或函数不会被名称修饰。 |
@env | 接下来声明的量为环境变量。需要声明为常量。 |
@editable | 接下来声明的量为可编辑变量,编译后将被放在脚本顶端以允许用户编辑。 |
@optional | 接下来声明的量为可选量或函数,如果没有被非可选部分代码使用则不会被添加到编译输出中。 |
@noScope | 接下来声明的宏函数没有自己的作用域。 |
@expand | 接下来的语句(如 if,for,while)会在编译期被展开(如果可以)。 |