array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.mb-convert-case.php', 1 => 'mb_convert_case', ), 'up' => array ( 0 => 'ref.mbstring.php', 1 => 'Strings Multibyte e Funções', ), 'prev' => array ( 0 => 'function.mb-chr.php', 1 => 'mb_chr', ), 'next' => array ( 0 => 'function.mb-convert-encoding.php', 1 => 'mb_convert_encoding', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mbstring/functions/mb-convert-case.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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 |
---|---|
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; // 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
?>
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; // Imprime ΤΆΧΙΣΤΗ ΑΛΏΠΗΞ ΒΑΦΉΣ ΨΗΜΈΝΗ ΓΗ, ΔΡΑΣΚΕΛΊΖΕΙ ΥΠΈΡ ΝΩΘΡΟΎ ΚΥΝΌΣ
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Imprime Τάχιστη Αλώπηξ Βαφήσ Ψημένη Γη, Δρασκελίζει Υπέρ Νωθρού Κυνόσ
?>
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/.