CKTIS / PHP
SplQueue::dequeue — odstrani in vrne prvi element vrste
`dequeue()` odstrani prvi element čakalne vrste FIFO in vrne njegovo vrednost. Pri prazni vrsti sproži izjemo `RuntimeException`; `null` je lahko shranjena vrednost.
Različica: PHP 8.3
Sintaksa
public function dequeue(): mixed
$value = $queue->dequeue();V PHP 8.3 je SplQueue::dequeue javna instančna metoda razreda \SplQueue iz knjižnice SPL. SPL je del jedra PHP 8.3 in je ni mogoče onemogočiti. Klic $queue->dequeue() ne sprejme argumentov: odstrani en element z začetka vrste in vrne njegovo vrednost kot mixed. Ker enqueue() dodaja elemente na konec vrste, iz nje prihajajo po vrstnem redu vstavljanja (FIFO).
Metoda je vzdevek za SplDoublyLinkedList::shift(). Če želiš prvi element le prebrati, ne da bi ga odstranil, uporabi podedovano metodo bottom(). Metoda pop() pa odstrani element na nasprotnem koncu vrste in vrne njegovo vrednost.
Klic dequeue() na prazni vrsti sproži izjemo \RuntimeException. Če je prazna vrsta pričakovana, pred odstranitvijo elementa preveri njeno stanje z isEmpty(). Vrnjeni null ali false je lahko shranjena vrednost in ne pomeni, da je vrsta prazna.
Primeri
<?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";
}
Rezultat
'A' NULL 'B' RuntimeException
Zanka izpiše vse tri vrednosti po vrstnem redu vstavljanja, vključno z `NULL`. Zadnji klic namerno preskoči preverjanje z `isEmpty()` in izpiše ime razreda prestrežene izjeme.
Povezane lekcije
- PHP · Lekcija 65 · Napredna · Različica: 2