(PHP 4, PHP 5, PHP 7, PHP 8)
ucwords — Met en majuscule la première lettre de tous les mots
Description
ucwords(string
$string
, string
$separators
= " \t\r\n\f\v"): string
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
.
Liste de paramètres
-
string
-
La chaîne d'entrée.
-
separators
-
Le paramètre optionnel separators
contient le caractère
de séparation.
Valeurs de retour
Retourne la chaîne, après modification.
Historique
Exemples
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
?>
Notes
Note:
Cette fonction gère les chaînes binaires.
Voir aussi