Insere valores em um índice específico

# Ds\Sequence::insert

(PECL ds >= 1.0.0)

Ds\Sequence::insert — Insere valores em um índice específico

### Descrição

abstract public function Ds\Sequence::insert(int `$index`, mixed `...$values`): void

Insere valores na sequência em um índice específico.

### Parâmetros

`index`

  O índice no qual o valor será inserido. `0 <= index <= count`

  > Nota:

  > Pode-se inserir no índice igual ao número de valores.

`values`

  O valor ou valores a serem inseridos.

### Valor Retornado

Nenhum valor é retornado.

### Erros/Exceções

OutOfRangeException se o índice não for válido.

### Exemplos

Exemplo #1 Exemplo de Ds\Sequence::insert()

    <?php
    $sequence = new \Ds\Vector();

    $sequence->insert(0, "e");             // [e]
    $sequence->insert(1, "f");             // [e, f]
    $sequence->insert(2, "g");             // [e, f, g]
    $sequence->insert(0, "a", "b");        // [a, b, e, f, g]
    $sequence->insert(2, ...["c", "d"]);   // [a, b, c, d, e, f, g]

    var_dump($sequence);
    ?>

O exemplo acima produzirá algo semelhante a:

    object(Ds\Vector)#1 (7) {
      [0]=>
      string(1) "a"
      [1]=>
      string(1) "b"
      [2]=>
      string(1) "c"
      [3]=>
      string(1) "d"
      [4]=>
      string(1) "e"
      [5]=>
      string(1) "f"
      [6]=>
      string(1) "g"
    }

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open