Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

SplStack::isEmpty — verificare se una pila è vuota

`isEmpty()` verifica se una pila `SplStack` non contiene elementi. Una pila che contiene soltanto il valore `false` non è vuota.

Versione: PHP 8.3

Sintassi

public function isEmpty(): bool
$stack->isEmpty()

SplStack::isEmpty è un metodo pubblico di istanza ereditato da SplDoublyLinkedList. Non accetta argomenti e restituisce un bool: true se la pila non contiene elementi, false se ne contiene almeno uno. Invocalo su un oggetto con $stack->isEmpty(), non in modo statico con ::. L’esempio è pensato per PHP 8.3. In questa versione, SPL fa parte del nucleo di PHP e non può essere disattivata. \SplStack indica la classe nello spazio dei nomi globale.

Il metodo non rimuove elementi né sposta l’iteratore. Controlla il contenuto dell’intera pila, non la posizione corrente dell’iteratore come fa valid(). Anche false, 0 e null contano come elementi. Il costrutto empty($stack) non verifica se la pila contiene zero elementi.

Prima di chiamare pop(), usa !$stack->isEmpty() per verificare che sia presente un elemento. Su una pila vuota, pop() lancia una RuntimeException. Un valore restituito pari a false non indica che la pila fosse vuota: può essere il valore rimosso.

Esempi

<?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());

Risultato

bool(true)
bool(false)
bool(false)
bool(true)

La terza riga, `bool(false)`, mostra il valore rimosso. La seconda è identica, ma indica che la pila non era vuota prima della rimozione.

Lezioni correlate

  • PHP · Lezione 64 · Avanzato · Versione: 2

Fonti