CKTIS / PHP
SplQueue::dequeue — извличане на първия елемент от опашката
`dequeue()` премахва първия елемент от FIFO опашка и връща стойността му. При празна опашка хвърля `RuntimeException`, а `null` може да е съхранена стойност.
Версия: PHP 8.3
Синтаксис
public function dequeue(): mixed
$value = $queue->dequeue();В PHP 8.3 SplQueue::dequeue е публичен метод на екземпляр на класа \SplQueue от библиотеката SPL. SPL е част от ядрото на PHP 8.3 и не може да бъде изключена. Извикването $queue->dequeue() не приема аргументи: премахва един елемент от началото на опашката и връща стойността му като mixed. Тъй като enqueue() добавя елементите в края, те излизат в реда на добавяне (FIFO).
Методът е псевдоним на SplDoublyLinkedList::shift(). За да прочетеш първия елемент, без да го премахваш, използвай наследения метод bottom(). За разлика от него pop() премахва елемента от противоположния край и връща стойността му.
Извикването на dequeue() върху празна опашка хвърля \RuntimeException. Ако празната опашка е очаквано състояние, провери я с isEmpty(), преди да извадиш елемент. Върнатите null или false могат да са съхранени стойности, а не знак, че опашката е празна.
Примери
<?php
$queue = new \SplQueue();
$queue->enqueue('A');
$queue->enqueue(null);
$queue->enqueue('B');
while (!$queue->isEmpty()) {
echo var_export($queue->dequeue(), true), "\n";
}
try {
$queue->dequeue();
} catch (\RuntimeException $exception) {
echo get_class($exception), "\n";
}
Резултат
'A' NULL 'B' RuntimeException
Цикълът отпечатва и трите стойности в реда на добавяне, включително `NULL`. Последното извикване умишлено пропуска проверката с `isEmpty()` и отпечатва името на класа на прихванатото изключение.
Свързани уроци
- PHP · Урок 65 · Напреднало · Версия: 2