PHP | Ds\Deque insert() Function

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