# 消息参数截取 >[success] 核心`v1.14.0`追加 >[warning] 核心`v1.15.1`之前存在如果结尾不是`{{...}}`则匹配会报错的问题。核心`v1.15.1`修复。 有些时候,可能你想要从消息中提取出来一段指定的内容,但是却总感觉截取字符串很麻烦。这时候,或许消息参数截取能够帮到你。 当你的`@Filter`注解的`keywordMatchType`参数是与**正则相关**的类型(例如`REGEX`或`FIND`),那么你便可以使用消息参数提取功能。 ## **语法** 消息参数提取需要遵循一定的规则,其规则为:**`{{name,[,regex]}}`**,即被双大括号`{{}}`包裹的键值对。其中,name代表了提取出来的值的名称,regex代表这个值的匹配规则。当不存在regex的时候,匹配规则默认为`.+` 举几个例子: - **@Filter("我今年{{age,\\d+}}岁了")** age是变量名,此变量的匹配规则为`\d+`, 而在匹配的时候,对应的匹配正则为:`我今年(\\d+)岁了` - **@Filter("我是{{name}}")** name是变量名,此变量的匹配规则为默认的`.+`, 而在匹配的时候,对应的匹配正则为:`我是(.+)` ## **使用** 知道了语法,那么如何使用呢?先举个例子: ```java @Beans public class Test{ /** 监听正则为 'number is (\\d+)'的消息,并提取\\d+为number参数 */ @Listen(MsgGetTypes.privateMsg) @Filter("number is {{number,\\d+}}") public void test1(PrivateMsg msg, MsgSender sender, @FilterValue("number") Long number){ sender.SENDER.sendPrivateMsg(msg, "您的号码为:" + number); } // ... } ``` 从上面的代码示例可以看到,在方法参数栏中通过`@FilterValue(...)`注解标注指定的变量,并填入你想要获取的对应变量名,即可将提取到的值作为变量使用了。 ## **@FilterValue** `@FilterValue(...)`注解可以标注在方法参数上,以指定提取变量赋值给对应的方法参数,此注解只有一个参数`value`,即代表提取的变量名。其中,方法参数的数据类型可以自动进行简单的类型转化,例如转为数字类型。转化通过`hutool`工具完成。