KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

SplQueue::isEmpty — Controleren of een wachtrij leeg is

`isEmpty()` controleert of een `SplQueue` nul elementen bevat. Gebruik deze methode vóór `dequeue()` om een lege wachtrij te onderscheiden van een wachtrij met `null` of `false`.

Versie: PHP 8.3

Syntax

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

SplQueue::isEmpty is een openbare instantiemethode die is overgeërfd van SplDoublyLinkedList. Roep de methode zonder argumenten aan als $queue->isEmpty(), niet statisch. Ze geeft een bool terug: true als de wachtrij geen elementen bevat, en false als er minstens één element in zit. De methode verwijdert geen elementen en verplaatst de iterator niet.

De controle gaat over de huidige toestand van de wachtrij, niet over de waarden erin: null, false en 0 tellen gewoon als elementen. $queue->count() === 0 beantwoordt dezelfde vraag, maar isEmpty() maakt de bedoeling direct duidelijk. Het taalconstruct empty($queue) controleert niet hoeveel elementen het SplQueue-object bevat.

enqueue() voegt achteraan een element toe; dequeue() verwijdert het voorste element en geeft het terug (FIFO: wie het eerst binnenkomt, gaat er het eerst uit). Op een lege wachtrij gooit dequeue() een RuntimeException. Controleer bij het leegmaken vóór elke verwijdering !$queue->isEmpty(). Het voorbeeld is bedoeld voor PHP 8.3. SPL is daarin ingebouwd en kan niet worden uitgeschakeld. \SplQueue verwijst naar de klasse in de globale naamruimte.

Voorbeelden

<?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());

Resultaat

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

De nieuwe wachtrij geeft `true` terug en na twee toevoegingen `false`. De lus toont eerst `NULL` en daarna `bool(false)`. Dit zijn de verwijderde waarden; de laatste `bool(true)` geeft aan dat de wachtrij weer leeg is.

Gerelateerde lessen

  • PHP · Les 65 · Gevorderd · Versie: 2

Bronnen