CKTIS / PHP
SplStack::top — het bovenste element van een stack lezen
`SplStack::top` geeft de waarde van het bovenste element van een stack terug zonder het te verwijderen. Bij een lege stack gooit de methode een `\RuntimeException`.
Versie: PHP 8.3
Syntax
public function top(): mixed
$stack->top()SplStack::top is een openbare instantiemethode die wordt geërfd van SplDoublyLinkedList. Roep de methode aan op een object met $stack->top(), zonder argumenten. Ze geeft de waarde van de laatste knoop in de dubbel gelinkte lijst terug. Die knoop ligt boven op de stack en blijft op zijn plek.
push() voegt een element bovenaan toe. Volgens het LIFO-principe (last in, first out) wordt het laatst toegevoegde element als eerste verwijderd. Gebruik top() om de waarde te lezen en pop() om de waarde op te halen én het element te verwijderen. Anders dan current() is top() niet afhankelijk van de positie van de iterator.
Het retourtype mixed omvat null. Dat kan dus een opgeslagen waarde zijn en betekent niet dat de stack leeg is. Bij een lege stack gooit top() een \RuntimeException. Als een lege stack een verwachte toestand is, controleer dit dan vooraf met isEmpty().
Het voorbeeld is bedoeld voor PHP 8.3, waarin SPL is ingebouwd. Gebruik in code met een namespace de volledig gekwalificeerde namen \SplStack en \RuntimeException, of importeer de klassen.
Voorbeelden
<?php
$stack = new \SplStack();
$stack->push('A');
$stack->push('B');
echo $stack->top(), "\n";
echo $stack->top(), "\n";
echo $stack->pop(), "\n";
echo $stack->top(), "\n";
$stack->pop();
try {
$stack->top();
} catch (\RuntimeException $exception) {
echo "RuntimeException\n";
}
Resultaat
B B B A RuntimeException
De twee aanroepen van `top()` tonen `B`. Met de eerste `pop()` wordt `B` getoond en verwijderd, zodat de volgende `top()`-aanroep `A` toont. Nadat `A` is verwijderd, toont het `catch`-blok de vaste tekst `RuntimeException`, niet de melding van de uitzondering.
Gerelateerde lessen
- PHP · Les 64 · Gevorderd · Versie: 2