概述

可以使用表达式进行比较或运算，将结果作为参数值输入到动作模块中。
在输入框的开始使用$=表示后面的内容是一个表达式。

表达式可以用于各种通过输入框指定参数值的地方。

插值（以$$开始）应该只用于拼接文本；所有需要计算、比较的地方，应该使用表达式（以$=开始）简化操作并提升性能。
自1.9.5版本开始，表达式在内部使用Eval-expression引擎实现，支持更多语法（如Lambda表达式，详见本页内同名章节），1.9.5之前的版本通过DynamicExpresso引擎实现。

注：

• 如果希望输出结果为$=开始的文本内容（而不是进行表达式运算），可以使用表达式$="$=ABC"的形式，通过表达式返回内容为$=ABC的文本。请参考此帖子。

表达式基础

表达式是由一个或多个操作数（变量或常量）以及零个或多个运算符组成的序列，其结果为一个值。例如：

• $=5
• $={秒数}*1000
• $=”你好，” + {姓名}
• $={次数} > 5
• $={选项} == “选项1”

常量

表达式中不变的内容称作常量。

• 布尔常量：true false
• 数字常量：10 50.1
• 文本常量使用英文半角双引号包围：”China”
• 字符常量： ‘A’ ‘c’

转义字符

在文本或字符的常量值中，可以使用转义字符表示特殊符号。支持的转义字符：

• \' - 单引号 single quote, needed for character literals
• \" - 双引号 double quote, needed for string literals
• \\ - 斜线 backslash
• \n - 换行 New line (character 10)
• \r - 回车 Carriage return (character 13)
• \t - Tab跳格 Horizontal tab (character 9)

变量

表达式中值会动态变化的内容称作为变量，如前面例子中的{秒数}，{姓名}，{次数}和{选项}，它们的变量名是固定的，但值是动态变化的。更多内容请阅读变量。

启用表达式

在输入框的开始处写$= （且只在开始处写）作为启用表达式的开关，后面写表达式的内容。

在表达式中使用变量

与插值写法类似，表达式中使用 {变量名} 的方式表示动作中的变量。注意变量名需要以英文字母或汉字开始，不能以数字开始，不能包含特殊符号。
表达式编辑框，在输入{后会自动显示当前动作内的变量列表，此时输入变量名的一部分或拼音的一部分，可以筛选变量名，按tab、回车或空格可以自动填入选中的（蓝色高亮）变量名。

表达式的运算结果

根据表达式的实际计算内容，其结果可能是文本/数字/日期/布尔等类型。应尽量使表达式的结果的类型与动作模块参数类型相同。
如果参数的类型与表达式结果的不同，Quicker将尝试自动转换（如将文本转换为数字等）。

表达式支持的数据类型(C#)

表达式进阶

运算符

注：以下部分内容摘录自https://www.runoob.com/csharp/csharp-regular-expressions.html 有删改。

算术运算符

下表显示了 C# 支持的所有算术运算符。假设变量 A 的值为 10，变量 B 的值为 20，则：

关系运算符

下表显示了 C# 支持的所有关系运算符。假设变量 A 的值为 10，变量 B 的值为 20，则：

逻辑运算符

下表显示了 C# 支持的所有逻辑运算符。假设变量 A 为布尔值 true，变量 B 为布尔值 false，则：

位运算符

位运算符作用于位，并逐位执行操作。&、 | 和 ^ 的真值表如下所示：

条件运算符?:

写法：条件 ? 条件成立时返回的值 : 条件不成立返回的值，例如：

• 取两个变量的最大值： $= {a} > {b} ? {a} : {b}
• 取3个变量的最大值：$= {a} > {b} ? ({a} > {c} ? {a} : {c} ): ({b} > {c} ? {b} : {c} )

运算符的优先级

遵循c#语言的语法，请参考：https://docs.microsoft.com/zh-cn/dotnet/csharp/language-reference/operators/index#code-try-0

一般的：

• 括号具有更高的优先级 (2+3)*5 的值为25。
• 乘除优先级大于加减。 2+3*5 的值为17。
• 加减的优先级大于比较。 2+4 > 5 的值为true。

调用变量（或常量的）属性或方法

变量或常量，在c#内部都是某种对象，每种对象会支持一些c#的属性或方法函数。调用方法一般为：

• 属性： {变量}.属性名
• 变量实例方法： {变量}.方法名(参数列表)
• 类型的静态方法：类型名.方法名(参数列表)

文本类型的常用属性和方法

更详细的说明请参考：https://docs.microsoft.com/zh-cn/dotnet/api/system.string?view=netframework-4.8#methods

词典的常用属性和方法

列表的常用属性和方法

用户分享（链接）

在这个帖子里有不少用户分享了一些常用的表达式。

数学计算

数学除了可以直接使用普通的计算表达式外，还可以使用c#的静态类Math。
可以在表达式中直接使用的常量:

• Math.E 自然对数底
• Math.PI π

如，求圆的面积 $= Math.PI * {R} * {R}

可以在表达式中使用Math的静态方法。更多请参考：https://docs.microsoft.com/zh-cn/dotnet/api/system.math?view=netframework-4.8#methods
如：求2的指定次方： $= Math.Pow(2, {次数})

Quicker中的数字类型变量在内部为C#语言的double类型，整数数字类型在内部为c#的long型。

转换值的类型

• 数字->文本：可以使用.ToString()。 如 $= {数字变量}.ToString()
• 文本->小数数字：可以使用double.Parse(string)。 如 $=double.Parse({文本变量})
• 文本->整数数字:可以使用int.Parse(string)或long.Parse(string)。 如 $=int.Parse({文本变量})，也可以使用C#的Convert类转换数据的类型。如$= Convert.ToDouble({文本变量})

更多请参考：https://docs.microsoft.com/en-us/dotnet/api/system.convert?view=netframework-4.8

Lambda表达式

*本功能自1.9.5版本开始支持。
从一个例子开始：

$= {列表变量}.Where(x => !String.IsNullOrWhiteSpace(x)).Select(x => x.Trim().ToUpper() + "_后缀").ToList()

说明：

• .Where(x => !String.IsNullOrWhiteSpace(x)) 筛选掉没有可见字符的行
• .Select(x => x.Trim().ToUpper() + “_后缀”) 处理每项
  • Trim()：去除前后的空白
  • ToUpper(): 转换为大写字母
  • +”_后缀”: 叠加其他内容
• .ToList() 转换为列表类型

上面例子中使用了 x => 表达式 这样的语法，它表示对参数x做后面的处理，取其结果。
如果有多个参数，需要在参数列表两侧添加括号：(x,y,z)当计算结果的逻辑比较复杂时 => 后面可以写多个c#语句并使用{}包围起来。

下面是几个例子：

• 给列表的每项添加序号：

  $= {list}
  .Select((x,index) => {
  var temp = x.ToUpper().Trim();
  temp = index.ToString() + ": " + temp;
  return temp;
  })
  .ToList()

• 将词典转换为“用户选择”模块的可选值格式：

  $= {dict}.Select(x => x.Value.ToString() + "|" + x.Key).ToList()

• 将词典转换为Cookie数据格式：

  $= String.Join(" ", {dict}.Select(x => x.Key+ "=" + x.Value +";"))

• 将数字内容的列表按数字大小排序：

  $= {list}.Select(x => Convert.ToInt32(x))
  .OrderBy(x => x)
  .Select(x => x.ToString())
  .ToList()

• 将两个同样长度的列表的每个元素横向合并：

  $= {list1}.Select((x,index) => x + {list2}[index]).ToList()

示例动作：https://getquicker.net/sharedaction?code=acf2fc09-3753-4b67-d714-08d827485760
关于Lambda，请参考：https://docs.microsoft.com/zh-cn/dotnet/csharp/programming-guide/statements-expressions-operators/lambda-expressions
Select()/Where()/ToList() 是C#中System.Linq.Enumerable静态类下的扩展函数。

与插值方式的比较

• 插值的作用是将变量的值插入到一段文本中。其结果也是一段文本。
• 插值将直接将变量的内容转换成文本插入当前位置，而在表达式中，将使用变量本身参与运算，不再转换成文本。
• 在需要接收布尔类型值的参数中（例如，在“如果”模块），插值后的结果文本会被作为一个表达式进行解析，转换为布尔值。
  • 比较字符串时，插值方式使用单引号包围两个被比较的字符串。

• 使用表达式时，变量名不需要使用单引号包围，文本常量需要使用双引号包围。

• 在需要比较、计算的场景下，应该使用$=表达式的写法。

缺点：
- 功能比较受限
| 优点：
- 可以使用变量自身的c#属性和方法；
- 功能强大；
|

示例：

表达式的辅助编写

自1.24.27版本开始提供表达式自动补全和语法校验功能。

补全窗口显示后，可以按方向键选择目标条目，然后通过tab或回车选择。

您可以在配置中开启此功能：

请注意：

• 需要联网从服务器端获取补全信息。
• 基于技术限制，补全信息不能完全准确的反应表达式中可以使用的方法或关键词。您还需要实际运行动作来验证表达式是否可以正常工作。