mb_convert_case

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

mb_convert_case — Realiza a conversão de caixa em uma string

Descrição

mb_convert_case(string $string, int $mode, ?string $encoding = null): string

Realiza a conversão de caixa em uma string, convertida da maneira especificada por mode.

Parâmetros

string

A string sendo convertida.

mode

O modo de conversão. Pode ser um dos MB_CASE_UPPER, MB_CASE_LOWER, MB_CASE_TITLE, MB_CASE_FOLD, MB_CASE_UPPER_SIMPLE, MB_CASE_LOWER_SIMPLE, MB_CASE_TITLE_SIMPLE, MB_CASE_FOLD_SIMPLE.

encoding

O parâmetro encoding é a codificação de caracteres. Se for omitido ou null, o valor da codificação de caracteres interna será usado.

Valor Retornado

Uma versão da string com conversão de caixa conforme especificado por mode.

Registro de Alterações

Versão Descrição
8.3.0 Implementadas regras condicionais de maiúsculas/minúsculas para a letra grega sigma que só se aplicam aos modos MB_CASE_LOWER e MB_CASE_TITLE, e não a MB_CASE_LOWER_SIMPLE e MB_CASE_TITLE_SIMPLE.
7.3.0 Adicionado suporte para MB_CASE_FOLD, MB_CASE_UPPER_SIMPLE, MB_CASE_LOWER_SIMPLE, MB_CASE_TITLE_SIMPLE, e MB_CASE_FOLD_SIMPLE como mode.

Exemplos

Example #1 Exemplo de mb_convert_case()

<?php
$str = "mary had a Little lamb and she loved it so";
$str = mb_convert_case($str, MB_CASE_UPPER, "UTF-8");
echo $str; // Prints MARY HAD A LITTLE LAMB AND SHE LOVED IT SO
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Prints Mary Had A Little Lamb And She Loved It So
?>

Example #2 Exemplo de mb_convert_case() com texto UTF-8 não latino

<?php
$str = "Τάχιστη αλώπηξ βαφής ψημένη γη, δρασκελίζει υπέρ νωθρού κυνός";
$str = mb_convert_case($str, MB_CASE_UPPER, "UTF-8");
echo $str; // Imprime ΤΆΧΙΣΤΗ ΑΛΏΠΗΞ ΒΑΦΉΣ ΨΗΜΈΝΗ ΓΗ, ΔΡΑΣΚΕΛΊΖΕΙ ΥΠΈΡ ΝΩΘΡΟΎ ΚΥΝΌΣ
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Imprime Τάχιστη Αλώπηξ Βαφήσ Ψημένη Γη, Δρασκελίζει Υπέρ Νωθρού Κυνόσ
?>

Notas

Ao contrário das funções padrão de conversão de caixa, como strtolower() e strtoupper(), a conversão de caixa é realizada com base nas propriedades dos caracteres Unicode. Assim, o comportamento desta função não é afetado pelas configurações de localidade e ela pode converter qualquer caractere que tenha a propriedade 'alfabética', como o a-umlaut (ä).

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

Veja Também