ucwords

(PHP 4, PHP 5, PHP 7, PHP 8)

ucwordsMet 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