strtok

(PHP 4, PHP 5)

strtok — Coupe une chaîne en segments

Description

string strtok ( string $str , string $token )

string strtok ( string $token )

strtok() coupe la chaîne str en segments, 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.

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é.

Liste de paramètres

str: La chaîne que l'on doit couper en plusieurs chaînes de tailles plus petites.
token: Le délimiteur utilisé lors de la découpe.

Valeurs de retour

Une chaîne coupée.

Exemples

Exemple #1 Exemple avec strtok()

<?php
$string = "This is\tan example\nstring";
// Utilisez aussi les nouvelles lignes et les tabulations 
// comme séparateur de mots
$tok = strtok($string, " \n\t");

while ($tok !== false) {
	echo "Word=$tok<br />";
	$tok = strtok(" \n\t");
}
?>

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('/something', '/');
$second_token = strtok('/');
var_dump($first_token, $second_token);
?>

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

L'exemple ci-dessus va afficher :

    string(9) "something"
    bool(false)

Notes

Avertissement

Cette fonction peut retourner FALSE, mais elle peut aussi retourner une valeur équivalent à FALSE. Veuillez lire la section sur les booléens pour plus d'informations. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

Voir aussi

split() - Scinde une chaîne en un tableau, grâce à une expression rationnelle
explode() - Coupe une chaîne en segments

strstr

Fonctions sur les chaînes de caractères

strtolower

Manuel PHP