AScript是一个开源的C#动态脚本解析执行引擎,支持解析执行和编译执行2种模式,其中有个语法很有意思,那就是static语法。
在解析执行模式下,static语句与非static语句是等效的;
在编译执行模式下,static语句会在编译期间执行,也就是说static语句不会被编译,而是直接执行并返回结果。
示例
我们来看一个示例:
1 var s = @"
2 static int n = 10; // 直接执行,不参与编译
3 static x = n * 2; // 直接执行,不参与编译
4 int y = static n * 2; // 编译结果:y = 20
5 /*
6 int m=20;
7 int a = static m * 2; // 报错:variable m is not exists
8 */
9 int z = n * 2; // 编译结果:z = n * 2
10 x+y+z;
11 ";
12 var script = new Script();
13 // 编译
14 var func = script.Compile<int>(s);
15 Assert.AreEqual(10, script.Context.EvalVar("n"));
16 Assert.AreEqual(20, script.Context.EvalVar("x"));
17 Assert.IsNull(script.Context.EvalVar("y"));
18 Assert.IsNull(script.Context.EvalVar("z"));
19 // 执行
20 Assert.AreEqual(60, func());
static语句中的变量必须是在static语句中定义的,由于变量n、x是在static语句中定义的,脚本执行前就已经计算出结果了,上面示例编译结果为:
1 int y = 20;
2 int z = n * 2;
3 x+y+z;
那么基于static语法的特性,我们可以在哪些场景中使用呢?
场景一:eval函数
在之前一篇文章《AScript之eval函数详解》中介绍过eval函数的功能和运行机制。
1 int n=10;
2 var s='n+20';
3 eval(s); // 结果为20
如上示例在编译执行模式下计算结果并不是我们预期的30,我们使用static语法试试:
1 int n=10;
2 static var s='n+20';
3 eval(static s); // 结果为30
结果是预期的30了,我们可以在static语句中对字符串进行拼接处理,然后给到eval来执行。
场景二:编译委托
1 string s = @"
2 static {
3 min+=10;
4 max+=5;
5 }
6 n >= min && n <= max
7 ";
8 var script = new Script();
9 script.Context.SetVar("min", 20);
10 script.Context.SetVar("max", 50);
11 var func = script.Compile<int, bool>(s, "n");
12 int total = 0;
13 for (int i = 0; i < 10000; i++)
14 {
15 if (func(i)) total++;
16 }
17 Assert.AreEqual(26, total);
我们可以利用static语法的特性,在脚本中做一些初始化逻辑,比如从数据库中获取配置等。
实现原理
最后我们来看看static语法是如何实现的吧?
1 public class StaticTokenHandler : ITokenHandler
2 {
3 public static readonly StaticTokenHandler Instance = new StaticTokenHandler();
4
5 public void Build(DefaultSyntaxAnalyzer analyzer, TokenAnalyzingArgs e)
6 {
7 e.IsHandled = true;
8 if (e.TreeBuilder.IsFullStatement())
9 {
10 e.End = true;
11 e.TokenReader.Push(e.CurrentToken);
12 return;
13 }
14 var options = e.Options;
15 // 如果当前为编译模式,则改为使用执行模式
16 if ((options.CompileMode?? ECompileMode.None) == ECompileMode.All)
17 {
18 options = new BuildOptions(e.Options) { CompileMode = ECompileMode.None };
19 }
20 var node = analyzer.BuildOneStatement2(e.BuildContext, e.ScriptContext, options, e.TokenReader, e.Control, e.Ignore, noblock: true);
21 if (node != null && !e.Ignore)
22 {
23 // 执行并返回结果
24 var v = node.Eval(e.ScriptContext, options, e.Control, out var type);
25 e.TreeBuilder.AddData(e.BuildContext, e.ScriptContext, e.Options, e.Control, PoolManage.CreateObjectNode(v, type));
26 }
27 }
28 }
然后在CSharpLang中注册: AddTokenHandler("static", StaticTokenHandler.Instance); ,几行代码就实现了一个有意思语法。
说点什么
还有一个@lang/@end语法也是比较有意思,脚本中可以嵌入其他语言。
最后,AScript是一个灵活、成长性强的脚本引擎,你可以用它来实现自己的想法,大家如果有想到什么好玩的功能不妨试试!
AScript开源地址:https://gitee.com/rockey627/AScript