Pone en mayúscula la primera letra de todas las palabras

# ucwords

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

ucwords — Pone en mayúscula la primera letra de todas las palabras

### Descripción

function ucwords(string `$string`, string `$separators` = " \t\r\n\f\v"): string

Devuelve la cadena `string` después de poner en mayúscula la primera letra de todas las palabras, si este carácter es un carácter ASCII entre `"a"` (0x61) y `"z"` (0x7a).

En el contexto de esta función, una palabra es cualquier secuencia de caracteres que no están listados en el parámetro `separators`. Por omisión, estos son: un espacio, un salto de línea, una nueva línea, un retorno de carro, un salto de página, una tabulación horizontal y una tabulación vertical.

Para realizar una conversión similar en cadenas multiocteto, utilice mb_convert_case() con el modo `MB_CASE_TITLE`.

### Parámetros

`string`

  La cadena de entrada.

`separators`

  El parámetro opcional `separators` contiene el carácter de separación.

### Valores devueltos

Devuelve la cadena, después de la modificación.

### Historial de cambios

Versión | Descripción
--- | ---
8.2.0 | La conversión de la casilla ya no depende de la configuración local definida con setlocale(). Solo se convertirán los caracteres ASCII.

### Ejemplos

Ejemplo #1 Ejemplo con 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!
    ?>

Ejemplo #2 Ejemplo con ucwords() y un separador personalizado

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

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

Ejemplo #3 Ejemplo de ucwords() con separadores adicionales

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

### Notas

> Nota: Esta función es segura para sistemas binarios.

### Ver también

- strtoupper() - Devuelve una string en mayúsculas
- strtolower() - Devuelve una string en minúsculas
- ucfirst() - Pone en mayúscula el primer carácter
- mb_convert_case() - Realiza una conversión a mayúsculas/minúsculas de un string

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