Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

SplQueue::isEmpty — sprawdzanie, czy kolejka jest pusta

Metoda `isEmpty()` sprawdza, czy kolejka `SplQueue` nie zawiera żadnych elementów. Użyj jej przed `dequeue()`, aby odróżnić pustą kolejkę od kolejki zawierającej `null` lub `false`.

Wersja: PHP 8.3

Składnia

public function isEmpty(): bool
$queue->isEmpty()

SplQueue::isEmpty to publiczna metoda instancji odziedziczona z SplDoublyLinkedList. Wywołaj ją bez argumentów przez $queue->isEmpty(), a nie statycznie. Zwraca bool: true, gdy kolejka nie ma elementów, i false, gdy ma co najmniej jeden. Nie usuwa elementów ani nie przesuwa iteratora.

Metoda sprawdza bieżący stan kolejki, nie wartości elementów: null, false i 0 nadal są elementami. Test $queue->count() === 0 odpowiada na to samo pytanie, ale isEmpty() wyraża zamiar wprost. Konstrukcja językowa empty($queue) nie sprawdza liczby elementów w obiekcie SplQueue.

enqueue() dodaje element na końcu, a dequeue() usuwa i zwraca element z początku (FIFO: pierwszy dodany, pierwszy usunięty). Wywołanie dequeue() na pustej kolejce zgłasza RuntimeException. Aby opróżnić kolejkę, sprawdzaj !$queue->isEmpty() przed każdym pobraniem. Przykład jest przeznaczony dla PHP 8.3, w którym SPL jest wbudowaną częścią PHP i nie można jej wyłączyć. Zapis \SplQueue wskazuje klasę z globalnej przestrzeni nazw.

Przykłady

<?php
$queue = new \SplQueue();
var_dump($queue->isEmpty());

$queue->enqueue(null);
$queue->enqueue(false);
var_dump($queue->isEmpty());

while (!$queue->isEmpty()) {
    var_dump($queue->dequeue());
}

var_dump($queue->isEmpty());

Wynik

bool(true)
bool(false)
NULL
bool(false)
bool(true)

Nowa kolejka daje `true`, a po dodaniu dwóch elementów — `false`. Pętla wypisuje najpierw `NULL`, potem `bool(false)`. To wartości pobrane z kolejki; ostatnie `bool(true)` oznacza, że kolejka znów jest pusta.

Powiązane lekcje

  • PHP · Lekcja 65 · Zaawansowany · Wersja: 2

Źródła