Les tableaux

Introduction

Ces fonctions permettent de travailler et de manipuler les tableaux de plusieurs façons. Les tableaux sont essentiels pour le stockage, la gestion et les opérations sur des jeux de variables.

Les tableaux simples et multidimensionnels sont supportĂ©s, et peuvent ĂȘtre créés soit par l'utilisateur, soit par une fonction. Il existe des fonctions spĂ©cifiques aux bases de donnĂ©es permettant de remplir des tableaux depuis des requĂȘtes Ă  la base de donnĂ©es, mais aussi des fonctions retournant des tableaux.

Se reporter à la section sur les tableaux de ce manuel pour une explication détaillée sur la façon dont les tableaux sont implémentés et utilisés en PHP. Consulter également les opérateurs sur les tableaux afin de voir d'autres façons de manipuler les tableaux.

  • Constantes prĂ©-dĂ©finies
  • Tri des tableaux
  • Fonctions sur les tableaux
    • array — CrĂ©e un tableau
    • array_all — VĂ©rifie si tous les Ă©lĂ©ments du tableau valident la fonction de rappel
    • array_any — VĂ©rifie qu'au moins un Ă©lĂ©ment du tableau valide la fonction de rappel
    • array_change_key_case — Change la casse de toutes les clĂ©s d'un tableau
    • array_chunk — SĂ©pare un tableau en tableaux de taille infĂ©rieure
    • array_column — Retourne les valeurs d'une colonne d'un tableau d'entrĂ©e
    • array_combine — CrĂ©e un tableau Ă  partir de deux autres tableaux
    • array_count_values — Compte les occurrences de chaque valeur distincte dans un tableau
    • array_diff — Calcule la diffĂ©rence entre des tableaux
    • array_diff_assoc — Calcule la diffĂ©rence de deux tableaux, en prenant aussi en compte les clĂ©s
    • array_diff_key — Calcule la diffĂ©rence de deux tableaux en utilisant les clĂ©s pour comparaison
    • array_diff_uassoc — Calcule la diffĂ©rence entre deux tableaux associatifs, Ă  l'aide d'une fonction de rappel
    • array_diff_ukey — Calcule la diffĂ©rence entre deux tableaux en utilisant une fonction de rappel sur les clĂ©s pour comparaison
    • array_fill — Remplit un tableau avec une mĂȘme valeur
    • array_fill_keys — Remplit un tableau avec des valeurs, en spĂ©cifiant les clĂ©s
    • array_filter — Filtre les Ă©lĂ©ments d'un tableau grĂące Ă  une fonction de rappel
    • array_find — Retourne le premier Ă©lĂ©ment validant la fonction de rappel
    • array_find_key — Retourne la clĂ© du premier Ă©lĂ©ment validant la fonction de rappel
    • array_first — Renvoie la premiĂšre valeur d'un tableau
    • array_flip — Remplace les clĂ©s par les valeurs, et les valeurs par les clĂ©s
    • array_intersect — Calcule l'intersection de tableaux
    • array_intersect_assoc — Calcule l'intersection de deux tableaux avec des tests sur les index
    • array_intersect_key — Calcule l'intersection de deux tableaux en utilisant les clĂ©s pour comparaison
    • array_intersect_uassoc — Calcule l'intersection de deux tableaux avec des tests sur les index, compare les index en utilisant une fonction de rappel
    • array_intersect_ukey — Calcule l'intersection de deux tableaux en utilisant une fonction de rappel sur les clĂ©s pour comparaison
    • array_is_list — VĂ©rifie si un array donnĂ© est une liste
    • array_key_exists — VĂ©rifie si une clĂ© existe dans un tableau
    • array_key_first — RĂ©cupĂšre la premiĂšre clĂ© d'un tableau
    • array_key_last — RĂ©cupĂšre la derniĂšre clĂ© d'un tableau
    • array_keys — Retourne toutes les clĂ©s ou un ensemble des clĂ©s d'un tableau
    • array_last — Renvoie la derniĂšre valeur d'un tableau
    • array_map — Applique une fonction sur les Ă©lĂ©ments d'un tableau
    • array_merge — Fusionne plusieurs tableaux en un seul
    • array_merge_recursive — Combine un ou plusieurs tableaux ensemble, rĂ©cursivement
    • array_multisort — Trie les tableaux multidimensionnels
    • array_pad — ComplĂšte un tableau avec une valeur jusqu'Ă  la longueur spĂ©cifiĂ©e
    • array_pop — DĂ©pile un Ă©lĂ©ment de la fin d'un tableau
    • array_product — Calcule le produit des valeurs du tableau
    • array_push — Empile un ou plusieurs Ă©lĂ©ments Ă  la fin d'un tableau
    • array_rand — Prend une ou plusieurs clĂ©s, au hasard dans un tableau
    • array_reduce — RĂ©duit itĂ©rativement un tableau
    • array_replace — Remplace les Ă©lĂ©ments d'un tableau par ceux d'autres tableaux
    • array_replace_recursive — Remplace rĂ©cursivement dans le premier tableau les Ă©lĂ©ments des autres tableaux fournis
    • array_reverse — Inverse l'ordre des Ă©lĂ©ments d'un tableau
    • array_search — Recherche dans un tableau la premiĂšre clĂ© associĂ©e Ă  la valeur
    • array_shift — DĂ©pile un Ă©lĂ©ment au dĂ©but d'un tableau
    • array_slice — Extrait une portion de tableau
    • array_splice — Efface et remplace une portion de tableau
    • array_sum — Calcule la somme des valeurs du tableau
    • array_udiff — Calcule la diffĂ©rence entre deux tableaux en utilisant une fonction de rappel
    • array_udiff_assoc — Calcule la diffĂ©rence entre des tableaux avec vĂ©rification des index, compare les donnĂ©es avec une fonction de rappel
    • array_udiff_uassoc — Calcule la diffĂ©rence de deux tableaux associatifs, compare les donnĂ©es et les index avec une fonction de rappel
    • array_uintersect — Calcule l'intersection de deux tableaux, compare les donnĂ©es en utilisant une fonction de rappel
    • array_uintersect_assoc — Calcule l'intersection de deux tableaux avec des tests sur l'index, compare les donnĂ©es en utilisant une fonction de rappel
    • array_uintersect_uassoc — Calcule l'intersection de deux tableaux avec des tests sur l'index, compare les donnĂ©es et les index des deux tableaux en utilisant une fonction de rappel sĂ©parĂ©e
    • array_unique — DĂ©doublonne un tableau
    • array_unshift — Empile un ou plusieurs Ă©lĂ©ments au dĂ©but d'un tableau
    • array_values — Retourne toutes les valeurs d'un tableau
    • array_walk — ExĂ©cute une fonction fournie par l'utilisateur sur chacun des Ă©lĂ©ments d'un tableau
    • array_walk_recursive — Applique une fonction de rappel rĂ©cursivement Ă  chaque membre d'un tableau
    • arsort — Trie un tableau en ordre dĂ©croissant et conserve l'association des index
    • asort — Trie un tableau en ordre croissant et conserve l'association des index
    • compact — CrĂ©e un tableau Ă  partir de variables et de leur valeur
    • count — Compte tous les Ă©lĂ©ments d'un tableau ou dans un objet Countable
    • current — Retourne l'Ă©lĂ©ment courant du tableau
    • each — Retourne chaque paire clĂ©/valeur d'un tableau
    • end — Positionne le pointeur de tableau en fin de tableau
    • extract — Importe les variables dans la table des symboles
    • in_array — Indique si une valeur appartient Ă  un tableau
    • key — Retourne une clĂ© d'un tableau associatif
    • key_exists — Alias de array_key_exists
    • krsort — Trie un tableau en fonction des clĂ©s en ordre dĂ©croissant
    • ksort — Trie un tableau en fonction des clĂ©s en ordre croissant
    • list — Assigne des variables comme si elles Ă©taient un tableau
    • natcasesort — Trie un tableau avec l'algorithme Ă  "ordre naturel" insensible Ă  la casse
    • natsort — Trie un tableau avec l'algorithme Ă  "ordre naturel"
    • next — Avance le pointeur interne d'un tableau
    • pos — Alias de current
    • prev — Recule le pointeur courant de tableau
    • range — CrĂ©e un tableau contenant un intervalle d'Ă©lĂ©ments
    • reset — Remet le pointeur interne de tableau au dĂ©but
    • rsort — Trie un tableau en ordre dĂ©croissant
    • shuffle — MĂ©lange les Ă©lĂ©ments d'un tableau
    • sizeof — Alias de count
    • sort — Trie un tableau en ordre croissant
    • uasort — Trie un tableau en utilisant une fonction de rappel
    • uksort — Trie un tableau par ses clĂ©s en utilisant une fonction de rappel
    • usort — Trie un tableau en utilisant une fonction de comparaison
add a note

User Contributed Notes 9 notes

up
107
applegrew at rediffmail dot com ¶
18 years ago
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";
up
24
Tyler Bannister ¶
17 years ago
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.
up
6
macnimble at gmail dot com ¶
17 years ago
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.
up
2
webmaster at infoproducts dot x10hosting dot com ¶
17 years ago
New value can also be added to the array as shown below.
$theVariable["google"] = "http//google.com";
or
$theVariable["1"] = "http//google.com";
up
2
dragos dot rusu at NOSPAM dot bytex dot ro ¶
16 years ago
If an array item is declared with key as NULL, array key will automatically be converted to empty string '', as follows:

<?php
$a = array(
    NULL => 'zero',
    1    => 'one',
    2    => 'two');

// This will show empty string for key associated with "zero" value
var_dump(array_keys($a));

// Array elements are shown
reset($a);
while( key($a) !== NULL )
{
  echo key($a) . ": ".current($a) . "<br>";// PHP_EOL
  next($a);
}

// Array elements are not shown
reset($a);
while( key($a) != NULL ) // '' == null   => no iteration will be executed
{
  echo key($a) . ": ".current($a) . "<br>";// PHP_EOL
  next($a);
}
up
0
sunear at gmail dot com ¶
16 years ago
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 ;)
up
-2
andyd273 at gmail dot com ¶
17 years ago
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);
            }
up
-4
justin at jmfrazier dot com ¶
6 years ago
Using null as the key when setting an array value is NOT the same as using empty [].
<?php
  $null = null;
  $testArray = [];
  $testArray[$null] = 1;
  $testArray[$null] = 2;
  $testArray[$null] = 3;
  $testArray[$null] = 4;
  var_dump($testArray);
?>
Output:
array(1) {
  '' =>
  int(4)
}

<?php
  $testArray = [];
  $testArray[null] = 1;
  $testArray[null] = 2;
  $testArray[null] = 3;
  $testArray[null] = 4;
  var_dump($testArray);
?>
Output:
array(1) {
  '' =>
  int(4)
}

<?php
  $testArray = [];
  $testArray[] = 1;
  $testArray[] = 2;
  $testArray[] = 3;
  $testArray[] = 4;
  var_dump($testArray);
?>
Output:
array(4) {
  [0] =>
  int(1)
  [1] =>
  int(2)
  [2] =>
  int(3)
  [3] =>
  int(4)
}
up
-4
info at curtinsNOSPAMcreations dot com ¶
15 years ago
Another way to create a multidimensional array that looks a lot cleaner is to use json_decode.  (Note that this probably adds a touch of overhead, but it sure does look nicer.)  You can of course add as many levels and as much formatting as you'd like to the string you then decode.  Don't forget that json requires " around values, not '!!  (So, you can't enclose the json string with " and use ' inside the string.)

As an example:

<?php
    $myarray['blah'] = json_decode('[
        {"label":"foo","name":"baz"},
        {"label":"boop","name":"beep"}
    ]',true);

print_r($myarray)
?>
returns:

Array
(
    [blah] => Array
        (
            [0] => Array
                (
                    [label] => foo
                    [name] => baz
                )
 
            [1] => Array
                (
                    [label] => boop
                    [name] => beep
                )
        )
)