echo
fprintf
Fonctions sur les chaînes de caractères
PHP Manual

# explode

(PHP 4, PHP 5)

explode — Coupe une chaîne en segments

### Description

array explode ( string `$delimiter` , string `$string` [, int `$limit` ] )

Retourne un tableau de chaînes, chacune d'elle étant une sous-chaîne du paramètre `string` extraite en utilisant le séparateur `delimiter` .

### Liste de paramètres

`delimiter`

  Le séparateur.

`string`

  La chaîne initiale.

`limit`

  Si `limit` est défini, le tableau retourné contiendra, au maximum, `limit` éléments, dont le dernier élément contiendra le reste de la chaîne.

  Si le paramètre `limit` est négatif, tous les éléments, excepté les -`limit` derniers éléments sont retournés.

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 `delimiter` soit placé avant le paramètre `string` .

### Valeurs de retour

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

### Historique

Version | Description
--- | ---
5.1.0 | Le paramètre `limit` peut désormais être négatif
4.0.1 | Le paramètre `limit` a été ajouté

### Exemples

Exemple #1 Exemple avec explode()

`<?php
// Exemple 1
$pizza = "piece1 piece2 piece3 piece4 piece5 piece6";
$pieces = explode(" ", $pizza);
echo $pieces[0]; // piece1
echo $pieces[1]; // piece2
// 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 = 'one|two|three|four';
// limit positif
print_r(explode('|', $str, 2));
// limit négatif (depuis PHP 5.1)
print_r(explode('|', $str, -1));
?>`

L'exemple ci-dessus va afficher :

    Array
    (
        [0] => one
        [1] => two|three|four
    )
    Array
    (
        [0] => one
        [1] => two
        [2] => three
    )

### Notes

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

### Voir aussi

- preg_split()
- str_split()
- str_word_count()
- strtok()
- implode()

echo
fprintf
Fonctions sur les chaînes de caractères
PHP Manual