Flutter表达式处理插件expressions的使用

Flutter表达式处理插件expressions的使用

expressions 是一个用于解析和评估简单表达式的库。它支持常见的编程语言语法，但不支持复杂的操作、代码块、控制流语句等。该库部分灵感来源于 jsep。

使用示例

示例 1：使用默认评估器评估表达式

import 'package:expressions/expressions.dart';
import 'dart:math';

void main() {
  example_1();
}

// 示例 1：使用默认评估器评估表达式
void example_1() {
  // 解析表达式
  var expression = Expression.parse('cos(x)*cos(x)+sin(x)*sin(x)==1');

  // 创建包含表达式中所有变量和函数的上下文
  var context = {'x': pi / 5, 'cos': cos, 'sin': sin};

  // 评估表达式
  final evaluator = const ExpressionEvaluator();
  var r = evaluator.eval(expression, context);

  print(r); // 输出: true
}

示例 2：使用自定义评估器评估表达式

import 'package:expressions/expressions.dart';

void main() {
  example_2();
}

// 示例 2：使用自定义评估器评估表达式
void example_2() {
  // 解析表达式
  var expression = Expression.parse("'Hello '+person.name");

  // 创建包含表达式中所有变量和函数的上下文
  var context = {'person': Person('Jane')};

  // 默认评估器无法处理成员表达式（如 `person.name`）。
  // 如果需要使用这些类型的表达式，需要创建一个自定义评估器，
  // 实现 `evalMemberExpression` 方法以获取对象的属性值。
  final evaluator = const MyEvaluator();
  var r = evaluator.eval(expression, context);

  print(r); // 输出: 'Hello Jane'
}

class Person {
  final String name;

  Person(this.name);

  Map<String, dynamic> toJson() => {'name': name};
}

class MyEvaluator extends ExpressionEvaluator {
  const MyEvaluator();

  [@override](/user/override)
  dynamic evalMemberExpression(
      MemberExpression expression, Map<String, dynamic> context) {
    // 获取对象并转换为 JSON 格式
    var object = eval(expression.object, context).toJson();
    // 返回对象的属性值
    return object[expression.property.name];
  }
}

功能与问题

如果您在使用过程中遇到任何问题或有功能请求，请在 issue tracker 中提交。

赞助

创建和维护这个包需要大量的时间。如果您喜欢这个项目，请考虑赞助作者，以帮助进一步改进和支持该项目。

完整示例 Demo

为了更好地理解如何在 Flutter 项目中使用 expressions 插件，下面是一个完整的 Flutter 示例应用：

import 'package:flutter/material.dart';
import 'package:expressions/expressions.dart';
import 'dart:math';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Expressions Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: ExpressionsDemo(),
    );
  }
}

class ExpressionsDemo extends StatefulWidget {
  [@override](/user/override)
  _ExpressionsDemoState createState() => _ExpressionsDemoState();
}

class _ExpressionsDemoState extends State<ExpressionsDemo> {
  String result = '';

  void evaluateExpression() {
    try {
      // 示例 1：使用默认评估器评估表达式
      var expression1 = Expression.parse('cos(x)*cos(x)+sin(x)*sin(x)==1');
      var context1 = {'x': pi / 5, 'cos': cos, 'sin': sin};
      final evaluator1 = const ExpressionEvaluator();
      var r1 = evaluator1.eval(expression1, context1);
      setState(() {
        result = '表达式 1 结果: $r1\n';
      });

      // 示例 2：使用自定义评估器评估表达式
      var expression2 = Expression.parse("'Hello '+person.name");
      var context2 = {'person': Person('Jane')};
      final evaluator2 = const MyEvaluator();
      var r2 = evaluator2.eval(expression2, context2);
      setState(() {
        result += '表达式 2 结果: $r2';
      });
    } catch (e) {
      setState(() {
        result = '评估失败: $e';
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Expressions Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: evaluateExpression,
              child: Text('评估表达式'),
            ),
            SizedBox(height: 20),
            Text(
              result,
              style: TextStyle(fontSize: 18),
            ),
          ],
        ),
      ),
    );
  }
}

class Person {
  final String name;

  Person(this.name);

  Map<String, dynamic> toJson() => {'name': name};
}

class MyEvaluator extends ExpressionEvaluator {
  const MyEvaluator();

  [@override](/user/override)
  dynamic evalMemberExpression(
      MemberExpression expression, Map<String, dynamic> context) {
    var object = eval(expression.object, context).toJson();
    return object[expression.property.name];
  }
}