Função PHP array_unshift()
Exemplo
Insira o elemento "blue" em um array:
<?php
$a=array("a"=>"red","b"=>"green");
array_unshift($a,"blue");
print_r($a);
?>
Definição e uso
A função array_unshift() insere novos elementos em um array. Os novos valores do array serão inseridos no início do array.
Dica: Você pode adicionar um valor ou quantos desejar.
Nota: As chaves numéricas começarão em 0 e aumentarão em 1. As chaves de string permanecerão as mesmas.
Sintaxe
array_unshift(array, value1, value2, value3, ...)
Valores de parâmetro
Parameter | Description |
---|---|
array | Required. Specifying an array |
value1 | Optional. Specifies a value to insert (Required in PHP versions before 7.3) |
value2 | Optional. Specifies a value to insert |
value3 | Optional. Specifies a value to insert |
Detalhes técnicos
Valor de retorno: | Retorna o novo número de elementos na matriz |
---|---|
Versão do PHP: | 4+ |
Registro de alterações do PHP: | PHP 7.3: Esta função agora pode ser chamada apenas com o parâmetro array |
Mais exemplos
Exemplo
Mostre o valor de retorno:
<?php
$a=array("a"=>"red","b"=>"green");
print_r(array_unshift($a,"blue"));
?>
Exemplo
Usando teclas numéricas:
<?php
$a=array(0=>"red",1=>"green");
array_unshift($a,"blue");
print_r($a);
?>
❮ Referência de array PHP