Resumo : neste tutorial, você aprenderá como usar a ucfirst()
função PHP para colocar o primeiro caractere alfabético em maiúscula.
Introdução à função PHP ucfirst()
A ucfirst()
função aceita uma string e retorna uma nova string com o primeiro caractere convertido em maiúscula se esse caractere for alfabético.
Aqui está a sintaxe da ucfirst()
função:
ucfirst ( string $string ) : string
Linguagem de código: PHP ( php )
A ucfirst()
função usa a localidade atual para determinar qual caractere é alfabético.
Exemplo de função PHP ucfirst()
O exemplo a seguir usa a ucfirst()
função para converter os primeiros caracteres do nome e do sobrenome em letras maiúsculas:
<?php
$first_name = 'john';
$last_name = 'doe'
echo ucfirst($first_name) . ' ' . ucfirst($last_name);
Linguagem de código: PHP ( php )
Saída:
John Doe
Linguagem de código: PHP ( php )
Lidando com caracteres multibyte
O ucfirst()
não suporta strings multibyte. Para retornar uma nova string com o primeiro caractere convertido para maiúsculo, você pode usar a seguinte mb_ucfirst()
função:
<?php
function mb_ucfirst($str)
{
return mb_strtoupper(mb_substr($str, 0, 1)) . mb_substr($str, 1);
}
Linguagem de código: PHP ( php )
Como funciona.
Primeiro, pegue o primeiro caractere da $str
função mb_substr()
e converta-o para maiúscula usando a função mb_strtoupper() :
mb_strtoupper(mb_substr($str, 0, 1))
Linguagem de código: PHP ( php )
Em seguida, concatene o caractere maiúsculo com os caracteres restantes da string:
mb_strtoupper(mb_substr($str, 0, 1)) . mb_substr($str, 1);
Linguagem de código: PHP ( php )
O exemplo a seguir usa o ucfirst()
para converter a primeira letra da string äbtissin
em maiúscula:
<?php
$title = 'äbtissin';
echo ucfirst($title); // doesn't work
Linguagem de código: PHP ( php )
Saída:
äbtissin
Linguagem de código: PHP ( php )
No entanto, não funciona como esperado. Porque nos caracteres de localidade “C” padrão, a ucfirst()
função não converte caracteres como trema-a ( ä
).
O seguinte usa a mb_ucfirst()
função:
<?php
$title = 'äbtissin';
echo mb_ucfirst($title);
Linguagem de código: PHP ( php )
Saída:
Äbtissin
Linguagem de código: PHP ( php )
Agora, funciona conforme o esperado.
Resumo
- Use a
ucfirst()
função para retornar uma string com o primeiro caractere alfabético convertido em maiúsculo.