array_slice

(PHP 4, PHP 5, PHP 7)

array_slice — Extrait une portion de tableau

Description

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

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érie commencera à cet offset dans le tableau array. Si offset est négatif, cette série commencera à l'offset offset, mais en commençant à la fin du tableau array. Notez que l'offset indique la position dans le tableau, pas la clé.
length: Si length est fourni et positif, alors la série retournée aura autant d'éléments. Si le tableau est moins long que length, alors seuls les éléments de tableaux disponibles seront présents. Si length est fourni et négatif, alors la série contiendra les éléments depuis l'offset offset jusqu'à length éléments en partant de la fin. Si length est omis, la séquence lira tous les éléments du tableau, depuis l'offset précisé jusqu'à la fin du tableau.
preserve_keys: Notez que, par défaut, la fonction array_slice() va réordonner et réinitialiser les indices entier du tableau. Vous pouvez modifier ce comportement en définissant le paramètre preserve_keys à TRUE. Les clés de chaîne sont toujours conservées, quel que soit ce paramètre.

Valeurs de retour

Retourne la portion du tableau. Si l'offset est plus grand que la taille du tableau, alors la fonction retourne un tableau vide

Historique

Version	Description
5.2.4	La valeur par défaut du paramètre `length` a changé en la valeur NULL. Une longeur de valeur NULL démande désormais à la fonction d'utiliser la longeur du tableau `array`. Avant cette version, une longeur de valeur 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

array_splice() - Efface et remplace une portion de tableau
unset() - Détruit une variable
array_chunk() - Sépare un tableau en tableaux de taille inférieure

Rechercher une fonction PHP

Version en cache

25/11/2024 02:02:21 Cette version de la page est en cache (à la date du 25/11/2024 02:02:21) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.array-slice.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut