Flutter工具集插件Tooly的使用

Tooly 是一个基于 Lodash 的 Dart 包，包含用于处理列表、映射、集合和对象的实用工具。

方法列表

chunk

创建一个元素组列表，每个组的长度为初始列表的大小。

Tooly.chunk([1, 2, 3, 4, 5, 6, 7, 8, 9], 3);
// [[1, 2, 3], [4, 5, 6], [7, 8, 9]]

compact

从另一个列表中创建一个不包含 null、false、0 和 '' 的列表。

Tooly.compact([0, 77, '', 55, false]);
// [77, 55]

concat

创建一个包含初始列表和附加列表的新列表。

Tooly.concat([1, 2, 3], [4, 5, 6]);
// [1, 2, 3, 4, 5, 6]

difference

创建一个不包含在第二个列表中的值的列表。

Tooly.difference([1, 2, 3], [3, 4, 5]);
// [1, 2]

drop

从开头删除 n 个元素后创建一个新列表。

Tooly.drop([1, 2, 3, 4, 5], 2);
// [3, 4, 5]

fill

从 start 到 end（不包括）填充列表的元素。

Tooly.fill([1, 2, 3, 4, 5], '*', 1, 3);
// [1, '*', '*', 4, 5]

findIndex

查找列表中值的索引。

Tooly.findIndex([1, 2, 3, 4], (e) => e == 2);
// 1

findLastIndex

从右到左遍历列表，查找值的索引。

Tooly.findLastIndex([1, 2, 3, 4], (e) => e == 2);
// 1

flatten

将列表展平一层。

Tooly.flatten([1, 2, [3, 4], ['a', 'b']]);
// [1, 2, 3, 4, 'a', 'b']

indexOf

获取值在列表中的第一个索引。

Tooly.indexOf([1, 2, 3, 4], 4);
// 3

listToString

从列表创建一个字符串。

Tooly.listToString(['first', 'second', 'third']);
// 'first, second, third'

uniq

从另一个列表创建一个没有重复元素的新列表。

Tooly.uniq([1, 1, 1, 5, 5, 8]);
// [1, 5, 8]

dropRight

从结尾删除 n 个元素后创建一个新列表。

Tooly.dropRight([1, 2, 3, 4, 5], 2);
// [1, 2, 3]

first

获取列表的第一个元素。

Tooly.first([1, 2, 3]);
// 1

flattenDeep

递归地将列表展平。

Tooly.flattenDeep([1, [2, [3, [4]], 5]]);
// [1, 2, 3, 4, 5]

initial

获取列表中除最后一个元素外的所有元素。

Tooly.initial([1, 2, 3]);
// [1, 2]

join

将列表中的所有元素转换为用分隔符连接的字符串。

Tooly.join(['a', 'b', 'c'], '~');
// 'a~b~c'

last

获取列表的最后一个元素。

Tooly.last([1, 2, 3]);
// 3

nth

获取列表中指定索引处的元素。如果索引为负数，则返回从末尾开始的第 n 个元素。

Tooly.nth([1, 2, 3, 4], 1);
// 2

Tooly.nth([1, 2, 3, 4], -2);
// 3

sum

计算列表中数字的总和。

Tooly.sum([1, 2, 3, 4]);
// 10

take

从列表开头取 n 个元素创建一个新的切片。

Tooly.take([1, 2, 3, 4], 2);
// [1, 2]

takeRight

从列表结尾取 n 个元素创建一个新的切片。

Tooly.takeRight([1, 2, 3, 4], 2);
// [3, 4]

更多方法正在开发中…

示例代码

以下是一个完整的示例，展示了如何使用 Tooly 包中的各种方法。

import 'package:tooly/tooly.dart';

void main() {
  // CHUNK
  final firstList = [1, 2, 3, 4, 5, 6, 7, 8, 9];
  print('chunk(3) -> ${Tooly.chunk(firstList, 3)}');
  // [[1, 2, 3], [4, 5, 6], [7, 8, 9]]

  // DIFFERENCE
  final secondList = [1, 2, 3];
  final thirdList = [3, 4, 5];
  print('difference -> ${Tooly.difference(secondList, thirdList)}');
  // [1, 2]

  // FIND INDEX
  final fourthList = [1, 2, 3, 4];
  print('findIndex(e == 2) -> ${Tooly.findIndex(fourthList, (e) => e == 2)}');
  // 1

  // DROP RIGHT
  print('dropRight([1, 2, 3, 4], 1) -> ${Tooly.dropRight([1, 2, 3, 4], 1)}');
  // [1, 2, 3]

  // DROP
  print('drop([1, 2, 3, 4], 2) -> ${Tooly.drop([1, 2, 3, 4], 2)}');
  // [3, 4]

  // FLATTEN (单层展平)
  final nestedList = [
    1,
    [2, 3],
    [
      4,
      [5]
    ]
  ];
  print('flatten -> ${Tooly.flatten(nestedList)}');
  // [1, 2, 3, 4, [5]]

  // FLATTEN DEEP (递归展平)
  print('flattenDeep -> ${Tooly.flattenDeep(nestedList)}');
  // [1, 2, 3, 4, 5]

  // FIRST
  print('first([10, 20, 30]) -> ${Tooly.first([10, 20, 30])}');
  // 10

  // LAST
  print('last([10, 20, 30]) -> ${Tooly.last([10, 20, 30])}');
  // 30

  // SUM
  print('sum([1, 2, 3, 4]) -> ${Tooly.sum([1, 2, 3, 4])}');
  // 10

  // JOIN
  print('join(["a", "b", "c"], "~") -> ${Tooly.join(["a", "b", "c"], "~")}');
  // a~b~c

  // NTH
  print('nth([1, 2, 3, 4], -2) -> ${Tooly.nth([1, 2, 3, 4], -2)}');
  // 3

  // LIST TO STRING
  print('listToString(["apple", "banana", "cherry"]) -> '
      '${Tooly.listToString(["apple", "banana", "cherry"])}');
  // apple, banana, cherry
}