La función Ds\Deque::insert() es una función incorporada en PHP que se usa para insertar el valor en el índice dado en Deque.
Sintaxis:
public Ds\Deque::insert( $index, $values ) : void
Parámetros: esta función acepta dos parámetros, como se mencionó anteriormente y se describe a continuación:
- $índice: este parámetro contiene el índice en el que se va a insertar el elemento.
- $valor: este parámetro contiene el valor que se insertará en el índice dado en Deque.
Valor devuelto: esta función no devuelve ningún valor.
Excepción: esta función arroja una excepción OutOfRangeException si Deque está vacío.
Los siguientes programas ilustran la función Ds\Deque::insert() en PHP:
Programa 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);
?>
Producción:
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
)
Programa 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);
?>
Producción:
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
)
Referencia: http://php.net/manual/en/ds-deque.insert.php