Перечисления и символы в Dart

Перечисление используется для определения набора именованных константных значений, что делает код более читаемым.

В этой главе рассказывается, как определять перечисления Dart, расширенные перечисления (с методами и свойствами), а также типы Symbol и Rune.


Определение перечисления enum

Перечисление — это особый вид класса, используемый для представления фиксированного числа константных значений.

Наиболее типичные сценарии — представление конечного набора вариантов, таких как состояния, направления, цвета и т. д.

Пример

// Определить перечисление
enum Status {
  pending,    // Ожидание
  approved,   // Одобрено
  rejected,   // Отклонено
  cancelled,  // Отменено
}

void main() {
  // Использование значений enum
  Status currentStatus = Status.pending;
  print('Текущий статус: $currentStatus');

  // Получить индекс через .index (начиная с 0)
  print('Значение индекса: ${currentStatus.index}');  // 0

  // Получить все значения enum через .values
  print(Все статусы: ${Status.values});

  // Перебор всех значений перечисления
  for (var status in Status.values) {
    print(ПРИМЕР статус: $status, индекс: ${status.index});
  }

  // Получить значение перечисления по строке
  Status parsed = Status.values.byName('approved');
  print(Статус после парсинга: $parsed);

  // Использование перечислений в switch
  switch (currentStatus) {
    case Status.pending:
      print(Заказ в ожидании);
      break;
    case Status.approved:
      print(Заказ одобрен);
      break;
    case Status.rejected:
      print(Заказ отклонён);
      break;
    case Status.cancelled:
      print(Заказ отменён);
      break;
  }
}
当前状态: Status.pending
索引值: 0
所有状态: [Status.pending, Status.approved, Status.rejected, Status.cancelled]
EXAMPLE 状态: Status.pending, 索引: 0
EXAMPLE 状态: Status.approved, 索引: 1
EXAMPLE 状态: Status.rejected, 索引: 2
EXAMPLE 状态: Status.cancelled, 索引: 3
解析出的状态: Status.approved
订单待处理

Перечисления и switch идеально подходят друг другу. Когда вы обрабатываете все значения перечисления в switch, компилятор Dart проверяет, покрыли ли вы все случаи. Это позволяет избежать ошибок, вызванных отсутствующими ветвями.


Расширенные перечисления (с методами и свойствами)

В Dart 3.0 появились расширенные перечисления, позволяющие перечислениям иметь поля, методы и конструкторы.

Пример

// Расширенное перечисление: может иметь переменные-члены, конструкторы и методы
enum HttpStatus {
  Значения перечисления передают параметры через конструктор
  ok(200, Запрос выполнен успешно),
  created(201, Ресурс создан),
  badRequest(400, Неверный запрос),
  unauthorized(401, Неавторизован),
  notFound(404, Ресурс не найден),
  serverError(500, Внутренняя ошибка сервера);

  // Переменные-члены: каждое значение enum имеет code и message
  final int code;
  final String message;

  // Конструктор: должен быть const
  const HttpStatus(this.code, this.message);

  // Метод enum
  bool get isSuccess => code >= 200 && code < 300;
  bool get isClientError => code >= 400 && code < 500;
  bool get isServerError => code >= 500;

  // Статический метод: найти enum по коду состояния
  static HttpStatus? fromCode(int code) {
    try {
      return HttpStatus.values.firstWhere((s) => s.code == code);
    } catch (_) {
      return null;
    }
  }
}

void main() {
  var status = HttpStatus.notFound;

  print(ПРИМЕР HTTP-статуса: $status);
  print(Код состояния: ${status.code});
  print(Сообщение: ${status.message});
  print(Успешно: ${status.isSuccess});
  print('Ошибка клиента: ${status.isClientError}');

  // Поиск с помощью статического метода
  var found = HttpStatus.fromCode(201);
  if (found != null) {
    print('Статус найден: ${found.message}');
  }

  var unknown = HttpStatus.fromCode(999);
  print('Неизвестный код состояния: $unknown');
}
EXAMPLE HTTP 状态: HttpStatus.notFound
状态码: 404
Message: 资源未找到
是否成功: false
是否客户端错误: true
找到状态: 资源已创建
未知状态码: null

Расширенные перечисления превращают перечисления из "коллекций именованных констант" в "типы с поведением", позволяя им инкапсулировать логику, связанную с перечислением.

Конструкторы расширенных перечислений должны быть const, а переменные-члены должны быть final. Это связано с тем, что сами значения перечислений являются константами времени компиляции.


Тип Symbol

Symbol представляет идентификаторы в программах на Dart (имена переменных, имена функций и т. д.).

Он не часто используется в повседневной разработке; в основном применяется в сценариях рефлексии и генерации кода.

Пример

void main() {
  // Используйте префикс # для создания Symbol
  Symbol sym1 = #example;
  Symbol sym2 = #helloWorld;

  print('Символ 1: $sym1');  // Symbol("example")
  print('Symbol 2: $sym2');  // Symbol("helloWorld")

  // Сравнение Symbol
  Symbol sym3 = #example;
  print('sym1 == sym3: ${sym1 == sym3}');  // true

  // Symbol можно использовать в качестве ключа Map
  var metadata = {
    #author: 'EXAMPLE',
    #version: '1.0.0',
    #description: Учебник по Dart,
  };
  print('Автор: ${metadata[#author]}');
}
Symbol 1: Symbol("example")
Symbol 2: Symbol("helloWorld")
sym1 == sym3: true
作者: EXAMPLE

Symbol-объекты обычно минифицируются после компиляции Dart, поэтому не полагайтесь на результат Symbol("example").toString() при принятии логических решений. Правильное использование Symbol — для операций отражения через библиотеку dart:mirrors.


Runes и Unicode

Rune — это тип в Dart, который представляет кодовые точки Unicode.

В Dart строки — это последовательности, закодированные в UTF-16.

Для символов за пределами Basic Multilingual Plane (BMP), таких как эмодзи, для их обработки необходим Rune.

Пример

void main() {
  // Получить кодовые точки Unicode строки
  String text = 'EXAMPLE';
  print('Character: $text');
  print('Code point list: ${text.runes.toList()}');

  // Перебрать каждый символ и его кодовую точку
  for (var char in text.runes) {
    print('${String.fromCharCode(char)} -> U+${char.toRadixString(16).toUpperCase().padLeft(4, '0')}');
  }

  // Создать символ из кодовой точки
  var heart = String.fromCharCode(0x2764);
  print('Сердце: $heart');

  // Обработка символов, состоящих из нескольких кодовых точек (например, некоторых эмодзи)
  var smile = '\u{1F600}';  // Используйте синтаксис \u{} для представления символов за пределами BMP
  print('Смайлик: $smile');

  // Получить кодовые точки символа, состоящего из нескольких кодовых точек
  print('Кодовые точки смайлика: ${smile.runes.map((r) => 'U+${r.toRadixString(16).toUpperCase()}').toList()}');
}
字符: EXAMPLE
码点列表: [82, 85, 78, 79, 79, 66]
R -> U+0052
U -> U+0055
N -> U+004E
O -> U+004F
O -> U+004F
B -> U+0042
心形: &#x2764;
笑脸: &#x1f600;
笑脸码点: [U+1F600]

В большинстве повседневных задач разработки вам не нужно работать с Rune напрямую; строки сами хорошо обрабатывают Unicode.

Rune в основном используется, когда требуется точное управление кодовыми точками символов, например в низкоуровневых сценариях, таких как текстовые редакторы и рендеринг шрифтов.

Другие расширения