Met en majuscule la première lettre de tous les mots

# ucwords

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

ucwords — Met en majuscule la première lettre de tous les mots

### Description

function 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, une tabulation horizontale, un retour chariot, un saut de ligne, un saut de page et une tabulation verticale.

Pour faire une conversion similaire sur les chaînes multioctet, utiliser 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éparateur personnalisé

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

    echo ucwords($foo, "|"), PHP_EOL;        // Hello|World!
    ?>

Exemple #3 Exemple avec ucwords() et 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open