跳到主要内容

全新自研表达式引擎 QkEval

性能全面提升​

场景ZQkEvalQkEval 优势
简单算术8.438 µs / 4857 B0.540 µs / 320 B约快 15.6 倍，少分配 93%
120 个变量仅读 2 个29.252 µs / 28035 B0.299 µs / 272 B约快 98 倍，少分配 99%
链式成员访问7.421 µs / 4785 B0.849 µs / 528 B约快 8.7 倍
条件与字符串方法7.579 µs / 4865 B1.729 µs / 952 B约快 4.4 倍
LINQ 100 元素11.044 µs / 5627 B5.626 µs / 1424 B约快 2 倍，少分配 75%
200 条冷表达式151.286 µs / 33238 B8.504 µs / 2966 B约快 17.8 倍
5 条混合表达式38.889 µs / 28948 B7.230 µs / 3784 B约快 5.4 倍

更强的诊断能力​

表达式执行失败时，QkEval 会尽量提供：

  • 出错原因
  • 出错的表达式片段
  • 对应的行号和列号
  • 暂不支持的语法类型
  • 解析错误与执行错误的区别

即使表达式经过了兼容转换，错误位置也会尽量映射回用户最初输入的代码，方便在表达式编辑器中快速定位问题。

更全面的 C# 语法支持​

相对于 Quicker 当前使用的 Z.Expressions 版本，QkEval 增加了多项现代 C# 语法支持，并改善了一些 Z 无法正确解析的标准 C# 写法。

Switch 表达式与模式匹配​

支持 C# 8 的 switch 表达式：

score switch
{
    >= 90 => "优秀",
    >= 60 and < 90 => "合格",
    _ => "不合格"
}

同时支持：

  • 常量模式
  • 类型模式
  • 关系模式
  • 属性模式
  • and、or、not 组合模式
  • when 条件
value switch
{
    string s when s.Length > 10 => "长字符串",
    string => "字符串",
    int n => n * 2,
    _ => null
}

LINQ 查询语法​

除了常见的方法链写法，QkEval 还支持 C# 查询语法：

from item in items
where item.Price > 100
orderby item.Price descending
select item.Title

目前支持的主要查询子句包括：

  • from
  • where
  • select
  • orderby
  • let
  • 多重 from
  • group by
  • join
  • join into
  • select into

目标类型 new​

当目标类型明确时，可以省略构造类型：

List<int> numbers = new() { 1, 2, 3 };

也支持带构造参数：

StringBuilder builder = new("Hello");

目标类型可以来自变量声明、赋值目标或对象成员。

集合表达式​

支持新的集合表达式语法：

int[] numbers = [1, 2, 3];

也支持展开已有集合：

int[] allNumbers = [0, ..numbers, 4];

对于无法明确推断目标集合类型的复杂场景，建议继续使用显式数组或集合初始化器。

Range 和 Index​

支持从末尾索引以及范围截取：

var last = text[^1];
var middle = text[1..^1];

目前主要支持：

  • 字符串
  • 一维数组
  • List<T> 等常见列表

元组与解构​

支持元组创建、访问和解构：

var item = (Title: "示例", Count: 3);
var title = item.Title;
var (name, count) = ("示例", 3);

也可以通过元组赋值交换变量：

(a, b) = (b, a);

局部函数​

支持在表达式代码中声明和调用局部函数：

int Add(int a, int b)
{
    return a + b;
}

return Add(1, 2);

局部函数可以提前调用、递归调用，并访问外层变量。

using var​

支持使用 using var 自动释放资源：

using var stream = new MemoryStream(data);
return stream.Length;

也支持传统的 using (...) { ... } 写法。当前主要支持实现 IDisposable 的同步资源。

更完整的字典初始化器​

Z 无法正确处理部分字典初始化语法，QkEval 支持以下两种标准写法。

索引初始化器：

new Dictionary<string, object>
{
    [".background"] = "#3ff52891",
    ["title"] = "示例"
}

集合初始化器：

new Dictionary<string, int>
{
    { "a", 1 },
    { "b", 2 }
}

这使字典可以使用 .background 等无法作为匿名对象属性名的键。

更完整的对象初始化器组合​

QkEval 支持对象初始化完成后直接继续访问成员：

new MyItem
{
    Title = "示例"
}?.Title

也修复了 Z 在“单成员对象初始化器后继续执行其他语句”时可能出现的解析错误：

var item = new MyItem { Title = "示例" };
return item.Title;