Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła