Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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): void

W 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

Źródła