Resumo : neste tutorial, você aprenderá como usar a ucwords()
função PHP para colocar o primeiro caractere de cada palavra em uma string em maiúsculo.
Introdução à função ucwords() do PHP
A ucwords()
função aceita uma string e retorna uma nova string com o primeiro caractere de cada palavra convertido para maiúscula:
ucwords ( string $string , string $separators = " \t\r\n\f\v" ) : string
Linguagem de código: PHP ( php )
Por padrão, a ucwords()
função usa os seguintes caracteres para separar as palavras em uma string:
Para usar separadores diferentes, você pode especificá-los no argumento $separator.
Observe que ucwords()
não modifica a string original, mas retorna uma nova string modificada.
Exemplos de funções PHP ucwords()
Vejamos alguns exemplos de uso da ucwords()
função.
1) Exemplo simples de função PHP ucwords()
O exemplo a seguir usa a ucwords()
função para converter os primeiros caracteres do nome e do sobrenome em letras maiúsculas:
<?php
$name = 'john doe';
echo ucwords($name);
Linguagem de código: PHP ( php )
Saída:
John Doe
Linguagem de código: PHP ( php )
2) Usando a função PHP ucwords() com o exemplo da função strtolower()
O ucwords()
converte apenas o primeiro caractere de cada palavra. Isso não muda outros personagens.
Portanto, você precisa usar th ucwords()
com a strtolower()
função para converter as strings. Por exemplo:
<?php
$name = 'JANE DOE';
echo ucwords(strtolower($name));
Linguagem de código: PHP ( php )
Saída:
Jane Doe
Linguagem de código: PHP ( php )
Neste exemplo, o $name
está em letras maiúsculas. A strtolower()
função retorna a versão minúscula da string. E ucwords()
retorna uma nova string com o primeiro caractere de cada palavra convertido para maiúscula.
3) Usando a função PHP ucwords() com delimitadores de palavras adicionais
Suponha que você tenha o seguinte nome:
$name = "alice o'reilly";
Linguagem de código: PHP ( php )
E você deseja convertê-lo para:
Alice O'Reilly
Linguagem de código: PHP ( php )
Se você usar os delimitadores padrão, não funcionará conforme o esperado. por exemplo:
<?php
$name = "alice o'reilly";
echo ucwords($name);
Linguagem de código: PHP ( php )
Saída:
Alice O'reilly
Linguagem de código: PHP ( php )
Para que funcione, você precisa adicionar o caractere '
aos separadores padrão como este:
<?php
$name = "alice o'reilly";
echo ucwords($name, " \t\r\n\f\v'");
Linguagem de código: PHP ( php )
Saída:
Alice O'Reilly
Linguagem de código: PHP ( php )
Observe que os delimitadores padrão " \t\r\n\f\v"
garantem que a lógica atual para separar palavras seja a mesma de antes.
Resumo
- Use o PHP
ucwords()
para retornar uma nova string com o primeiro caractere de cada palavra convertido para maiúscula.