Skip to content

注解

在这之前,我们已经接触了好几种注解了。

注解是一种特殊注释。更形象的说,注解是给编译器看的注释,它影响着编译器如何处理接下来的语句。

WhirlScript 的注解分为两种,分别是对语句的注解和对声明的注解。

语句注解

现有的语句注解包括这些:

注解含义
@sh接下来的语句或语句块只在编译到 sh 脚本时会被解析
@bat接下来的语句或语句块只在编译到 bat 脚本时会被解析

其中,@sh@bat 的用法详见 目标限定

声明注解

现有的声明注解包括这些:

注解含义
@deprecated接下来声明的东西已被弃用。
@noMangle接下来声明的量或函数不会被名称修饰。
@env接下来声明的量为环境变量。需要声明为常量。
@editable接下来声明的量为可编辑变量,编译后将被放在脚本顶端以允许用户编辑。
@optional接下来声明的量为可选量或函数,如果没有被非可选部分代码使用则不会被添加到编译输出中。
@noScope接下来声明的宏函数没有自己的作用域。
@expand接下来的语句(如 ifforwhile)会在编译期被展开(如果可以)。

Released under the MIT License.