(PHP 4, PHP 5, PHP 7, PHP 8)
ucwords — Met en majuscule la première lettre de tous les mots
$string
, string $separators
= " \t\r\n\f\v"): string
Retourne la chaîne string
après avoir mis en
majuscule la première lettre de tous les mots, si ce caractère est
alphabétique.
Dans le contexte de cette fonction, un mot est toute séquence de caractères
qui ne sont pas listés dans le paramètre separators
.
Par défaut, ce sont : une espace, un saut à la ligne, une nouvelle ligne,
un retour à la ligne, un saut de page, une tabulation horizontale, et une tabulation verticale.
string
La chaîne d'entrée.
separators
Le paramètre optionnel separators
contient le caractère
de séparation.
Retourne la chaîne, après modification.
Exemple #1 Exemple avec ucwords()
<?php
$foo = 'bonjour tout le monde!';
$foo = ucwords($foo); // Bonjour Tout Le Monde!
$bar = 'BONJOUR TOUT LE MONDE!';
$bar = ucwords($bar); // BONJOUR TOUT LE MONDE!
$bar = ucwords(strtolower($bar)); // Bonjour Tout Le Monde!
?>
Exemple #2 Exemple avec ucwords() et un séparation personnalisé
<?php
$foo = 'hello|world!';
$bar = ucwords($foo); // Hello|world!
$baz = ucwords($foo, "|"); // Hello|World!
?>
Exemple #3 Exemple de ucwords() des séparateurs supplémentaires
<?php
$foo = "mike o'hara";
$bar = ucwords($foo); // Mike O'hara
$baz = ucwords($foo, " \t\r\n\f\v'"); // Mike O'Hara
?>
Note: Cette fonction est conscient de la locale et traite l'entrée en fonction de la locale actuellement définie. Cependant, ceci ne fonctionne que sur des jeux de caractères d'un octet. Si vous devez utiliser des jeux de caractères multioctets (la plupart des langues différentes de l'Europe de l'ouest) regarder à la place les extensions multibyte ou intl
Note: Cette fonction gère les chaînes binaires.