Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / PHP

SplQueue::dequeue — odebrání prvního prvku fronty

`dequeue()` odebere první prvek fronty FIFO a vrátí jeho hodnotu. U prázdné fronty vyvolá výjimku `RuntimeException`; `null` může být běžná uložená hodnota.

Verze: PHP 8.3

Syntaxe

public function dequeue(): mixed

$value = $queue->dequeue();

V PHP 8.3 je SplQueue::dequeue veřejná instanční metoda třídy \SplQueue z knihovny SPL. SPL je součástí jádra PHP 8.3 a nelze ji vypnout. Volání $queue->dequeue() nepřijímá žádné argumenty: odebere jeden prvek ze začátku fronty a vrátí jeho hodnotu jako mixed. Protože enqueue() přidává prvky na konec, odebírají se v pořadí, v jakém byly vloženy (FIFO).

Metoda je aliasem SplDoublyLinkedList::shift(). Chceš-li první prvek jen přečíst a ponechat ho ve frontě, použij zděděnou metodu bottom(). Naproti tomu pop() odebere prvek z opačného konce a vrátí jeho hodnotu.

Volání dequeue() u prázdné fronty vyvolá výjimku \RuntimeException. Pokud je prázdná fronta běžný stav, před odebráním prvku ji zkontroluj pomocí isEmpty(). Vrácené null nebo false může být uložená hodnota, nikoli signál, že je fronta prázdná.

Příklady

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

Výsledek

'A'
NULL
'B'
RuntimeException

Smyčka vypíše všechny tři hodnoty v pořadí vložení, včetně `NULL`. Poslední volání záměrně vynechá kontrolu pomocí `isEmpty()` a vypíše název třídy zachycené výjimky.

Související lekce

  • PHP · Lekce 65 · Pokročilá · Verze: 2

Zdroje