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ãoDescriçã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.

    Exemplos

    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 Τάχιστη Αλώπηξ Βαφήσ Ψημένη Γη, Δρασκελίζει Υπέρ Νωθρού Κυνόσ
    ?>

    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

    To Top