ucwords

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

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

    Descrição

    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ãoDescriçã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 da ucwords()

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

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

    Exemplo #2 Exemplo de ucwords() com delimitador

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

    $baz = ucwords($foo, "|"); // Hello|World!
    ?>

    Exemplo #3 Exemplo de ucwords() com delimitadores adicionais

    <?php
    $foo     = "mike o'hara";
    $bar = ucwords($foo); // Mike O'hara

    $baz = ucwords($foo, " \t\r\n\f\v'"); // Mike O'Hara
    ?>

    Notas

    Nota: Esta função é compatível com dados binários.

    Veja Também

    To Top