Flutter集合采样插件dart_collection_sampler的使用

dart_collection_sampler 是一个小巧的库，实现了从集合中采样的方法。以下是该库的基本用法和一些示例代码。

特性与徽标

• Pub Package:
• Dart:
• Codecov:
• Contributor Covenant:

使用

以下是一个简单的使用示例：

void deal(int n, List<String> items, {required bool unique}) {
  // 输出选择的信息
  stdout.writeln("Picking $n from $items (unique: $unique)\n");

  // 如果只选择一个元素
  if (n == 1) {
    stdout.writeln("Selected item: ${CollectionSampler().pick(items)}");
  } else {
    // 否则选择多个元素
    stdout.writeln(
      "Selected items: ${CollectionSampler().pickN(items, n, unique: unique)}",
    );
  }
}

示例代码

下面是完整的示例代码，展示了如何使用 dart_collection_sampler 库进行集合采样。

import 'dart:io';

import 'package:args/args.dart';
import 'package:dart_collection_sampler/dart_collection_sampler.dart';

void main(List<String> arguments) {
  final argParser = ArgParser()
    ..addOption(
      "num",
      abbr: "n",
      help: "items to pick from rest of command line",
      defaultsTo: "1",
    )
    ..addFlag(
      "unique",
      abbr: "u",
      help: "select unique results",
      negatable: false,
    );

  final results = argParser.parse(arguments);

  exit(
    deal(
      int.parse(results["num"] as String),
      results.rest,
      unique: results['unique'] as bool,
    ),
  );
}

// 处理逻辑
int deal(int n, List<String> items, {required bool unique}) {
  // 检查输入是否为空
  if (items.isEmpty) {
    stderr.writeln("你必须提供一个或多个输入项");
    return 1;
  }

  // 输出选择的信息
  stdout.writeln("Picking $n from $items (unique: $unique)\n");

  // 如果只选择一个元素
  if (n == 1) {
    stdout.writeln("Selected item: ${CollectionSampler().pick(items)}");
  } else {
    // 否则选择多个元素
    stdout.writeln(
      "Selected items: ${CollectionSampler().pickN(items, n, unique: unique)}",
    );
  }
  return 0;
}

代码说明

1. 导入必要的包：

   import 'dart:io';
   import 'package:args/args.dart';
   import 'package:dart_collection_sampler/dart_collection_sampler.dart';
   

2. 解析命令行参数：

   final argParser = ArgParser()
     ..addOption(
       "num",
       abbr: "n",
       help: "items to pick from rest of command line",
       defaultsTo: "1",
     )
     ..addFlag(
       "unique",
       abbr: "u",
       help: "select unique results",
       negatable: false,
     );
   

3. 处理输入参数：

   final results = argParser.parse(arguments);
   

4. 调用 deal 函数并退出程序：

   exit(
     deal(
       int.parse(results["num"] as String),
       results.rest,
       unique: results['unique'] as bool,
     ),
   );
   

5. 定义 deal 函数：

   int deal(int n, List<String> items, {required bool unique}) {
     if (items.isEmpty) {
       stderr.writeln("你必须提供一个或多个输入项");
       return 1;
     }
     stdout.writeln("Picking $n from $items (unique: $unique)\n");
   
     if (n == 1) {
       stdout.writeln("Selected item: ${CollectionSampler().pick(items)}");
     } else {
       stdout.writeln(
         "Selected items: ${CollectionSampler().pickN(items, n, unique: unique)}",
       );
     }
     return 0;
   }