Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes