downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

Introdução> <Variável e Extensões Relacionadas aos Tipos
Last updated: Fri, 13 Nov 2009

view this page in

Arrays

  • Introdução
  • Instalação/Configuração
  • Constantes pré-definidas
  • Funções para Array
    • array_change_key_case — Modifica todas as chaves em um array
    • array_chunk — Divide um array em pedaços
    • array_combine — Cria um array usando um array para chaves e outro para valores
    • array_count_values — Conta as frequências de cada valor de um array
    • array_diff_assoc — Computa a diferença entre arrays com checagem adicional de índice
    • array_diff_key — Registra a diferença entre arrays usando chaves para comparação
    • array_diff_uassoc — Computa a diferença entre arrays com checagem adicional de índice que é feita por uma função de callback fornecida pelo usuário
    • array_diff_ukey — Computa a diferença de arrays usando uma função callback na comparação de chaves
    • array_diff — Analisa as diferenças entre arrays
    • array_fill_keys — Preenche um array com valores, especificando chaves
    • array_fill — Preenche um array com valores
    • array_filter — Filtra os elementos da array usando uma função de callback
    • array_flip — Inverte as relações entre chaves e valores
    • array_intersect_assoc — Computa a interseção de arrays com uma adicional verificação de índice
    • array_intersect_key — Computa a interseção de array comparando pelas chaves
    • array_intersect_uassoc — Computa a interseção de arrays com checagem de índice adicional, compara índices por uma função de callback
    • array_intersect_ukey — Computa a interseção de arrays usando uma função de callback nas chaves para comparação
    • array_intersect — Calcula a interseção entre arrays
    • array_key_exists — Checa se uma chave ou índice existe em um array
    • array_keys — Retorna todas as chaves de um array
    • array_map — Aplica uma função em todos os elementos dos arrays dados
    • array_merge_recursive — Funde dois ou mais arrays recursivamente
    • array_merge — Funde um ou mais arrays
    • array_multisort — Ordena múltiplos arrays ou arrays multidimensionais
    • array_pad — Expande um array para um certo comprimento utilizando um determinado valor
    • array_pop — Retira um elemento do final do array
    • array_product — Calcula o produto dos valores de um array
    • array_push — Adiciona um ou mais elementos no final de um array
    • array_rand — Retorna um ou mais elementos aleatórios de um array
    • array_reduce — Reduz um array para um único valor através de um processo iterativo utilizando uma função
    • array_replace_recursive — Replaces elements from passed arrays into the first array recursively
    • array_replace — Replaces elements from passed arrays into the first array
    • array_reverse — Retorna um array com os elementos na ordem inversa
    • array_search — Procura por um valor em um array e retorna sua chave correspondente caso seja encontrado
    • array_shift — Retira o primeiro elemento de um array
    • array_slice — Extrai uma parcela de um array
    • array_splice — Remove uma parcela do array e substitui com outros elementos
    • array_sum — Calcula a soma dos elementos de um array
    • array_udiff_assoc — Computa a diferença entre arrays com checagem adicional de índice, compara dados por uma função de callback
    • array_udiff_uassoc — Computa a diferença entre arrays com checagem adicional de índice, compara dados e índices por uma função de callback
    • array_udiff — Computa a diferença de arrays usando uma função de callback para comparação dos dados
    • array_uintersect_assoc — Computa a interseção de arrays com checagem adicional de índice, compara os dados utilizando uma função de callback
    • array_uintersect_uassoc — Computa a interseção de arrays com checagem adicional de índice, compara os dados e os índices utilizando funções de callback
    • array_uintersect — Computa a interseção de array, comparando dados com uma função callback
    • array_unique — Remove o valores duplicados de um array
    • array_unshift — Adiciona um ou mais elementos no início de um array
    • array_values — Retorna todos os valores de um array
    • array_walk_recursive — Aplica um função do usuário recursivamente para cada membro de um array
    • array_walk — Aplica uma determinada funcão em cada elemento de um array
    • array — Cria um array
    • arsort — Ordena um array em ordem descrescente mantendo a associação entre índices e valores
    • asort — Ordena um array mantendo a associação entre índices e valores
    • compact — Cria um array contendo variáveis e seus valores
    • count — Conta o número de elementos de uma variável, ou propriedades de um objeto
    • current — Retorna o elemento corrente em um array
    • each — Retorna o par chave/valor corrente de um array e avança o seu cursor
    • end — Faz o ponteiro interno de um array apontar para o seu último elemento
    • extract — Importa variáveis para a tabela de símbolos a partir de um array
    • in_array — Checa se um valor existe em um array
    • key — Retorna uma chave de um array
    • krsort — Ordena um array pelas chaves em ordem descrescente
    • ksort — Ordena um array pelas chaves
    • list — Cria variáveis como se fossem arrays
    • natcasesort — Ordena um array utilizando o algoritmo da "ordem natural" sem diferenciar maiúsculas e minúsculas
    • natsort — Ordena um array utilizando o algoritmo da "ordem natural"
    • next — Avança o ponteiro interno de um array
    • pos — Sinônimo de current
    • prev — Retrocede o ponteiro interno de um array
    • range — Cria um array contendo uma faixa de elementos
    • reset — Faz o ponteiro interno de um array apontar para o seu primeiro elemento
    • rsort — Ordena um array em ordem descrescente
    • shuffle — Mistura os elementos de um array
    • sizeof — Sinônimo de count
    • sort — Ordena um array
    • uasort — Ordena um array utilizando uma função de comparação definida pelo usuário e mantendo as associações entre chaves e valores
    • uksort — Ordena um array pelas chaves utilizando uma função de comparação definida pelo usuário.
    • usort — Ordena um array pelos valores utilizando uma função de comparação definida pelo usuário


add a note add a note User Contributed Notes
Arrays
sunear at gmail dot com
04-Aug-2009 05:45
Made this function to delete elements in an array;

<?php

function array_del_elm($input_array, $del_indexes) {
    if (
is_array($del_indexes)) {
       
$indexes = $del_indexes;
    } elseif(
is_string($del_indexes)) {
       
$indexes = explode($del_indexes, " ");
    } elseif(
is_numeric($del_indexes)) {
       
$indexes[0] = (integer)$del_indexes;
    } else return;
   
$del_indexes = null;
   
   
$cur_index = 0;
    if (
sort($indexes)) for($i=0; $i<count($input_array); $i++) {
        if (
$i == $indexes[$cur_index]) {
           
$cur_index++;
            if (
$cur_index == count($indexes)) return $output_array;
            continue;
        }
       
$output_array[] = $input_array[$i];
    }
    return
$output_array;
}

?>

but then i saw the methods of doing the same by Tyler Bannister & Paul, could see that theirs were faster, but had floors regarding deleting multiple elements thus support of several ways of giving parameters. I combined the two methods to this to this:

<?php

function array_del_elm($target_array, $del_indexes) {
    if (
is_array($del_indexes)) {
       
$indexes = $del_indexes;
    } elseif(
is_string($del_indexes)) {
       
$indexes = explode($del_indexes, " ");
    } elseif(
is_numeric($del_indexes)) {
       
$indexes[0] = (integer)$del_indexes;
    } else return;
    unset(
$del_indexes);
   
    for(
$i=0; $i<count($indexes); $i++) {
        unset(
$target_array[$indexes[$i]]);
    }
    return
$target_array;
}

?>

Fast, compliant and functional ;)
Tyler Bannister
11-Jun-2009 01:59
To delete an individual array element use the unset function

For example:

<?PHP
    $arr
= array( "A", "B", "C" );
    unset(
$arr[1] );
   
// now $arr = array( "A", "C" );
?>

Unlink is for deleting files.
Paul
21-May-2009 09:05
To delete an individual array element use the unlink function

For example:

<?PHP
    $arr
= array( "A", "B", "C" );
   
unlink( $arr[1] );
   
// now $arr = array( "A", "C" );
?>
thomasdecaux at ebuildy dot com
15-May-2009 08:14
To browse a simple array:

<?php

foreach ($myArray AS $myItem)
{

}

?>

To browse an associative array:

<?php

foreach ($myArray AS $key=>$value)
{

}

?>

http://www.ebuildy.com
macnimble at gmail dot com
27-Mar-2009 02:59
Converting a linear array (like a mysql record set) into a tree, or multi-dimensional array can be a real bugbear. Capitalizing on references in PHP, we can 'stack' an array in one pass, using one loop, like this:

<?php
# array_stack()
# Original idea from:
# http://www.ideashower.com/our_solutions/
#   create-a-parent-child-array-structure-in-one-pass/
function array_stack (&$a, $p = '@parent', $c = '@children')
{
 
$l = $t = array();
  foreach (
$a AS $key => $val):
    if (!
$val[$p]) $t[$key] =& $l[$key];
    else
$l[$val[$p]][$c][$key] =& $l[$key];
   
$l[$key] = (array)$l[$key] + $val;
  endforeach;
  return
$a = array('tree' => $t, 'leaf' => $l);
}

# Example:
$node = array();
$node[1] = array('@parent' => 0, 'title' => 'I am node 1.');
#     ^-----------------------v Link @parent value to key.
$node[2] = array('@parent' => 1, 'title' => 'I am node 2.');
$node[3] = array('@parent' => 2, 'title' => 'I am node 3.');
$node[4] = array('@parent' => 1, 'title' => 'I am node 4.');
$node[5] = array('@parent' => 4, 'title' => 'I am node 5.');

array_stack($node);

$node['leaf'][1]['title'] = 'I am node one.';
$node['leaf'][2]['title'] = 'I am node two.';
$node['leaf'][3]['title'] = 'I am node three.';
$node['leaf'][4]['title'] = 'I am node four.';
$node['leaf'][5]['title'] = 'I am node five.';

echo
'<pre>',print_r($node['tree'],TRUE),'</pre>';
?>

Note that there's no parameter checking on the array value, but this is only to keep the function size small. One could easily a quick check in there to make sure the $a parameter was in fact an array.

Hope you find it useful. Huge thanks to Nate Weiner of IdeaShower.com for providing the original function I built on.
andyd273 at gmail dot com
24-Feb-2009 09:12
A small correction to Endel Dreyer's PHP array to javascript array function. I just changed it to show keys correctly:

            function array2js($array,$show_keys)
            {
                $dimensoes = array();
                $valores = array();
              
                $total = count ($array)-1;
                $i=0;
                foreach($array as $key=>$value){
                    if (is_array($value)) {
                        $dimensoes[$i] = array2js($value,$show_keys);
                        if ($show_keys) $dimensoes[$i] = '"'.$key.'":'.$dimensoes[$i];
                    } else {
                        $dimensoes[$i] = '"'.addslashes($value).'"';
                        if ($show_keys) $dimensoes[$i] = '"'.$key.'":'.$dimensoes[$i];
                    }
                    if ($i==0) $dimensoes[$i] = '{'.$dimensoes[$i];
                    if ($i==$total) $dimensoes[$i].= '}';
                    $i++;
                }
                return implode(',',$dimensoes);
            }
Endel Dreyer
20-Jan-2009 12:16
Function to convert PHP arrays to JavaScript Array Object:
Useful in some cases.

<?php
function array2js($array,$show_keys=false)
{
   
$dimensoes = array();
   
$valores = array();
   
   
$total = count ($array)-1;
   
$i=0;
    foreach (
$array as $key => $value) {
        if (
is_array($value)) {
           
$dimensoes[$i] = array2js($value,$show_keys);
        } else {
           
$dimensoes[$i] = '"'.addslashes($value).'"';
            if (
$show_keys) '"'.$key.'":'.$dimensoes[$i];
        }
        if (
$i==0) $dimensoes[$i] = '['.$dimensoes[$i];
        if (
$i==$total) $dimensoes[$i].= ']';
       
$i++;
    }
    return
implode(',',$dimensoes);
}
?>
Anonymous
26-Nov-2008 06:36
@jorge at andrade dot cl
This variant is faster:
<?php
function array_avg($array,$precision=2){
    if(!
is_array($array))
        return
'ERROR in function array_avg(): this is a not array';

    foreach(
$array as $value)
        if(!
is_numeric($value))
            return
'ERROR in function array_avg(): the array contains one or more non-numeric values';
   
   
$cuantos=count($array);
  return
round(array_sum($array)/$cuantos,$precision);
}
?>
jorge at andrade dot cl
12-Nov-2008 08:03
To calculate the average of a array

<?php
function array_avg($array,$precision="2"){
   
$a=0;
    if(
is_array($array)){
        foreach(
$array as $value):
            if(!
is_numeric($value)){
               
$a++;
            }
        endforeach;
        if(
$a==0){
           
$cuantos=count($array);
            return
round(array_sum($array)/$cuantos,$precision);
        }else{
            return
"ERROR in function array_avg(): the array contains one or more non-numeric values";
        }       
    }else{
        return
"ERROR in function array_avg(): this is a not array";
    }
}
?>
alan dot lake at lakeinfoworks dot com
22-Oct-2008 03:46
To delete an array key (and its value) from an array:

<?php
   
function array_delete(&$ary,$key_to_be_deleted)
    {
       
$new = array();
        if(
is_string($key_to_be_deleted)) {
            if(!
array_key_exists($key_to_be_deleted,$ary)) {
                return;
            }
            foreach(
$ary as $key => $value) {
                if(
$key != $key_to_be_deleted) {
                   
$new[$key] = $value;
                }
            }
           
$ary = $new;
        }
        if(
is_array($key_to_be_deleted)) {
            foreach(
$key_to_be_deleted as $del) {
               
array_delete(&$ary,$del);
            }
        }
    }
?>
webmaster at infoproducts dot x10hosting dot com
11-Oct-2008 02:13
New value can also be added to the array as shown below.
$theVariable["google"] = "http//google.com";
or
$theVariable["1"] = "http//google.com";
Jack A
07-Oct-2008 03:14
Note that arrays are not allowed in class constants and trying to do so will throw a fatal error.
contact at greyphoenix dot biz
01-Jul-2008 04:36
<?php
//Creating a multidimensional array

$theVariable = array("Search Engines" =>
array (
   
0=> "http//google.com",
   
1=> "http//yahoo.com",
   
2=> "http//msn.com/"),

"Social Networking Sites" =>
array (
   
0 => "http//www.facebook.com",
   
1 => "http//www.myspace.com",
   
2 => "http//vkontakte.ru",)
);

echo
"The first array value is " . $theVariable['Search Engines'][0];
?>

-- Output--
The first array value is http://google.com
applegrew at rediffmail dot com
28-May-2008 03:23
For newbies like me.

Creating new arrays:-
//Creates a blank array.
$theVariable = array();

//Creates an array with elements.
$theVariable = array("A", "B", "C");

//Creating Associaive array.
$theVariable = array(1 => "http//google.com", 2=> "http://yahoo.com");

//Creating Associaive array with named keys
$theVariable = array("google" => "http//google.com", "yahoo"=> "http://yahoo.com");

Note:
New value can be added to the array as shown below.
$theVariable[] = "D";
$theVariable[] = "E";

 
show source | credits | stats | sitemap | contact | advertising | mirror sites