Операторы разворота Spread operators ... и ...?
Вычисляет выражение коллекции, распаковывает все элементы внутри коллекции и извлекает их, после чего вставляет в другой литерал коллекции (список, Set, Map)
Не относятся к операторным выражениям: ... и ...? не являются операторами в классическом понимании, это синтаксический сахар
Существует два варианта
...collection: обычный разворот. Требуется, чтобы коллекция никогда не была равна null; передача значения null сразу вызывает ошибку
...?collection: безопасный разворот с проверкой на null. Если коллекция равна null, она игнорируется без выброса исключения
Официальные примеры легко помогут разобраться в работе конструкции
void main() {
final list1 = [1, 2, 3];
final list2 = [0, ...list1, 4, 5];
print(list2); // [0, 1, 2, 3, 4, 5]
// Безопасный разворот для null
List<int>? maybeList;
final safeList = [10, ...?maybeList, 20];
print(safeList); // [10, 20], ошибки не возникнут, если maybeList равен null
}Code language: Dart (dart)В примере выше используются две коллекции: первая содержит три элемента 1, 2, 3. Во второй коллекции первая вставляется после нуля, затем добавляются числа 4 и 5, итоговый результат — [0, 1, 2, 3, 4, 5]
Второй пример также выполняет вставку, но переменная maybeList имеет значение null и используется безопасный разворот. Поэтому элементы не добавляются, результат не меняется, ошибок не появляется
Пример с Set
void main() {
final set1 = {1, 2};
final set2 = {3, ...set1, 4};
print(set2); // {3, 1, 2, 4}
}Code language: PHP (php)
Пример с Map
void main() {
final map1 = {'a': 1, 'b': 2};
final map2 = {'c': 3, ...map1, 'd': 4};
print(map2); // {c: 3, a: 1, b: 2, d: 4}
}Code language: PHP (php)Важные замечания
Конструкцию ... нельзя использовать отдельно за пределами скобок [] и фигурных скобок {}
void main() {
final list1 = [1, 2, 3];
var arr = ...list; // Синтаксическая ошибка, можно записывать только внутри литерала коллекции
}Code language: PHP (php)D:\dartdemo\firstdart>dart run
Building package executable...
Failed to build firstdart:firstdart:
bin/firstdart.dart:3:12: Error: Expected an identifier, but got '...'.
Try inserting an identifier before '...'.
var arr = ...list; // Синтаксическая ошибка, можно записывать только внутри литерала коллекции
^^^
bin/firstdart.dart:3:12: Error: Expected ';' after this.
var arr = ...list; // Синтаксическая ошибка, можно записывать только внутри литерала коллекции
^^^
bin/firstdart.dart:3:15: Error: Undefined name 'list'.
var arr = ...list; // Синтаксическая ошибка, можно записывать только внутри литерала коллекцииCode language: PHP (php)Прямой разворот значения null через ... вызывает ошибку во время выполнения. Если переменная может быть null, обязательно используйте ...?
void main() {
List<int>? list = null;
var res = [...list]; // Возникает ошибка
var resSafe = [...?list]; // Работает корректно
}Code language: PHP (php)D:\dartdemo\firstdart>dart run
Building package executable...
Failed to build firstdart:firstdart:
bin/firstdart.dart:3:16: Error: An expression whose value can be 'null' must be null-checked before it can be dereferenced.
var res = [...list]; // Возникает ошибкаCode language: PHP (php)