Flutter插件darq是将.NET的LINQ IEnumerable函数移植到Dart的库

#Flutter插件darq是将.NET的LINQ IEnumerable函数移植到Dart的库

简介

darq是将.NET的LINQ IEnumerable函数移植到Dart的库。此包扩展了原生Iterable类型，添加了所有在原生Dart中不存在的LINQ方法。从0.5版本开始，这个包还包含了来自MoreLINQ .NET库的扩展方法。

API参考

• Dart Docs

使用说明

由于此库使用Dart 2.6的新扩展方法，任何Iterable都可以像访问原生方法一样访问这些方法。这包括继承自Iterable的类，如List和Set。

此外，该库添加了一些新的Iterable类以简化某些实用功能：

// 创建一个包含2到6的数字迭代器：[2, 3, 4, 5, 6]
var rangeI = RangeIterable(2, 6, inclusive: true);

// 创建一个包含3个'abc'副本的迭代器：['abc', 'abc', 'abc']
var repeatI = RepeatIterable('abc', 3);

// 从字符串创建迭代器，遍历其字符
// 结果为 ['a', 'b', 'c', 'd', 'e', 'f']
var stringI = 'abcdef'.iterable;

// 使用runes代替codeUnits来尊重rune边界并保持代理对
var stringIR = 'abcdef'.iterableRunes;

示例代码

以下是一个简单的示例，展示了如何使用darq进行复杂的数据操作：

import 'package:darq/darq.dart';

void main() {
  // 创建一个列表
  var list = [10, 20, 30];
  
  // 使用select方法结合元素索引进行映射
  var mappedList = list.select((i, index) => '$index-$i'); 
  print(mappedList); // 输出: ['0-10', '1-20', '2-30']

  // 使用OrDefault变体避免错误
  var emptyList = <String>[];
  try {
    var nativeFirst = emptyList.first; // 抛出StateError
  } catch (e) {
    print('Caught error: $e');
  }
  var orDefaultFirst = emptyList.firstOrDefault('abc'); // 返回'abc'
  print(orDefaultFirst); // 输出: abc

  // 过滤重复项
  var duplicates = [1, 1, 2, 2, 3, 4, 5, 5, 5];
  var uniqueList = duplicates.distinct();
  print(uniqueList); // 输出: [1, 2, 3, 4, 5]

  // 集合操作
  var listA = [1, 2, 3, 4];
  var listB = [3, 4, 5, 6];
  var exclusion = listA.except(listB);       // [1, 2]
  var intersection = listA.intersect(listB); // [3, 4]
  var union = listA.union(listB);            // [1, 2, 3, 4, 5, 6]
  print(exclusion); // 输出: [1, 2]
  print(intersection); // 输出: [3, 4]
  print(union); // 输出: [1, 2, 3, 4, 5, 6]

  // 分组
  var groupedList = list.groupBy((i) => i % 3 == 0);
  print(groupedList); // 输出: [[1, 2], [3]]

  // 分段
  var segmented = list.segment(2);
  print(segmented); // 输出: [[1, 2], [3, 4], [5, 6]]

  // 排序
  var ordered = ['ab', 'a', 'c', 'aa', ''].orderBy((c) => c.length).thenBy((c) => c);
  print(ordered); // 输出: ['', 'a', 'c', 'aa', 'ab']

  // 复杂链式调用
  var complexResult = list.select((i, idx) => i * 2 + idx)
                          .distinct()
                          .where((i) => i > 4)
                          .orderBy((i) => i)
                          .map((i) => i.toRadixString(16));
  print(complexResult); // 输出: [6, 8, 9, A, E]

  // 解构
  var johns = [
    ("John Doe", 26, "E145326"),
    ("John Wick", 58, "E645091"),
    ("John Teesonter", 15, "E997123"),
  ];
  var (names, ages, ids) = johns.deconstruct();

  print(names); // ["John Doe", "John Wick", "John Teesonter"]
  print(ages);  // [26, 58, 15]
  print(ids);   // ["E145326", "E645091", "E997123"]
}

其他特性

Tuple支持

darq还提供了丰富的Tuple支持，允许创建和操作不可变的元组，适用于需要返回多个值的场景。

MoreLINQ扩展方法

从0.5版本开始，darq引入了来自MoreLINQ库的更多扩展方法，大大增加了可用的扩展方法数量。

例如：

• index: 将列表元素与其索引配对。
• assertAll: 断言所有元素满足某个条件。
• awaitAll: 等待所有异步操作完成。
• subsets: 生成所有子集。
• interleave: 交替合并两个列表。
• permutations: 生成所有排列。
• split: 根据分隔符分割列表。

新的Iterable类型

• RangeIterable
• RepeatIterable

字符串扩展方法

• iterable
• iterableRunes

Map扩展方法

• entryRecords
• entryTuples

Iterable扩展方法

darq提供了大量的Iterable扩展方法，可以用于各种数据处理需求，具体方法请参阅API文档。

总结

darq为Flutter开发者提供了强大的数据处理能力，通过扩展Dart的Iterable类型，使得复杂的数据操作变得更加简单和直观。无论是简单的过滤、映射，还是复杂的集合操作和排序，darq都能提供简洁而强大的解决方案。