KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

SplStack::isEmpty — controleren of een stapel leeg is

`isEmpty()` controleert of een `SplStack` geen elementen bevat. Een stapel met alleen de waarde `false` is dus niet leeg.

Versie: PHP 8.3

Syntax

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

SplStack::isEmpty is een publieke instantiemethode die is geërfd van SplDoublyLinkedList. De methode neemt geen argumenten aan en geeft een bool terug: true bij nul elementen en false bij minstens één element. Roep de methode aan op een object met $stack->isEmpty(), niet statisch met ::. Het voorbeeld is bedoeld voor PHP 8.3. In die versie is SPL onderdeel van de PHP-kern en kan deze bibliotheek niet worden uitgeschakeld. \SplStack verwijst naar de klasse in de globale naamruimte.

De methode verwijdert geen elementen en verplaatst de iterator niet. Ze controleert de inhoud van de hele stapel, niet de huidige positie van de iterator zoals valid() dat doet. Ook false, 0 en null tellen als elementen. Het taalconstruct empty($stack) controleert niet of de stapel nul elementen bevat.

Controleer met !$stack->isEmpty() of er een element is voordat je pop() aanroept. Op een lege stapel gooit pop() een RuntimeException. Zie een teruggegeven false niet als teken dat de stapel leeg was: het kan de verwijderde waarde zijn.

Voorbeelden

<?php

$stack = new \SplStack();
var_dump($stack->isEmpty());

$stack->push(false);
var_dump($stack->isEmpty());

if (!$stack->isEmpty()) {
    var_dump($stack->pop());
}

var_dump($stack->isEmpty());

Resultaat

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

De derde regel, `bool(false)`, toont de verwijderde waarde. De tweede regel ziet er hetzelfde uit, maar betekent dat de stapel vóór het verwijderen niet leeg was.

Gerelateerde lessen

  • PHP · Les 64 · Gevorderd · Versie: 2

Bronnen