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

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

Zdroje