Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

SplQueue::dequeue — pobranie i usunięcie pierwszego elementu

`dequeue()` usuwa pierwszy element kolejki FIFO i zwraca jego wartość. Pusta kolejka powoduje zgłoszenie wyjątku `RuntimeException`, natomiast `null` może być zwykłą wartością elementu.

Wersja: PHP 8.3

Składnia

public function dequeue(): mixed

$value = $queue->dequeue();

W PHP 8.3 SplQueue::dequeue jest publiczną metodą instancji klasy \SplQueue z biblioteki SPL. SPL jest wbudowana w PHP 8.3 i nie można jej wyłączyć. Wywołanie $queue->dequeue() nie przyjmuje argumentów: usuwa jeden element z początku kolejki i zwraca jego wartość jako mixed. Ponieważ enqueue() dodaje elementy na końcu, wychodzą one w kolejności dodania (FIFO).

Metoda jest aliasem SplDoublyLinkedList::shift(). Jeśli chcesz tylko odczytać pierwszy element, użyj odziedziczonej metody bottom(), która go nie usuwa. Z kolei pop() usuwa i zwraca element z przeciwnego końca.

Wywołanie dequeue() na pustej kolejce zgłasza \RuntimeException. Jeśli pusta kolejka jest normalną sytuacją, sprawdź jej stan za pomocą isEmpty() przed pobraniem elementu. Zwrócone null lub false może być zapisaną wartością, a nie sygnałem, że kolejka jest pusta.

Przykłady

<?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";
}

Wynik

'A'
NULL
'B'
RuntimeException

Pętla wypisuje trzy wartości w kolejności dodania, w tym `NULL`. Ostatnie wywołanie celowo pomija sprawdzenie `isEmpty()` i wypisuje nazwę klasy przechwyconego wyjątku.

Powiązane lekcje

  • PHP · Lekcja 65 · Zaawansowany · Wersja: 2

Źródła