(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, PHP_EOL;
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str, PHP_EOL;
?>
Пример #2 Пример изменения функцией mb_convert_case() регистра символов в строке с нелатинским текстом в кодировке 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;
?>В отличие от стандартных функций преобразования регистра наподобие strtolower() и strtoupper(), регистр меняется на основе свойств символа Юникода. Поэтому на поведение этой функции не влияют региональные настройки системы, и она умеет конвертировать символы с Unicode-свойством 'alphabetic' наподобие символа буквы «а» с умлаутом — ä.
Подробнее о свойствах Юникода рассказывает страница » http://www.unicode.org/reports/tr21/.