Flutter函数类型定义插件func_types的使用

提供了用于Dart的功能类型。

为什么应该使用这个库？ 有许多库提供功能类型，但它们提供了太多的方法来规避对值的安全处理。此库通过明确标记可能导致异常的操作为“不安全”，来强制执行对值的安全处理。

重要事项

这是一个预发布版本，公共API可能会更改。

特性

提供了以下类型：

• ✅ Option
• ✅ Either
• ✅ Result
  • ExTrace（Exception/错误和StackTrace的包装器）

还为上述类型的Iterable提供了扩展函数。

开始使用

更多示例可以在git仓库的example文件夹中找到。

使用方法

Option

void main(List<String>? nullableArgs) {
  final maybeArgs = Option.of(nullableArgs);

  // 匹配两种情况
  maybeArgs.match(
          onSome: (args) => print('Arguments were provided'),
          onNone: () => print('Missing arguments'));

  // 仅匹配非空值
  maybeArgs.ifSome((args) => print('Arguments were provided'));
  // 异步
          () async {
    await maybeArgs
            .ifSomeAsync((args) async => print('Arguments were provided'));
  }();

  // 仅匹配空值
  maybeArgs.ifNone(() => print('Missing arguments'));
  // 异步
          () async {
    await maybeArgs.ifNoneAsync(() async => print('Missing arguments'));
  }();

  // 安全获取内部值
  maybeArgs.get(List.empty());
  // 使用函数
  maybeArgs.getOr(() => List.empty());
  // 异步
          () async {
    await maybeArgs.getOrAsync(() async => List.empty());
  }();
}

Either

void main() {
  final num = one();

  // 匹配两种情况
  num.match(
      onLeft: (oneStr) {
        print(oneStr.runtimeType == String);
      },
      onRight: (oneInt) {
        print(oneInt.runtimeType == int);
      }
  );

  // 仅匹配左值
  num.ifLeft((left) => print(left.runtimeType == String));
  // 异步
  () {
    num.ifLeftAsync((left) async => print(left.runtimeType == String));
  }();

  // 安全获取左值
  num.left("2");
  // 使用函数
  num.leftOr(() => "2");
  // 异步
  () async {
    await num.leftOrAsync(() async => "2");
  }();

  // 对右值进行相同操作
}

Either<String, int> one() {
  return Either.left("1");
}

Result

String failing() {
  throw Exception();
}

void main() {
  final stringResult = Result.tryCatch(() => failing());

  // 匹配两种情况
  stringResult.match(
    onOk: (okStr) => print(okStr),
    onErr: (err) => print("${err.ex}: ${err.stackTrace}"),
  );

  // 仅匹配成功值
  stringResult.ifOk((str) => print(str));
  // 异步
  () async {
    await stringResult.ifOkAsync((str) async => print(str));
  }();

  // 仅匹配错误值
  stringResult.ifErr((err) => print(err));
  // 异步
  () async {
    await stringResult.ifErrAsync((err) async => print(err));
  }();

  // 安全获取成功值
  stringResult.ok("2");
  // 使用函数
  stringResult.okOr(() => "2");
  // 异步
  () async {
    await stringResult.okOrAsync(() async => "2");
  }();

  // 安全获取错误值
  stringResult.err(ExTrace(Exception(), StackTrace.current));
  // 使用函数
  stringResult.errOr(() => ExTrace(Exception(), StackTrace.current));
  // 异步
  () async {
    await stringResult
        .errOrAsync(() async => ExTrace(Exception(), StackTrace.current));
  }();
}