CKTIS / PHP
SplStack::isEmpty — verificar se uma pilha está vazia
`isEmpty()` verifica se uma pilha `SplStack` não contém elementos. Uma pilha que contém apenas o valor `false` não está vazia.
Versão: PHP 8.3
Sintaxe
public function isEmpty(): bool
$stack->isEmpty()SplStack::isEmpty é um método de instância público herdado de SplDoublyLinkedList. Não recebe argumentos e devolve um bool: true se a pilha não tiver elementos e false se tiver pelo menos um. Invoca-o num objeto com $stack->isEmpty(), não de forma estática com ::. O exemplo destina-se ao PHP 8.3. Nesta versão, a SPL faz parte do núcleo do PHP e não pode ser desativada. \SplStack identifica a classe no espaço de nomes global.
O método não retira elementos nem desloca o iterador. Verifica o conteúdo de toda a pilha, não a posição atual do iterador como faz valid(). Valores como false, 0 e null contam como elementos. A construção empty($stack) não verifica se a pilha tem zero elementos.
Antes de invocares pop(), usa !$stack->isEmpty() para verificar se há um elemento. Se a pilha estiver vazia, pop() lança uma RuntimeException. Não interpretes um valor devolvido de false como sinal de que a pilha estava vazia: pode ser o valor retirado.
Exemplos
<?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());
Resultado
bool(true) bool(false) bool(false) bool(true)
A terceira linha, `bool(false)`, mostra o valor retirado. A segunda linha é igual, mas indica que a pilha não estava vazia antes da remoção.
Lições relacionadas
- PHP · Lição 64 · Avançado · Versão: 2