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

CKTIS / PHP

SplQueue::enqueue — přidání prvku na konec fronty

Přidá jednu hodnotu na konec fronty `SplQueue`. Metoda mění stávající frontu a nevrací výsledek; prvky se odebírají v pořadí FIFO.

Verze: PHP 8.3

Syntaxe

public function enqueue(mixed $value): void

V PHP 8.3 je SplQueue třída knihovny SPL v globálním jmenném prostoru. V této verzi je SPL součástí jádra PHP a nelze ji vypnout. Zápis new \SplQueue() odkazuje na tuto třídu i z jiného jmenného prostoru. SplQueue::enqueue je metoda instance: $queue->enqueue($value) přidá jednu hodnotu na konec stávající fronty. mixed přijímá libovolnou hodnotu PHP včetně null; void znamená, že metoda nevrací výsledek ani objekt pro řetězení volání.

enqueue() je alias metody SplDoublyLinkedList::push(). Pro pořadí FIFO (první dovnitř, první ven) ji používej společně s dequeue(), která odebere a vrátí prvek ze začátku fronty. Nenahrazuj dequeue() metodou pop(): pop() odebírá prvek z konce.

Volání dequeue() nad prázdnou frontou vyvolá výjimku RuntimeException. Pokud může být fronta prázdná, před odebráním prvku ji zkontroluj pomocí isEmpty(). Vrácené null 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('B');

echo $queue->dequeue(), "\n";
$queue->enqueue('C');

while (!$queue->isEmpty()) {
    echo $queue->dequeue(), "\n";
}

Výsledek

A
B
C

Po odebrání `A` zůstává `B` ve frontě. `C` se zařadí za `B`, takže cyklus vypíše `B` před `C`.

Související lekce

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

Zdroje