Dart 集合操做插件 DartX

时间 2021-05-25

标签 git github 编程 api 微信编程语言 ide post spa 栏目快乐工作繁體版

原文原文链接

本次图片是向 kallehallden 致敬，热爱编程，保持一颗好奇的心

老铁记得转发，猫哥会呈现更多 Flutter 好文~~~~

微信 flutter 研修群 ducafecat

猫哥说

最近没时间录视频，一直在作项目和技术研究，就翻译和写写文章和你们分享。git

关于这篇文章，我只想说一切让咱们少写代码，让代码简洁的方式都是好东西！github

也许这个组件 dartx 在某些人眼里不够成熟，可是这表明了一种思路，你应该去借鉴。编程

原文

https://medium.com/flutter-co...

参考

正文

Darts Iterable 和 List 提供了一组基本的方法来修改和查询集合。然而，来自 c # 背景，它有一个非凡的 LINQ-to-Objects 库，我以为我平常使用的一部分功能缺失了。固然，任何任务均可以只使用 dart.core 方法来解决，但有时须要多行解决方案，并且代码不是那么明显，须要花费精力去理解。咱们都知道，开发人员花费大量时间阅读代码，使代码简洁明了是相当重要的。api

Dartx 包容许开发人员在集合(和其余 Dart 类型)上使用优雅且可读的单行操做。微信

https://pub.dev/packages/dartx编程语言

下面咱们将比较这些任务是如何解决的:ide

first / last collection item or null / default value / by condition;
map / filter / iterate collection items depending on their index;
converting a collection to a map;
sorting collections;
collecting unique items;
min / max / average by items property;
filtering out null items;

安装 dartx `pubspec.yaml`

dependencies:
  dartx: ^0.7.1

import 'package:dartx/dartx.dart';

First / last collection item…

… or null

为了获得第一个和最后一个收集项目的简单省道，你能够这样写:post

final first = list.first;
final last = list.last;

若是 list 为空，则抛出 statereerror，或者显式返回 null:ui

final firstOrNull = list.isNotEmpty ? list.first : null;
final lastOrNull = list.isNotEmpty ? list.last : null;

使用 dartx 能够:spa

final firstOrNull = list.firstOrNull;
final lastOrNull = list.lastOrNull;

相似地:

final elementAtOrNull = list.elementAtOrNull(index);

若是索引超出列表的界限，则返回 null。

… or default value

鉴于你如今记住这一点。第一和。当 list 为空时，last getter 会抛出错误，以获取第一个和最后一个集合项或默认值，在简单的 Dart 中，你会写:

final firstOrDefault = (list.isNotEmpty ? list.first : null) ?? defaultValue;

final lastOrDefault = (list.isNotEmpty ? list.last : null) ?? defaultValue;

使用 dartx 能够:

final firstOrDefault = list.firstOrDefault(defaultValue);

final lastOrDefault = list.lastOrElse(defaultValue);

相似于 elementAtOrNull:

final elementAtOrDefault = list.elementAtOrDefault(index, defaultValue);

若是索引超出列表的边界，则返回 defaultValue。

… by condition

要获取第一个和最后一个符合某些条件或 null 的集合项，一个普通的 Dart 实现应该是:

final firstWhere = list.firstWhere((x) => x.matches(condition));

final lastWhere = list.lastWhere((x) => x.matches(condition));

除非提供 orElse，不然它将为空列表抛出 StateError:

final firstWhereOrNull = list.firstWhere((x) => x.matches(condition), orElse: () => null);

final lastWhereOrNull = list.lastWhere((x) => x.matches(condition), orElse: () => null);

使用 dartx 能够:

final firstWhereOrNull = list.firstOrNullWhere((x) => x.matches(condition));

final lastWhereOrNull = list.lastOrNullWhere((x) => x.matches(condition));

… collection items depending on their index

Map…

当您须要得到一个新的集合，其中每一个项目以某种方式依赖于其索引时，这种状况并不罕见。例如，每一个新项都是来自原始集合的项及其索引的字符串表示形式。

若是你喜欢个人一句俏皮话，简单地说就是:

final newList = list.asMap()
  .map((index, x) => MapEntry(index, '$index $x'))
  .values
  .toList();

使用 dartx 能够:

final newList = list.mapIndexed((index, x) => '$index $x').toList();

我应用.toList ()是由于这个和大多数其余扩展方法返回 lazy Iterable。

Filter...

对于另外一个示例，假设只须要收集奇数索引项。使用简单省道，能够这样实现:

final oddItems = [];
for (var i = 0; i < list.length; i++) {
  if (i.isOdd) {
    oddItems.add(list[i]);
  }
}

或者用一行代码:

final oddItems = list.asMap()
  .entries
  .where((entry) => entry.key.isOdd)
  .map((entry) => entry.value)
  .toList();

使用 dartx 能够:

final oddItems = list.whereIndexed((x, index) => index.isOdd).toList();

// or

final oddItems = list.whereNotIndexed((x, index) => index.isEven).toList();

Iterate…

如何记录集合内容并指定项目索引？

In plain Dart:

for (var i = 0; i < list.length; i++) {
  print('$i: ${list[i]}');
}

使用 dartx 能够:

list.forEachIndexed((element, index) => print('$index: $element'));

Converting a collection to a map

例如，须要将不一样 Person 对象的列表转换为 Map < String，Person > ，其中键是 Person.id，值是完整 Person 实例。

final peopleMap = people.asMap().map((index, person) => MapEntry(person.id, person));

使用 dartx 能够:

final peopleMap = people.associate((person) => MapEntry(person.id, person));

// or

final peopleMap = people.associateBy((person) => person.id);

要获得一个 Map，其中键是 DateTime，值是列出那天出生的人的名单 < person > ，在简单的 Dart 中，你能够写:

final peopleMapByBirthDate = people.fold<Map<DateTime, List<Person>>>(
  <DateTime, List<Person>>{},
  (map, person) {
    if (!map.containsKey(person.birthDate)) {
      map[person.birthDate] = <Person>[];
    }
    map[person.birthDate].add(person);
    return map;
  },
);

使用 dartx 能够:

final peopleMapByBirthDate = people.groupBy((person) => person.birthDate);

Sorting collections

你会怎样用普通的 dart 来分类一个收集? 你必须记住这一点

list.sort();

修改源集合，要获得一个新实例，你必须写:

final orderedList = [...list].sort();

Dartx 提供了一个扩展来得到一个新的 List 实例:

final orderedList = list.sorted();

// and

final orderedDescendingList = list.sortedDescending();

如何基于某些属性对收集项进行排序？

Plain Dart:

final orderedPeople = [...people]
  ..sort((person1, person2) => person1.birthDate.compareTo(person2.birthDate));

使用 dartx 能够:

final orderedPeople = people.sortedBy((person) => person.birthDate);

// and

final orderedDescendingPeople = people.sortedByDescending((person) => person.birthDate);

更进一步，你能够经过多个属性对集合项进行排序:

final orderedPeopleByAgeAndName = people
  .sortedBy((person) => person.birthDate)
  .thenBy((person) => person.name);

// and

final orderedDescendingPeopleByAgeAndName = people
  .sortedByDescending((person) => person.birthDate)
  .thenByDescending((person) => person.name);

Collecting unique items

要得到不一样的集合项，可使用如下简单的 Dart 实现:

final unique = list.toSet().toList();

这并不保证保持项目顺序或提出一个多行的解决方案

使用 dartx 能够:

final unique = list.distinct().toList();

// and

final uniqueFirstNames = people.distinctBy((person) => person.firstName).toList();

Min / max / average by item property

例如，要查找一个 min/max 集合项，咱们能够对其进行排序，并获取 first/last 项:

final min = ([...list]..sort()).first;

final max = ([...list]..sort()).last;

一样的方法也适用于按项属性进行排序:

final minAge = (people.map((person) => person.age).toList()..sort()).first;

final maxAge = (people.map((person) => person.age).toList()..sort()).last;

或:

final youngestPerson =
  ([...people]..sort((person1, person2) => person1.age.compareTo(person2.age))).first;

final oldestPerson =
  ([...people]..sort((person1, person2) => person1.age.compareTo(person2.age))).last;

使用 dartx 能够:

final youngestPerson = people.minBy((person) => person.age);

final oldestPerson = people.maxBy((person) => person.age);

对于空集合，它将返回 null。

若是收集项目实现了 Comparable，则能够应用不带选择器的方法:

final min = list.min();

final max = list.max();

你也能够很容易地获得平均值:

final average = list.average();

// and

final averageAge = people.averageBy((person) => person.age);

以及 num 集合或 num 项属性的总和:

final sum = list.sum();

// and

final totalChildrenCount = people.sumBy((person) => person.childrenCount);

Filtering out null items

With plain Dart:

final nonNullItems = list.where((x) => x != null).toList();

使用 dartx 能够:

final nonNullItems = list.whereNotNull().toList();

More useful extensions

在 dartx 中还有其余有用的扩展。这里咱们不会深刻讨论更多细节，可是我但愿命名和代码是不言自明的。

joinToString

final report = people.joinToString(
  separator: '\n',
  transform: (person) => '${person.firstName}_${person.lastName}',
  prefix: '<<️',
  postfix: '>>',
);

all (every) / none

final allAreAdults = people.all((person) => person.age >= 18);

final allAreAdults = people.none((person) => person.age < 18);

first / second / third / fourth collection items

final first = list.first;
final second = list.second;
final third = list.third;
final fourth = list.fourth;

takeFirst / takeLast

final youngestPeople = people.sortedBy((person) => person.age).takeFirst(5);

final oldestPeople = people.sortedBy((person) => person.age).takeLast(5);

firstWhile / lastWhile

final orderedPeopleUnder50 = people
  .sortedBy((person) => person.age)
  .firstWhile((person) => person.age < 50)
  .toList();

final orderedPeopleOver50 = people
  .sortedBy((person) => person.age)
  .lastWhile((person) => person.age >= 50)
  .toList();