Flutter类型定义插件nullx_types的使用

nullx_types 是一个 Dart 工具包，它增强了对可空类型的处理，提供了用于空检查、导航可空结构和健壮错误处理的实用工具，以实现更简洁和更健壮的代码。

特性

• 提供用于空检查的实用工具
• 帮助在可空结构中导航
• 可空类型扩展

开始使用 🎉

要使用此包，请在 pubspec.yaml 文件中添加 nullx_types 作为依赖项：

dependencies:
  nullx_types: ^latest_version

以下是一个简单的示例，展示了如何使用 nullx_types：

import 'package:nullx_types/nullx_types.dart';

void main() async {
  /// 变量
  final List<String?>? nullableStringList = [null, 'one', null, 'two', null];
  const int? nullableInt = 10;
  const nonNullInt = 1;
  const int? nullInt = null;
  const String? nullableString = 'example';
  const String emptyString = '';
  const String? nullString = null;
  const double? nullDouble = null;
  const bool? nullBool = null;

  /// 集合
  // 一个包含可空字符串的列表
  final List<String?> strs = [null, 'one', null, 'two', null];

  // 过滤掉列表中的空元素，并将剩余元素转换为非空
  strs.where((element) => element != null).map((e) => e!).toList();
  
  const int userAge = 20;
  // 打印: 'You are an adult.'

  const double? nullableDouble = null;
  nullableDouble.orZero; // 输出: 0.0
  nullableDouble.or(defaultValue: 5.5); // 输出: 5.5

  const bool? nullableBool = null;
  nullableBool.orFalse; // 输出: false
  nullableBool.or(defaultValue: true); // 输出: true

  // 解包可空字符串并执行操作
  final res1 = executeIfAs<String>(
    () => userAge >= 18,
    ifTrue: () => 'You are an adult.',
    ifFalse: () => 'You are not an adult.',
  );

  // 打印: 'You are an adult.'
  print(res1);

  // 解包可空字符串并执行操作
  nullableString.unwrapped((value) {});
  // 打印: 'example'

  // 解包可空字符串并执行操作
  nullableString.notEmpty((s) => print(s));
  // 打印: 'The value is: example'

  // 解包可空字符串并执行操作
  final result = nullableInt.notNullWith<int>(
    isTrue: (item) => item * 2,
    isFalse: () => 0,
  );
  // 打印: 20
  print(result);

  final res2 = nullableInt.conditionNotNullAs<int>(
    condition: (value) => value > 5,
    isTrue: (value) => value * 2,
    isFalse: () => -1,
  );

  // 打印: 20
  print(res2);

  // 解包可空字符串并执行操作
  const num = 10;
  final res3 = num.takeIf((value) => value > 5);
  // 打印: 10
  print('takeIf: $res3');

  final res4 = num.takeUnless((value) => value > 5);
  // 打印: 10
  print('takeUnless: $res4');

  // 解包可空字符串并执行操作
  final res5 = nullableInt.let((item) => item * 2);
  // 打印: 20
  print('let: $res5');

  // 解包可空字符串并执行操作
  final res6 = nonNullInt.run((item) => item * 2);
  // 打印: 2
  print('run: $res6');

  var str = 'Hello';
  str.also((item) => str = item.toUpperCase());
  // 打印: HELLO
  print('also: $str');

  // 对列表进行映射，应用函数到每个非空元素，
  // 然后过滤掉空结果并转换为列表
  nullableStringList
      ?.map((s) => s.letNonNull((s) => s.length))
      .whereType<int>()
      .toList();

  // 打印: call isNullOrEmpty on null string: true
  print('call isNullOrEmpty on null string: ${nullableString.isNullOrEmpty}');

  // 打印: call isNullOrEmpty on empty string: true
  print('call isNullOrEmpty on empty string: ${emptyString.isNullOrEmpty}');

  final res8 = nullString.orDefault('hi');
  // 打印: 'hi'
  print('orDefault: $res8');

  // 解包可空整数
  nullInt.orZero; // 输出: 0
  nullInt.or(defaultValue: 5); // 输出: 5

  // 解包可空双精度浮点数
  nullDouble.orZero; // 输出: 0.0
  nullDouble.or(defaultValue: 5.5); // 输出: 5.5

  // 解包可空布尔值
  nullBool.orFalse; // 输出: false
  nullBool.or(defaultValue: true); // 输出: true
}