(PHP 4, PHP 5, PHP 7, PHP 8)
ucwords — Met en majuscule la première lettre de tous les mots
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
.
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.
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.