phpday 2025 - Call For Papers

mb_ucfirst

(PHP 8 >= 8.4.0)

mb_ucfirstConverte para maiúscula o primeiro caractere de uma string

Descrição

mb_ucfirst(string $string, ?string $encoding = null): string

Realizad uma operação ucfirst() segura para strings multi-byte, e retorna uma string com o primeiro caractere do parâmetro string convertido para letra de título.

Parâmetros

string
A string de entrada.
encoding
A codificação da string.

Valor Retornado

Retorna a string resultante.

Notas

Nota:

Em contraste com as funções padrão de conversão de maiúsculas e minúsculas, como strtolower() e strtoupper(), a conversão é executada com base nas propriedades dos caracteres Unicode. Assim, o comportamento desta função não é afetado pelas configurações de localidade e pode converter quaisquer caracteres que tenham propriedade 'alphabetic' (alfabética), como trema (ä) por exemplo.

Para obter mais informações sobre as propriedades Unicode, consulte » http://www.unicode.org/reports/tr21/.

Veja Também

  • mb_lcfirst() - Converte parap minúscula o primeiro caractere de uma string
  • mb_convert_case() - Realiza a conversão de caixa em uma string
  • ucfirst() - Transforma o primeiro caractere de uma string em maiúsculo
adicione uma nota

Notas Enviadas por Usuários (em inglês) 1 note

up
1
hans at loltek dot net
15 days ago
polyfill:

<?php
if(PHP_VERSION_ID < 80400) {
function
mb_ucfirst(string $str, string $encoding = null): string
{
if (
$encoding === null) {
$encoding = mb_internal_encoding();
}
return
mb_strtoupper(mb_substr($str, 0, 1, $encoding), $encoding) . mb_substr($str, 1, null, $encoding);
}

}
?>

if you wonder why i bother with mb_internal_encoding: prior to php7, $encoding was not nullable. if your polyfill don't need php5.6 support, you can drop it.
To Top