База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / PHP

SplQueue::enqueue — добавяне на елемент в края на опашката

Добавя една стойност в края на опашка `SplQueue`. Методът променя самата опашка и не връща резултат; елементите се изваждат в ред FIFO.

Версия: PHP 8.3

Синтаксис

public function enqueue(mixed $value): void

В PHP 8.3 SplQueue е клас от библиотеката SPL в глобалното пространство от имена. В тази версия SPL е част от ядрото на PHP и не може да бъде изключена. new \SplQueue() посочва този клас дори от друго пространство от имена. SplQueue::enqueue е метод на инстанция: $queue->enqueue($value) добавя една стойност в края на съществуващата опашка. mixed приема всяка стойност на PHP, включително null, а void означава, че методът не връща резултат или обект за верижно извикване.

enqueue() е псевдоним на SplDoublyLinkedList::push(). За ред FIFO (първи влязъл, първи излязъл) го използвай заедно с dequeue(), който премахва и връща елемента от началото на опашката. Не заменяй dequeue() с pop(): pop() премахва елемент от края.

Извикването на dequeue() върху празна опашка хвърля изключение RuntimeException. Ако опашката може да е празна, провери я с isEmpty(), преди да извадиш елемент. Върнатото null може да е съхранена стойност, а не сигнал, че опашката е празна.

Примери

<?php
$queue = new \SplQueue();
$queue->enqueue('A');
$queue->enqueue('B');

echo $queue->dequeue(), "\n";
$queue->enqueue('C');

while (!$queue->isEmpty()) {
    echo $queue->dequeue(), "\n";
}

Резултат

A
B
C

След изваждането на `A` в опашката все още чака `B`. `C` се нарежда след `B`, затова цикълът извежда `B` преди `C`.

Свързани уроци

  • PHP · Урок 65 · Напреднало · Версия: 2

Източници