Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri