Класс Queue<E>

Queue — это коллекция, с которой можно работать с обоих концов. Элементы очереди можно перебирать с помощью forEach или Iterator.

Как правило, во время выполнения операции с очередью, например вызова forEach, не разрешается изменять очередь (добавлять или удалять записи). Изменение очереди во время её перебора, скорее всего, нарушит перебор. Это относится как к непосредственному использованию итератора, так и к перебору Iterable, возвращённого таким методом, как map или where.

Пример:

final queue = Queue<int>(); // ListQueue() by default
print(queue.runtimeType); // ListQueue

// Adding items to queue
queue.addAll([1, 2, 3]);
queue.addFirst(0);
queue.addLast(10);
print(queue); // {0, 1, 2, 3, 10}

// Removing items from queue
queue.removeFirst();
queue.removeLast();
print(queue); // {1, 2, 3}

Реализуемые типы

Iterable<T>

Реализации

Доступные расширения

EnumByName

Конструкторы

Queue() фабричный: Создаёт очередь.
Queue.from(Iterable elements) фабричный: Создаёт очередь, содержащую все elements.
Queue.of(Iterable<E> elements) фабричный: Создаёт очередь из elements.

Свойства

first → E только чтениеунаследовано: Возвращает первый элемент.
hashCode → int только чтениеунаследовано: Хеш-код этого объекта.
isEmpty → bool только чтениеунаследовано: Есть ли в этой коллекции элементы.
isNotEmpty → bool только чтениеунаследовано: Содержит ли эта коллекция хотя бы один элемент.
iterator → Iterator<E> только чтениеунаследовано: Возвращает новый Iterator, позволяющий перебирать элементы этой Iterable.
last → E только чтениеунаследовано: Возвращает последний элемент.
length → int только чтениеунаследовано: Возвращает количество элементов в итерируемом объекте.
runtimeType → Type только чтениеунаследовано: Представление типа объекта во время выполнения.
single → E только чтениеунаследовано: Проверяет, что в этом итерируемом объекте только один элемент, и возвращает его.

Методы

add(E value) → void: Добавляет value в конец очереди.
addAll(Iterable<E> iterable) → void: Добавляет все элементы iterable в конец очереди. Длина очереди увеличивается на длину iterable.
addFirst(E value) → void: Добавляет value в начало очереди.
addLast(E value) → void: Добавляет value в конец очереди.
any(bool test(E element)) → bool унаследовано: Проверяет, удовлетворяет ли какой-либо элемент этого итерируемого объекта условию test.
cast<R>() → Queue<R> переопределение: При необходимости предоставляет представление этой очереди как очереди экземпляров R.
clear() → void: Удаляет все элементы очереди. Размер очереди становится равен нулю.
contains(Object? element) → bool унаследовано: Содержит ли коллекция элемент, равный element.
elementAt(int index) → E унаследовано: Возвращает элемент с индексом index.
every(bool test(E element)) → bool унаследовано: Проверяет, удовлетворяет ли каждый элемент этого итерируемого объекта условию test.
expand<T>(Iterable<T> toElements(E element)) → Iterable<T> унаследовано: Преобразует каждый элемент этого Iterable в ноль или более элементов.
firstWhere(bool test(E element), {E orElse()?}) → E унаследовано: Возвращает первый элемент, удовлетворяющий заданному предикату test.
fold<T>(T initialValue, T combine(T previousValue, E element)) → T унаследовано: Сводит коллекцию к одному значению, последовательно объединяя каждый её элемент с текущим значением
followedBy(Iterable<E> other) → Iterable<E> унаследовано: Возвращает ленивую конкатенацию этого итерируемого объекта и other.
forEach(void action(E element)) → void унаследовано: Вызывает action для каждого элемента этого итерируемого объекта в порядке перебора.
join([String separator = ""]) → String унаследовано: Преобразует каждый элемент в String и объединяет полученные строки.
lastWhere(bool test(E element), {E orElse()?}) → E унаследовано: Возвращает последний элемент, удовлетворяющий заданному предикату test.
map<T>(T toElement(E e)) → Iterable<T> унаследовано: Текущие элементы этого итерируемого объекта, преобразованные с помощью toElement.
noSuchMethod(Invocation invocation) → dynamic унаследовано: Вызывается при обращении к несуществующему методу или свойству.
reduce(E combine(E value, E element)) → E унаследовано: Сводит коллекцию к одному значению, последовательно объединяя её элементы с помощью заданной функции.
remove(Object? value) → bool: Удаляет из очереди один экземпляр value.
removeFirst() → E: Удаляет и возвращает первый элемент этой очереди.
removeLast() → E: Удаляет и возвращает последний элемент очереди.
removeWhere(bool test(E element)) → void: Удаляет из очереди все элементы, соответствующие условию test.
retainWhere(bool test(E element)) → void: Удаляет из очереди все элементы, не соответствующие условию test.
singleWhere(bool test(E element), {E orElse()?}) → E унаследовано: Возвращает единственный элемент, удовлетворяющий условию test.
skip(int count) → Iterable<E> унаследовано: Возвращает Iterable, содержащий все элементы, кроме первых count.
skipWhile(bool test(E value)) → Iterable<E> унаследовано: Возвращает Iterable, пропускающий начальные элементы, пока выполняется условие test.
take(int count) → Iterable<E> унаследовано: Возвращает ленивый итерируемый объект, содержащий первые count элементов этого итерируемого объекта.
takeWhile(bool test(E value)) → Iterable<E> унаследовано: Возвращает ленивый итерируемый объект, содержащий начальные элементы, удовлетворяющие условию test.
toList({bool growable = true}) → List<E> унаследовано: Создаёт List, содержащий элементы этого Iterable.
toSet() → Set<E> унаследовано: Создаёт Set, содержащий те же элементы, что и этот итерируемый объект.
toString() → String унаследовано: Строковое представление этого объекта.
where(bool test(E element)) → Iterable<E> унаследовано: Возвращает новый ленивый Iterable со всеми элементами, удовлетворяющими предикату test.
whereType<T>() → Iterable<T> унаследовано: Возвращает новый ленивый Iterable со всеми элементами типа T.

Операторы

operator ==(Object other) → bool унаследовано: Оператор равенства.

Статические методы

castFrom<S, T>(Queue<S> source) → Queue<T> переопределение: Адаптирует source, чтобы получить Queue<T>.

© 2012 the Dart project authors
Licensed under the BSD 3-Clause "New" or "Revised" License.
https://api.dart.dev/stable/2.19.6/dart-collection/Queue-class.html