Перечисления и символы в 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 (имена переменных, имена функций и т. д.).
Он не часто используется в повседневной разработке; в основном применяется в сценариях рефлексии и генерации кода.
Пример
// Используйте префикс # для создания 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.
Пример
// Получить кодовые точки 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 心形: ❤ 笑脸: 😀 笑脸码点: [U+1F600]
В большинстве повседневных задач разработки вам не нужно работать с Rune напрямую; строки сами хорошо обрабатывают Unicode.
Rune в основном используется, когда требуется точное управление кодовыми точками символов, например в низкоуровневых сценариях, таких как текстовые редакторы и рендеринг шрифтов.
Другие расширения