Fatal error: Uncaught RuntimeException: Can't shift from an empty datastructure in index.php:7
Ai apelat dequeue() (sau shift()) pe un SplQueue gol. Coada nu mai are elemente de scos, așa că PHP aruncă RuntimeException. Verifică înainte cu isEmpty() sau parcurge coada cu while (!$coada->isEmpty()).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
SplQueue e coada din biblioteca standard PHP: adaugi la final cu enqueue() și scoți de la început cu dequeue(). Spre deosebire de array_shift, care pe un tablou gol întoarce null, dequeue() pe o coadă goală aruncă RuntimeException: Can't shift from an empty datastructure.
Surata ei, SplStack, dă Can't pop from an empty datastructure la pop(), iar top() / bottom() pe o structură goală dau Can't peek at an empty datastructure.
Aproape mereu cauza e o buclă care scoate de un număr fix de ori (for până la 3) în loc să se oprească atunci când coada se golește, sau un algoritm (de exemplu BFS) în care condiția buclei nu verifică dacă mai sunt elemente.
De ce apare: cauzele frecvente
1Buclă cu număr fix de pași
<?php
$coada = new SplQueue();
$coada->enqueue('A');
for ($i = 0; $i < 2; $i++) {
echo $coada->dequeue();
}<?php
$coada = new SplQueue();
$coada->enqueue('A');
while (!$coada->isEmpty()) {
echo $coada->dequeue();
}Bucla se oprește exact când coada se golește, indiferent câte elemente a avut.
2Pop pe o stivă goală
<?php
$istoric = new SplStack();
echo $istoric->pop();<?php
$istoric = new SplStack();
echo $istoric->isEmpty() ? 'Nimic de anulat' : $istoric->pop();Tratezi separat cazul stivei goale.
3Citești vârful fără să verifici
<?php
$s = new SplStack();
echo $s->top();<?php
$s = new SplStack();
if (count($s) > 0) {
echo $s->top();
}count() funcționează pe structurile SPL, deci poți verifica înainte.
Repară eroarea, direct în pagină
Programul procesează comenzile dintr-o coadă, dar se oprește la a treia iterație cu RuntimeException: Can't shift from an empty datastructure. Repară bucla ca să proceseze toate comenzile din coadă, oricâte ar fi, și să afișeze Procesez: Comanda 101, Procesez: Comanda 102, apoi Coada e goală.
<?php
$coada = new SplQueue();
$coada->enqueue('Comanda 101');
$coada->enqueue('Comanda 102');
for ($i = 0; $i < 3; $i++) {
echo 'Procesez: ' . $coada->dequeue() . "\n";
}
echo "Coada e goală\n";Procesez: Comanda 101 Procesez: Comanda 102 Coada e goală
Indiciu
Folosește while (!$coada->isEmpty()) în loc de for.
Reparația
<?php
$coada = new SplQueue();
$coada->enqueue('Comanda 101');
$coada->enqueue('Comanda 102');
while (!$coada->isEmpty()) {
echo 'Procesez: ' . $coada->dequeue() . "\n";
}
echo "Coada e goală\n";De ce merge
Bucla for scotea de 3 ori, dar coada avea doar 2 comenzi. La a treia scoatere, dequeue() pe o coadă goală a aruncat RuntimeException.
Cu while (!$coada->isEmpty()), bucla rulează exact cât timp mai sunt comenzi, apoi programul ajunge la mesajul final.
Alte forme ale mesajului
Fatal error: Uncaught RuntimeException: Can't pop from an empty datastructure in index.php:7Fatal error: Uncaught RuntimeException: Can't peek at an empty datastructure in index.php:7Fatal error: Uncaught RuntimeException: Can't peek at an empty heap in index.php:9
Cum o eviți pe viitor
- Parcurge cozile și stivele cu
while (!$s->isEmpty()). - În funcții care scot elemente, verifică
isEmpty()la început și întoarcenullsau aruncă o excepție proprie cu un mesaj clar. - La
SplPriorityQueueșiSplHeapregula e aceeași (valid()sauisEmpty()). - Pentru cozi mici, un tablou cu
array_shift(care întoarcenull) poate fi suficient.
Întrebări frecvente
De ce SplQueue și nu un tablou simplu?
Un tablou merge pentru cozi mici, dar array_shift renumerotează tot tabloul la fiecare scoatere. SplQueue scoate în timp constant, deci e mai bun în algoritmi ca BFS pe date mari.
Pot prinde excepția în loc să verific?
Da, cu catch (RuntimeException $e), dar verificarea isEmpty() e mai clară și mai ieftină.
Erori înrudite
Fatal error: Uncaught ValueError: max(): Argument #1 ($value) must contain at least one element in index.php:4 Ai apelat max() sau min() pe un tablou gol, de exemplu după un filtru care n-a găsit nimic. Din PHP 8 asta aruncă ValueError. Verifică înainte dacă tabloul are elemente și tratează separat cazul gol. Fatal error: Uncaught ValueError: array_rand(): Argument #1 ($array) cannot be empty in index.php:4 Ai cerut un element aleator dintr-un tablou gol. array_rand() nu are ce alege, așa că aruncă ValueError. Verifică înainte dacă tabloul are elemente (if ($lista !== [])) și tratează separat cazul gol. Fatal error: Uncaught Exception: Stoc insuficient pentru Rucsac in index.php:6 Codul aruncă o excepție (cu throw) pe care nu o prinde nimeni, așa că scriptul se oprește. Pune apelul care poate eșua într-un try și tratează excepția în catch (de exemplu afișezi mesajul și continui). Învață PHP de la zero, cu exerciții la fiecare lecție
Curs PHP: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
