Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / PHP

SplQueue::dequeue — odobratie prvého prvku z frontu

`dequeue()` odoberie prvý prvok z frontu FIFO a vráti jeho hodnotu. Ak je front prázdny, vyvolá výnimku `RuntimeException`; `null` môže byť uložená hodnota.

Verzia: PHP 8.3

Syntax

public function dequeue(): mixed

$value = $queue->dequeue();

V PHP 8.3 je SplQueue::dequeue verejná inštančná metóda triedy \SplQueue z knižnice SPL. SPL je súčasťou jadra PHP 8.3 a nedá sa vypnúť. Volanie $queue->dequeue() neprijíma žiadne argumenty: odoberie jeden prvok zo začiatku frontu a vráti jeho hodnotu ako mixed. Keďže enqueue() pridáva prvky na koniec, odoberajú sa v poradí vloženia (FIFO).

Metóda je aliasom SplDoublyLinkedList::shift(). Ak chceš prvý prvok len prečítať a nechať ho vo fronte, použi zdedenú metódu bottom(). Naopak, pop() odoberie prvok z opačného konca a vráti jeho hodnotu.

Volanie dequeue() na prázdnom fronte vyvolá výnimku \RuntimeException. Ak je prázdny front bežný stav, pred odobratím prvku ho skontroluj pomocou isEmpty(). Vrátené null alebo false môže byť uložená hodnota, nie signál, že je front prázdny.

Prí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ýsledok

'A'
NULL
'B'
RuntimeException

Cyklus vypíše všetky tri hodnoty v poradí vloženia vrátane `NULL`. Posledné volanie zámerne vynechá kontrolu pomocou `isEmpty()` a vypíše názov triedy zachytenej výnimky.

Súvisiace lekcie

  • PHP · Lekcia 65 · Pokročilá · Verzia: 2

Zdroje