CKTIS / PHP
SplQueue::enqueue — dodawanie elementu na koniec kolejki
Dodaj jedną wartość na koniec kolejki `SplQueue`. Metoda zmienia kolejkę w miejscu i nie zwraca wyniku; elementy odbierasz w kolejności FIFO.
Wersja: PHP 8.3
Składnia
public function enqueue(mixed $value): voidW PHP 8.3 klasa SplQueue należy do biblioteki SPL i znajduje się w globalnej przestrzeni nazw. W tej wersji SPL jest częścią rdzenia PHP i nie można jej wyłączyć. Zapis new \SplQueue() wskazuje tę klasę także z innej przestrzeni nazw. SplQueue::enqueue to metoda instancji: wywołanie $queue->enqueue($value) dopisuje jedną wartość na koniec istniejącej kolejki. mixed dopuszcza dowolną wartość PHP, w tym null, a void oznacza, że metoda nie zwraca wyniku ani obiektu do dalszego łączenia wywołań.
enqueue() jest aliasem SplDoublyLinkedList::push(). Aby zachować kolejność FIFO (pierwszy wchodzi, pierwszy wychodzi), używaj go razem z dequeue(), które usuwa i zwraca element z początku kolejki. Nie zastępuj dequeue() metodą pop(): pop() usuwa element z końca.
Wywołanie dequeue() na pustej kolejce zgłasza RuntimeException. Zanim pobierzesz element, sprawdź isEmpty(), jeśli kolejka może być pusta. Zwrócone null może być zapisaną wartością, a nie sygnałem pustej kolejki.
Przykłady
<?php
$queue = new \SplQueue();
$queue->enqueue('A');
$queue->enqueue('B');
echo $queue->dequeue(), "\n";
$queue->enqueue('C');
while (!$queue->isEmpty()) {
echo $queue->dequeue(), "\n";
}
Wynik
A B C
Po pobraniu `A` wartość `B` nadal czeka w kolejce. `C` trafia za `B`, więc pętla wypisuje najpierw `B`, a potem `C`.
Powiązane lekcje
- PHP · Lekcja 65 · Zaawansowany · Wersja: 2