Converte para maiúsculas o primeiro caractere de cada palavra

# ucwords

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

ucwords — Converte para maiúsculas o primeiro caractere de cada palavra

### Descrição

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

Retorna uma string com o primeiro caractere de cada palavra em `string` em maiúscula, se este caractere for uma letra ASCII entre `"a"` (0x61) e `"z"` (0x7a).

Nesta função, uma palavra é qualquer sequência de caracteres não listada no parâmetro `separators`. Por padrão, os separadores são: espaço, tab horizontal, retorno de carro, nova linha, form feed e tab vertical.

Para realizar uma conversão similar em strings multibyte, utilize mb_convert_case() com a opção `MB_CASE_TITLE`.

### Parâmetros

`string`

  A string de entrada.

`separators`

  O parâmetro opcional `separators` contém os caracteres separadores das palavras.

### Valor Retornado

Retorna a string modificada.

### Registro de Alterações

Versão | Descrição
--- | ---
8.2.0 | A conversão de maiúsculas e minúsculas não depende mais da localidade definida com setlocale(). Somente caracteres ASCII serão convertidos.

### Exemplos

Exemplo #1 Exemplo de ucwords()

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

    $bar = 'HELLO WORLD!';
    echo ucwords($bar), PHP_EOL;              // HELLO WORLD!
    echo ucwords(strtolower($bar)), PHP_EOL;  // Hello World!
    ?>

Exemplo #2 Exemplo de ucwords() com delimitador

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

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

Exemplo #3 Exemplo de ucwords() com delimitadores adicionais

    <?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 função é compatível com dados binários.

### Veja Também

- strtoupper() - Converte uma string em maiúsculas
- strtolower() - Converte uma string para minúsculas
- ucfirst() - Transforma o primeiro caractere de uma string em maiúsculo
- mb_convert_case() - Realiza a conversão de caixa em uma string

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