(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
un caractère ASCII entre "a" (0x61) et
"z" (0x7a).
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.
Pour faire une conversion similaire sur les chaînes multioctet, utilisez
mb_convert_case() avec le mode
MB_CASE_TITLE.
stringLa 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.
| Version | Description |
|---|---|
| 8.2.0 | La conversion de la casse ne dépend désormais plus de la locale définit avec setlocale(). Seuls les caractères ASCII seront convertis. |
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 gère les chaînes binaires.