KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

SplStack::push — Een waarde boven op de stapel leggen

Met push() voeg je één waarde toe aan een bestaande SplStack. De volgende aanroep van pop() verwijdert die waarde en geeft haar terug als de bovenkant van de stapel niet intussen is veranderd.

Versie: PHP 8.3

Syntax

public function SplDoublyLinkedList::push(mixed $value): void

$stack = new \SplStack();
$stack->push($value);

SplStack::push is een publieke instantiemethode die is geërfd van SplDoublyLinkedList. De aanroep $stack->push($value) voegt een element toe aan het einde van de dubbel gekoppelde lijst, dus boven op de stapel. De notatie met :: duidt de methode aan, maar betekent niet dat je die statisch aanroept. De klasse hoort bij SPL. In standaard-PHP 8.3 is SPL altijd ingeschakeld en kun je die niet via de PHP-configuratie uitschakelen. new \SplStack() kiest de klasse in de globale naamruimte.

Elke aanroep accepteert precies één waarde van het type mixed, waaronder null. Een array die je als $value doorgeeft, wordt één element en niet een reeks losse elementen. De methode wijzigt het bestaande object en heeft retourtype void: je krijgt geen aantal elementen terug en ook geen stapel waarmee je aanroepen kunt koppelen.

pop() verwijdert een waarde aan hetzelfde uiteinde en geeft die terug. Samen volgen push() en pop() dus het LIFO-principe: wat je als laatste toevoegt, haal je er als eerste af. top() geeft de bovenste waarde terug zonder die te verwijderen. Beide methoden werpen een \RuntimeException als de stapel leeg is; controleer dit zo nodig eerst met isEmpty(). De iteratiemodus bepaalt niet welk uiteinde push() en pop() gebruiken.

Voorbeelden

<?php

$stack = new \SplStack();
$stack->push('first');
$stack->push('second');

echo 'top: ', $stack->top(), "\n";

while (!$stack->isEmpty()) {
    echo 'pop: ', $stack->pop(), "\n";
}

Resultaat

top: second
pop: second
pop: first

`second` verschijnt twee keer: `top()` leest de waarde en de eerste aanroep van `pop()` verwijdert die. De volgende aanroep van `pop()` verwijdert `first`. De lus stopt voordat `pop()` op een lege stapel wordt aangeroepen.

Gerelateerde lessen

  • PHP · Les 64 · Gevorderd · Versie: 2

Bronnen