(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
mb_convert_case — Realiza a conversão de caixa em uma string
Realiza a conversão de caixa em uma string, convertida da maneira especificada por
mode
.
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.
Uma versão da string
com conversão de caixa conforme
especificado por mode
.
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 .
|
Exemplo #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, PHP_EOL;
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str, PHP_EOL;
?>
Exemplo #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, PHP_EOL;
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str, PHP_EOL;
?>
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/.