CKTIS / PHP
SplStack::isEmpty — sprawdzanie, czy stos jest pusty
Metoda `isEmpty()` sprawdza, czy stos `SplStack` nie zawiera żadnych elementów. Element o wartości `false` nadal sprawia, że stos nie jest pusty.
Wersja: PHP 8.3
Składnia
public function isEmpty(): bool
$stack->isEmpty()SplStack::isEmpty to publiczna metoda instancji odziedziczona z SplDoublyLinkedList. Nie przyjmuje argumentów i zwraca bool: true, gdy stos nie zawiera żadnych elementów, oraz false, gdy zawiera co najmniej jeden. Wywołaj ją na obiekcie przez $stack->isEmpty(), a nie statycznie przez ::. Przykład jest przeznaczony dla PHP 8.3, w którym SPL jest częścią rdzenia PHP i nie można jej wyłączyć. Zapis \SplStack wskazuje klasę z globalnej przestrzeni nazw.
Metoda nie usuwa elementów ani nie przesuwa iteratora. Sprawdza zawartość całego stosu, a nie bieżącą pozycję iteratora jak valid(). Wartości false, 0 i null nadal są elementami. Konstrukcja empty($stack) nie sprawdza, czy stos ma zero elementów.
Przed wywołaniem pop() możesz sprawdzić warunek !$stack->isEmpty(). Wywołanie pop() na pustym stosie zgłasza RuntimeException. Nie traktuj zwróconej wartości false jako oznaki pustego stosu: może to być wartość zdjętego elementu.
Przykłady
<?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());
Wynik
bool(true) bool(false) bool(false) bool(true)
Trzeci wiersz, `bool(false)`, to wartość zdjęta ze stosu. Drugi wiersz wygląda tak samo, ale informuje, że przed zdjęciem elementu stos nie był pusty.
Powiązane lekcje
- PHP · Lekcja 64 · Zaawansowany · Wersja: 2