Manuel PHP
Précédent |  | Suivant

# strtok

(PHP 3, PHP 4, PHP 5)

strtok -- Coupe une chaîne en segments

## Description

string strtok ( string str, string token )

strtok() coupe la chaîne `str` en segment, chaque segment étant délimité par `token`. Par exemple, si vous avez une chaîne telle que `"Voici un bon exemple"`, vous pouvez en extraire les différents mots en utilisant cette fonction :

Exemple 1. Exemple avec strtok()

`<?php $string = "Ceci est\tun bon\nexemple"; // Utilisez aussi les nouvelles lignes et les tabulations // comme séparateur de mots $tok = strtok($string," \n\t"); while ($tok !== false) { echo "Mot = $tok<br />"; $tok = strtok(" \n\t"); } ?>`

Notez que seul le premier appel à strtok() nécessite les deux arguments. Tous les appels ultérieurs à strtok() ne nécessitent que le délimiteur. Pour initialiser à nouveau strtok(), ou pour recommencer, fournissez à nouveau le paramètre `str`. La chaîne `str` sera découpée dès que l'un des caractères de `token` est trouvé.

Le comportement de cette fonction avec la chaîne vide a changé depuis PHP 4.1.0. L'ancien comportement était de retourner une chaîne vide, tandis que le nouveau comportement, plus correct, retourne `FALSE`

Exemple 2. Ancien comportement de strtok()

`<?php $first_token = strtok('/chose', '/'); $second_token = strtok('/'); var_dump($first_token, $second_token); ?>`

L'exemple ci-dessus va afficher :

    string(0) ""
    string(9) "chose"

Exemple 3. Nouveau comportement de strtok()

`<?php $first_token = strtok('/chose', '/'); $second_token = strtok('/'); var_dump($first_token, $second_token); ?>`

L'exemple ci-dessus va afficher :

    string(9) "chose"
    bool(false)

Avertissement
Cette fonction peut retourner `FALSE`, mais elle peut aussi retourner une valeur équivalent à `FALSE`, utilisable dans une condition if simple. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

Voir aussi split() et explode().

Précédent | Sommaire | Suivant
strstr | Niveau supérieur | strtolower