Manuel PHP
Précédent |  | Suivant

# explode

(PHP 3, PHP 4, PHP 5)

explode -- Coupe une chaîne en segments

## Description

array explode ( string separator, string string [, int limit] )

`explode` retourne un tableau de chaînes. Ce sont les sous-chaînes extraites de string, en utilisant le séparateur separator. Si limit est fourni, le tableau retourné aura un maximum de limit éléments, et le dernier élément du tableau contiendra le reste de la chaîne string.

Si separator est une chaîne vide (""), explode() retournera `FALSE`. Si separator contient une valeur qui n'est pas contenue dans string, alors explode() retournera un tableau, contenant la chaîne string entière.

Si le paramètre limit a une valeur négative, tous les éléments exceptés le dernier limit sont retournés. Cette fonctionalité a été ajoutée depuis PHP 5.1.0.

Bien que implode() puisse, pour des raisons historiques, accepter ces paramètres dans n'importe quel ordre, explode() ne le peut pas. Vous devez vous assurer que le paramètre separator soit placé avant le paramètre string.

> Note : Le paramètre limit a été ajouté en PHP 4.0.1.

Exemple 1. Exemple avec explode()

`<?php // Exemple 1 $pizza = "pièce1 pièce2 pièce3 pièce4 pièce5 pièce6"; $pieces = explode(" ", $pizza); echo $pieces[0]; // pièce1 echo $pieces[1]; // pièce2 // Exemple 2 $data = "foo:*:1023:1000::/home/foo:/bin/sh"; list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data); echo $user; // foo echo $pass; // * ?>`

Exemple 2. Exemple avec le paramètre limit

`<?php $str = 'un|deux|trois|quatre'; // limite positive print_r(explode('|', $str, 2)); // limite négative (depuis PHP 5.1) print_r(explode('|', $str, -1)); ?>`

L'exemple ci-dessus va afficher :

    Array
    (
        [0] => un
        [1] => deux|trois|quatre
    )
    Array
    (
        [0] => un
        [1] => deux
        [2] => trois
    )

> Note : Cette fonction gère les chaînes binaires.

Voir aussi preg_split(), spliti(), split(), strtok(), et implode().

Précédent | Sommaire | Suivant
echo | Niveau supérieur | fprintf