(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
mb_convert_case — Меняет регистр символов в строке
Меняет регистр символов в строке,
преобразовывая её заданным в параметре 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
способом.
Версия | Описание |
---|---|
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(), регистр меняется на основе свойств символа Юникода. Поэтому на поведение этой функции не влияют региональные настройки системы, и она может конвертировать любые символы, имеющие «алфавитное» свойство, например, как а-умляут (ä).
Подробнее о свойствах Юникода рассказано по ссылке » http://www.unicode.org/reports/tr21/.