array_slice

(PHP 4, PHP 5, PHP 7)

array_slice — Extrait une portion de tableau

Description

array_slice ( array $array , int $offset [, int $length = NULL [, bool $preserve_keys = FALSE ]] ) : array

array_slice() retourne une série d'éléments du tableau array commençant à l'offset offset et représentant length éléments.

Liste de paramètres

array

Le tableau d'entrée.

offset

Si offset est non-négatif, la séquence commencera à cette position dans le tableau array.

Si offset est négatif, la séquence commencera à la position offset, mais en commençant à la fin du tableau array.

Note:

Le paramètre offset indique la position dans le tableau, pas la clé.

length

Si length est fourni et positif, alors la séquence aura jusqu'à autant d'éléments.

Si le tableau plus court que length, alors seuls les éléments du tableau disponible seront présents.

Si length est fourni et négatif, alors la séquence contiendra autant d'éléments de la fin du tableau.

Si il est omis, la séquence aura tout depuis la position offset jusqu'à la fin de array.

preserve_keys

Note:

Par défaut array_slice() réordonnera et réinitialisera les indices entier du tableau. Ce comportement peut être modifié en définissant le paramètre preserve_keys à TRUE. Les clés sous forme de chaîne de caractères sont toujours conservées, indépendamment de ce paramètre.

Valeurs de retour

Retourne la portion du tableau. Si la position est plus grande que la taille du tableau, un tableau vide est retourné.

Historique

Version Description
5.2.4 La valeur par défaut du paramètre length a été modifié à NULL. Une longeur length NULL démande désormais à la fonction d'utiliser la longeur du tableau array. Antérieur à cette version, une longeur length NULL signifiait une longueur égale à zéro (rien n'était retourné).
5.0.2 Le paramètre optionnel preserve_keys a été ajouté.

Exemples

Exemple #1 Exemple avec array_slice()

<?php
$input = array("a", "b", "c", "d", "e");

$output = array_slice($input, 2);         // retourne "c", "d", et "e"
$output = array_slice($input, -2, 1);     // retourne "d"
$output = array_slice($input, 0, 3);      // retourne "a", "b", et "c"

// notez les clés d'index différentes
print_r(array_slice($input, 2, -1));
print_r(array_slice($input, 2, -1, true));
?>

L'exemple ci-dessus va afficher :

Array
(
    [0] => c
    [1] => d
)
Array
(
    [2] => c
    [3] => d
)

Exemple #2 array_slice() et basé sur un tableau

<?php
$input = array(1 => "a", "b", "c", "d", "e");
print_r(array_slice($input, 1, 2));
?>

L'exemple ci-dessus va afficher :

Array
(
    [0] => b
    [1] => c
)

Exemple #3 array_slice() et tableau avec des clés mixtes

<?php
$ar = array('a'=>'apple', 'b'=>'banana', '42'=>'pear', 'd'=>'orange');
print_r(array_slice($ar, 0, 3));
print_r(array_slice($ar, 0, 3, true));
?>

L'exemple ci-dessus va afficher :

Array
(
    [a] => apple
    [b] => banana
    [0] => pear
)
Array
(
    [a] => apple
    [b] => banana
    [42] => pear
)

Voir aussi