The Ds\Deque::insert() function is an inbuilt function in PHP which is used to insert the value at the given index in the Deque.
Syntax:
public Ds\Deque::insert( $index, $values ) : void
Parameters: This function accepts two parameter as mentioned above and described below:
- $index: This parameter holds the index at which element is to be inserted.
- $value: This parameter holds the value to be inserted into the given index in Deque.
Return Value: This function does not return any value.
Exception: This function throws OutOfRangeException if the Deque is empty.
Below programs illustrate the Ds\Deque::insert() function in PHP:
Program 1:
<?php   // Declare a deque $deck = new \Ds\Deque([1, 2, 3, 4, 5, 6]);   echo("Elements in the Deque\n");   // Display the Deque elements print_r($deck);   echo("\nInsert 10 at index 4 in the deque\n");   // Use insert() function to inserting // element in the deque at index 4 $deck->insert(4, 10);   // Display the Deque elements print_r($deck);   ?> |
Output:
Elements in the Deque
Ds\Deque Object
(
[0] => 1
[1] => 2
[2] => 3
[3] => 4
[4] => 5
[5] => 6
)
Insert 10 at index 4 in the deque
Ds\Deque Object
(
[0] => 1
[1] => 2
[2] => 3
[3] => 4
[4] => 10
[5] => 5
[6] => 6
)
Program 2:
<?php   // Declare a deque $deck = new \Ds\Deque([1, 2, 3, 4, 5, 6]);   echo("Original Deque\n");   // Display the Deque elements print_r($deck);   echo("\nModified Deque\n");   // Use insert() function to inserting // element in the deque at index 4 $deck->insert(3, ...[10, 20, 30, 40]);   // Display the Deque elements print_r($deck);   ?> |
Output:
Original Deque
Ds\Deque Object
(
[0] => 1
[1] => 2
[2] => 3
[3] => 4
[4] => 5
[5] => 6
)
Modified Deque
Ds\Deque Object
(
[0] => 1
[1] => 2
[2] => 3
[3] => 10
[4] => 20
[5] => 30
[6] => 40
[7] => 4
[8] => 5
[9] => 6
)
Reference: http://php.net/manual/en/ds-deque.insert.php
