Queue 是一种可以在两端进行操作的集合。可以通过 forEach 或 Iterator 遍历队列中的元素。
通常不允许在队列操作(如调用 forEach)进行时修改队列(添加或删除条目),因为这很可能会破坏迭代。这既适用于直接使用 iterator,也适用于迭代由 map 或 where 等方法返回的 Iterable
。
示例
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}
- 实现类型
- 实现者
- 可用扩展
构造函数
- 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
- 此 Iterable 中的元素数量。无设置器继承
- 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< ) → Iterable<T> toElements(E element)T> - 将此 可迭代对象 的每个元素扩展为零个或多个元素。继承
-
firstWhere(
bool test(E element), {E orElse()?}) → E - 返回满足给定谓词的第一个元素。继承
-
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 - 返回满足给定谓词的最后元素。继承
-
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> - 创建一个在
test
满足条件时跳过前导元素的Iterable
。继承 -
take(
int count) → Iterable< E> - 创建一个惰性可迭代的可迭代对象,包含这个可迭代对象的前
count
个元素。继承 -
takeWhile(
bool test(E value)) → Iterable< E> - 创建一个满足
test
的前导元素的可延迟可迭代对象。继承 -
toList(
{bool growable = true}) → List< E> - 创建一个包含此 可迭代对象 元素的 列表。继承
-
toSet(
) → Set< E> - 创建一个包含与该可迭代对象相同元素的 集合。继承
-
toString(
) → String - 该对象的字符串表示形式。继承
-
where(
bool test(E element)) → Iterable< E> - 创建一个新的可延迟 可迭代对象,包含所有满足谓词
test
的元素。继承 -
whereType<
T> () → Iterable< T> - 创建一个新的可延迟 可迭代对象,包含所有类型为
T
的元素。继承
运算符
-
operator ==(
Object other) → bool - 等于运算符。继承