Devenir Membre

PHP

Communauté

Divers

Manuels

Annonces

Manuel PHP

strtok

(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 :

Example#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

Example#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"

Example#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)

Warning

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().

Remonter