内容

穷举_情况

为类似枚举的类中的所有常量定义 case 子句。

此规则从 Dart 2.9 开始可用。

规则集:推荐flutter

此规则提供 快速修复

详情

#

对类似枚举的类的实例进行 switch 操作应是穷举的。

类似枚举的类被定义为具有以下特征的具体(非抽象)类:

  • 仅包含私有非工厂构造函数
  • 两个或多个静态 const 字段,其类型为封闭类,并且
  • 定义库中没有类的子类

为类似枚举的类中的所有常量定义 case 子句。

错误

dart
class EnumLike {
  final int i;
  const EnumLike._(this.i);

  static const e = EnumLike._(1);
  static const f = EnumLike._(2);
  static const g = EnumLike._(3);
}

void bad(EnumLike e) {
  // Missing case.
  switch(e) { // LINT
    case EnumLike.e :
      print('e');
      break;
    case EnumLike.f :
      print('f');
      break;
  }
}

正确

dart
class EnumLike {
  final int i;
  const EnumLike._(this.i);

  static const e = EnumLike._(1);
  static const f = EnumLike._(2);
  static const g = EnumLike._(3);
}

void ok(EnumLike e) {
  // All cases covered.
  switch(e) { // OK
    case EnumLike.e :
      print('e');
      break;
    case EnumLike.f :
      print('f');
      break;
    case EnumLike.g :
      print('g');
      break;
  }
}

用法

#

要启用 exhaustive_cases 规则,请在您的 analysis_options.yaml 文件中,在 **linter > rules** 下添加 exhaustive_cases

analysis_options.yaml
yaml
linter:
  rules:
    - exhaustive_cases