(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
mb_convert_case — Меняет регистр символов в строке
Функция преобразовывает регистр символов в строке (string) способом,
который указали в параметре mode.
stringСтрока (string), которую требуется преобразовать.
mode
Режим преобразования. Параметр принимает значение константы из списка:
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
Параметр encoding устанавливает кодировку символов.
Функция установит для параметра значение внутренней кодировки символов,
если аргумент не передали или передали значение null.
Функция возвращает строку string,
которую преобразовала способом,
который указали в параметре mode.
| Версия | Описание |
|---|---|
| 8.3.0 |
Реализовали правила условного регистра для греческой буквы сигма,
которые применяются только к режимам
MB_CASE_LOWER
и MB_CASE_TITLE,
но не к режимам MB_CASE_LOWER_SIMPLE
и MB_CASE_TITLE_SIMPLE.
|
| 7.3.0 |
Добавили поддержку режимов для параметра mode:
MB_CASE_FOLD,
MB_CASE_UPPER_SIMPLE,
MB_CASE_LOWER_SIMPLE,
MB_CASE_TITLE_SIMPLE
и MB_CASE_FOLD_SIMPLE.
|
Пример #1 Пример изменения регистра символов в строке функцией mb_convert_case()
<?php
$str = "у мэри был маленький ягнёнок и она его очень любила";
$str = mb_convert_case($str, MB_CASE_UPPER, "UTF-8");
echo $str; // Выведет У МЭРИ БЫЛ МАЛЕНЬКИЙ ЯГНЁНОК И ОНА ЕГО ОЧЕНЬ ЛЮБИЛА
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Выведет У Мэри Был Маленький Ягнёнок И Она Его Очень Любила
?>
Пример #2 Пример изменения функцией mb_convert_case() регистра символов в строке с нелатинским текстом в кодировке UTF-8
<?php
$str = "Τάχιστη αλώπηξ βαφής ψημένη γη, δρασκελίζει υπέρ νωθρού κυνός";
$str = mb_convert_case($str, MB_CASE_UPPER, "UTF-8");
echo $str; // Выведет ΤΆΧΙΣΤΗ ΑΛΏΠΗΞ ΒΑΦΉΣ ΨΗΜΈΝΗ ΓΗ, ΔΡΑΣΚΕΛΊΖΕΙ ΥΠΈΡ ΝΩΘΡΟΎ ΚΥΝΌΣ
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Выведет Τάχιστη Αλώπηξ Βαφήσ Ψημένη Γη, Δρασκελίζει Υπέρ Νωθρού Κυνόσ
?>В отличие от стандартных функций преобразования регистра наподобие strtolower() и strtoupper(), регистр меняется на основе свойств символа Юникода. Поэтому на поведение этой функции не влияют региональные настройки системы, и она умеет конвертировать символы с Unicode-свойством 'alphabetic' наподобие символа буквы «а» с умлаутом — ä.
Подробнее о свойствах Юникода рассказывает страница » http://www.unicode.org/reports/tr21/.