ucwords

(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

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.

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.

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

Voir aussi