(PHP 4 >= 4.3.0, PHP 5, PHP 7)
mb_convert_case — Realiza una conversión a mayúsculas/minúsculas de un string
$str
, int $mode
[, string $encoding
= mb_internal_encoding()
] ) : string
Realiza una conversión a mayúsculas/minúsculas en un string, de acuerdo al
modo especificado por mode
.
str
El string que se va a convertir.
mode
El modo de conversión. Puede ser
MB_CASE_UPPER
,
MB_CASE_LOWER
, o
MB_CASE_TITLE
.
encoding
El parámetro encoding
es la codificación de caracteres. Si es omitido, será usado el valor de la
codificación de caracteres interna.
La versión convertida del string
tal como se
especificó en el parámetro mode
.
A diferencia de las funciones estándar de mayúsculas/minúsculas, como strtolower() y strtoupper(), la conversión se lleva a cabo según los fundamentos de las propiedades de los caracteres Unicode. De esta forma, esta función no se ve afectada por las configuraciones regionales, ya que puede convertir cualquier carácter que contenga la propiedad 'alfabética', como la A con diéresis (Ä).
Para más información sobre las propiedades Unicode, por favor, revise » http://www.unicode.org/unicode/reports/tr21/.
Ejemplo #1 Ejemplo 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; // Muestra MARY HAD A LITTLE LAMB AND SHE LOVED IT SO
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Muestra Mary Had A Little Lamb And She Loved It So
?>
Ejemplo #2 Ejemplo de mb_convert_case() con texto no latino en UTF-8
<?php
$str = "Τάχιστη αλώπηξ βαφής ψημένη γη, δρασκελίζει υπέρ νωθρού κυνός";
$str = mb_convert_case($str, MB_CASE_UPPER, "UTF-8");
echo $str; // Muestra ΤΆΧΙΣΤΗ ΑΛΏΠΗΞ ΒΑΦΉΣ ΨΗΜΈΝΗ ΓΗ, ΔΡΑΣΚΕΛΊΖΕΙ ΥΠΈΡ ΝΩΘΡΟΎ ΚΥΝΌΣ
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Muestra Τάχιστη Αλώπηξ Βαφήσ Ψημένη Γη, Δρασκελίζει Υπέρ Νωθρού Κυνόσ
?>