Função PHP array ()

Definição e Uso

o array()função é usada para criar um array PHP. Esta função pode ser usada para criar arrays indexados ou arrays associativos. As matrizes de PHP podem ser unidimensionais ou multidimensionais.

Sintaxe

Sintaxe para criar matrizes indexadas em PHP:

$a = array(value1, value2, value3, ...)

Sintaxe para criar matrizes associativas PHP:

$a = array(key1 => value1, key2 => value2...)

Parâmetros

Sr. Não Parâmetro e Descrição
1

key(Optional)

Ele especifica a chave, do tipo numérico ou string. Se não for definido, uma chave inteira é gerada, começando em 0

2

value(Required)

Especifica o valor

Valores Retornados

Esta função retorna uma matriz de parâmetros.

Versão PHP

Esta função foi introduzida pela primeira vez como parte do núcleo do PHP 4.0.0.

Exemplo

O exemplo a seguir cria uma matriz PHP vazia:

<?php
   $abc = array();
   print_r($abc);
?>

Isso produzirá o seguinte resultado -

Array ()

Exemplo

O exemplo a seguir cria uma matriz indexada de PHP com alguns elementos:

<?php
   $abc = array("A", "B", "C");
   print_r($abc);
?>

Isso produzirá o seguinte resultado -

Array
(
    [0] => A
    [1] => B
    [2] => C
)

Exemplo

O exemplo a seguir cria uma matriz associativa PHP com números como chaves:

<?php
   $abc = array(1 => "One", 2 => "Two", 3 => "Three");
   print_r($abc);
?>

Isso produzirá o seguinte resultado -

Array
(
    [1] => One
    [2] => Two
    [3] => Three
)

Exemplo

O exemplo a seguir cria uma matriz associativa PHP com string como chaves:

<?php
   $abc = array("one" => "One", "two" => "Two", "three" => "Three");
   print_r($abc);
?>

Isso produzirá o seguinte resultado -

Array
(
    [one] => One
    [two] => Two
    [three] => Three
)

Exemplo

O exemplo a seguir mostra como adicionar mais valores em uma matriz PHP existente:

<?php
   $abc = array(1 => "One", 2 => "Two", 3 => "Three");
   print_r($abc);
   
   /* Add two more value in above array */
   $abc[4] = "Four";
   $abc[5] = "Five";
   print_r($abc);
?>

Isso produzirá o seguinte resultado -

Array
(
    [1] => One
    [2] => Two
    [3] => Three
)

Array
(
    [1] => One
    [2] => Two
    [3] => Three
    [4] => Four
    [5] => Five
)

Exemplo

O exemplo a seguir demonstra como criar uma matriz bidimensional, como especificar chaves para matrizes associativas e como pular e continuar índices numéricos em matrizes normais.

<?php
   $fruits = array (
      "fruits"  => array("a" => "orange", "b" => "banana", "c" => "apple"),
      "numbers" => array(1, 2, 3, 4, 5, 6),
      "holes" => array("first", 5 => "second", "third")
   );
   print_r($fruits);
?>

Isso produzirá o seguinte resultado -

Array
(
    [fruits] => Array
        (
            [a] => orange
            [b] => banana
            [c] => apple
        )

    [numbers] => Array
        (
            [0] => 1
            [1] => 2
            [2] => 3
            [3] => 4
            [4] => 5
            [5] => 6
        )

    [holes] => Array
        (
            [0] => first
            [5] => second
            [6] => third
        )

)

Exemplo

Para excluir um elemento individual da matriz ou matriz completa, você pode usar o unset()função:

<?php
   $abc = array(1 => "One", 2 => "Two", 3 => "Three");
   print_r($abc);

   /* Now let's delete element with index 2*/
   unset( $abc[2] );
   print_r($abc);
   
   /* Now let's delete complete array */
   unset($abc);
   print_r($abc);
?>

Isso produzirá o seguinte resultado -

Array
(
    [1] => One
    [2] => Two
    [3] => Three
)

Array
(
    [1] => One
    [3] => Three
)

PHP Notice:  Undefined variable: abc in main.php on line 13