当前位置：首页 > news >正文

AScript中一个很有意思的语法

news 2026/5/10 16:24:28

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 }