mb_convert_case

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

mb_convert_caseRealiza una conversión a mayúsculas/minúsculas de un string

Descripción

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

Realiza una conversión a mayúsculas/minúsculas de un string, de acuerdo al valor especificado en mode.

Parámetros

string

El string que se va a convertir.

mode

El modo de conversión. Puede ser uno de 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

El parámetro encoding es la codificación de caracteres. Si es omitido o null, será usado el valor de la codificación de caracteres interna.

Valores devueltos

La versión convertida del string en función del valor especificado en mode.

Historial de cambios

Versión Descripción
8.3.0 Se implementaron reglas de mayúsculas y minúsculas condicionales para la letra griega sigma que solo se aplican a los modos MB_CASE_LOWER y MB_CASE_TITLE, no a MB_CASE_LOWER_SIMPLE y MB_CASE_TITLE_SIMPLE.
7.3.0 Añadido soporte para MB_CASE_FOLD, MB_CASE_UPPER_SIMPLE, MB_CASE_LOWER_SIMPLE, MB_CASE_TITLE_SIMPLE, y MB_CASE_FOLD_SIMPLE como mode.

Ejemplos

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, PHP_EOL;
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo
$str, PHP_EOL;
?>

Ejemplo #2 Ejemplo de mb_convert_case() con alfabeto no latino en UTF-8

<?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;
?>

Notas

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. Por lo tanto, el comportamiento de esta función no se ve afectado por la configuración regional y puede convertir cualquier carácter que tenga 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/reports/tr21/.

Ver también

  • mb_strtolower() - Convierte una cadena de caracteres a minúsculas
  • mb_strtoupper() - Convierte un string en mayúsculas
  • strtolower() - Convierte un string a minúsculas
  • strtoupper() - Convierte un string a mayúsculas
  • ucfirst() - Convierte el primer caracter de una cadena a mayúsculas
  • ucwords() - Convierte a mayúsculas el primer caracter de cada palabra de una cadena