CKTIS / PHP
SplQueue::isEmpty — Jak zjistit, zda je fronta prázdná
`isEmpty()` ověří, zda fronta `SplQueue` neobsahuje žádné prvky. Použij tuto metodu před `dequeue()`, abys odlišil prázdnou frontu od fronty s hodnotou `null` nebo `false`.
Verze: PHP 8.3
Syntaxe
public function isEmpty(): bool
$queue->isEmpty()SplQueue::isEmpty je veřejná instanční metoda zděděná z třídy SplDoublyLinkedList. Volej ji bez argumentů jako $queue->isEmpty(), nikoli staticky. Vrací bool: true, pokud fronta nemá žádný prvek, a false, pokud obsahuje alespoň jeden. Neodebírá prvky ani neposouvá iterátor.
Kontrola se týká aktuálního stavu fronty, ne hodnot v ní uložených: null, false i 0 se počítají jako prvky. $queue->count() === 0 odpovídá na stejnou otázku, ale isEmpty() vyjadřuje záměr přímo. Jazyková konstrukce empty($queue) nezjišťuje, kolik prvků objekt SplQueue obsahuje.
enqueue() přidá prvek na konec fronty a dequeue() odebere a vrátí prvek z jejího začátku (FIFO: první vložený, první odebraný). Volání dequeue() nad prázdnou frontou vyvolá výjimku RuntimeException. Při vyprazdňování fronty před každým odebráním ověř !$queue->isEmpty(). Příklad je určen pro PHP 8.3, v němž je SPL součástí jádra a nelze ji vypnout. \SplQueue označuje třídu v globálním jmenném prostoru.
Příklady
<?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());
Výsledek
bool(true) bool(false) NULL bool(false) bool(true)
Nová fronta vrátí `true`, po dvou vloženích `false`. Smyčka vypíše nejdřív `NULL`, potom `bool(false)`. Jde o odebrané hodnoty; poslední `bool(true)` ukazuje, že je fronta opět prázdná.
Související lekce
- PHP · Lekce 65 · Pokročilá · Verze: 2