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

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

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.

### Exemples

Exemple #1 Exemple avec ucwords()

`<?php
$foo = 'bonjour tout le monde!';
echo ucwords($foo), PHP_EOL; // Bonjour Tout Le Monde!
$bar = 'BONJOUR TOUT LE MONDE!';
echo ucwords($bar);, PHP_EOL // BONJOUR TOUT LE MONDE!
echo ucwords(strtolower($bar)), PHP_EOL; // Bonjour Tout Le Monde!
?>`

Exemple #2 Exemple avec ucwords() et un séparation personnalisé

`<?php
$foo = 'hello|world!';
echo ucwords($foo), PHP_EOL; // Hello|world!
echo ucwords($foo, "|"), PHP_EOL; // Hello|World!
?>`

Exemple #3 Exemple de ucwords() des séparateurs supplémentaires

`<?php
$foo = "mike o'hara";
echo ucwords($foo), PHP_EOL; // Mike O'hara
echo ucwords($foo, " \t\r\n\f\v'"), PHP_EOL; // Mike O'Hara
?>`

### Notes

> Note: Cette fonction gère les chaînes binaires.

### Voir aussi

- strtoupper() - Renvoie une chaîne en majuscules
- strtolower() - Renvoie une chaîne en minuscules
- ucfirst() - Met le premier caractère en majuscule
- mb_convert_case() - Modifie la casse d'une chaîne