Flutter高级工具集插件dart_advanced_utils的使用

概述

Dart Advanced Utils 包通过添加强大且灵活的方法来增强默认的 Dart 对象。受 Python 的多功能性启发，这个包引入了扩展方法，使在 Dart 中处理对象更加直观和简洁。

更多信息请访问 dart-advanced-util。

安装

将以下依赖项添加到您的 pubspec.yaml 文件中：

dependencies:
  dart_advanced_utils: ^1.1.0

运行 flutter pub get 来安装该包。

使用

在 Dart 代码中导入该包：

import 'package:dart_advanced_utils/dart_advanced_utils.dart';

功能

列表扩展

• Operator*: 返回一个包含此列表重复 [n] 次的新列表。
• Operator+: 连接两个列表。
• count: 计算列表中元素的出现次数。
• sum: 计算列表中元素的总和。
• average: 计算列表中元素的平均值。
• median: 计算列表中所有元素的中位数。
• min: 找到列表中的最小值。
• max: 找到列表中的最大值。
• prod: 返回列表中所有元素的乘积。

字符串扩展

• capitalize: 将字符串的第一个字符大写。
• center: 在指定宽度内居中对齐字符串。
• count: 计算子字符串在字符串中的出现次数。
• isnumeric: 检查字符串中的所有字符是否为数字。
• ljust: 在指定宽度内左对齐字符串。
• rjust: 在指定宽度内右对齐字符串。
• isValidEmail: 检查当前字符串是否为有效的电子邮件地址。
• isAlphanumeric: 检查当前字符串是否为字母数字。
• isBlank: 检查当前字符串是否为空白。
• reverse: 反转字符串中字符的顺序。
• toCamelCase: 将字符串转换为驼峰命名法。
• toKebabCase: 将字符串转换为短横线命名法。
• isLow: 检查字符串是否为小写。
• isUpper: 检查字符串是否为大写。
• strip: 返回一个新的字符串，去掉开头和结尾的字符。
• title: 返回一个新的字符串，每个单词的首字母大写，其余字母小写。
• charToUpper: 返回一个新的字符串，在指定的 [index] 处的字符大写。
• format: 格式化字符串，用提供的参数替换占位符。
• isDigit: 如果字符串只包含数字，则返回 true。
• swapcase: 返回一个新的字符串，交换每个字符的大小写。

日期扩展

• isToday: 检查 DateTime 实例是否表示今天的日期。
• isYesterday: 检查 DateTime 实例是否表示昨天的日期。
• isTomorrow: 检查 DateTime 实例是否表示明天的日期。
• isInPast: 检查当前 DateTime 实例是否在过去。
• isInFuture: 检查当前 DateTime 实例是否在未来。
• isDateInRange: 检查当前日期是否在指定的开始日期和结束日期之间。
• localizedWeekday: 返回本地化的星期几名称。
• localizedMonth: 返回给定天数的本地化月份名称。
• hasDurationPassed: 检查 datetime 是否经过指定的时间段。
• addBusinessDays: 添加指定数量的工作日。
• subtractBusinessDays: 减去指定数量的工作日。
• startOfMonth: 返回当前日期所在月份的第一天。
• endOfMonth: 返回给定日期所在月份的最后一天。
• hasALeapYear: 确定给定日期的年份是否为闰年。

自定义函数

• fprint: 一个格式化的打印函数。

示例

以下是一个完整的示例 Demo：

import 'package:dart_advanced_utils/dart_advanced_utils.dart';

void main() {
  // List Extensions
  List<int> numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];

  print('Max: ${numbers.max}'); // Output: Max: 10
  print('Min: ${numbers.min}'); // Output: Min: 1
  print('Sum: ${numbers.sum}'); // Output: Sum: 55
  print('Average: ${numbers.average}'); // Output: Average: 5.5
  print('Median: ${numbers.median}'); // Output: Median: 5.5
  print('Product: ${numbers.prod}'); // Output: Product: 3628800

  List repeatedList = [54] * 3;
  print('Repeated List: $repeatedList'); // Output: Repeated List: [54, 54, 54]

  // String Extensions
  String? email = "example@example.com";
  print('Is Valid Email: ${email.isValidEmail()}'); // Output: Is Valid Email: true

  String? number = "12345";
  print('Is Numeric: ${number.isNumeric}'); // Output: Is Numeric: true

  String? alphanumeric = "abc123";
  print('Is Alphanumeric: ${alphanumeric.isAlphanumeric()}'); // Output: Is Alphanumeric: true

  String? blankString = "   ";
  print('Is Blank: ${blankString.isBlank}'); // Output: Is Blank: true

  String str = 'Hello {0}, my name is {1}';
  String str2 = 'Hello {}, my name is {}';
  print(str.format(posArgs: ['Dart', 'John'])); // Output: Hello Dart, my name is John.
  print(str2.format(posArgs: ['Jhon', 'Smith'])); // Output: Hello Jhon, my name is Smith.

  // Date Extensions
  final today = DateTime.now();
  print('Is Today: ${today.isToday}'); // Output: Is Today: true
  print('Is Yesterday: ${(today.subtract(Duration(days: 1))).isYesterday}'); // Output: Is Yesterday: true
  print('Is Tomorrow: ${(today.add(Duration(days: 1))).isTomorrow}'); // Output: Is Tomorrow: true

  // Custom Function
  final iterable = ['value1', 'value2'];
  fprint(iterable, unpack: true); // Output: value1 value2
}

贡献

如果您发现任何问题或有新功能建议，请在 GitHub 上创建问题或提交拉取请求。

许可证

该项目根据 MIT 许可证进行许可。