mb_convert_case

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

mb_convert_case Меняет регистр символов в строке

Описание

mb_convert_case(string $string, int $mode, ?string $encoding = null): 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 способом.

Список изменений

Версия Описание
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/.

Смотрите также

  • mb_strtolower() - Приводит строку к нижнему регистру
  • mb_strtoupper() - Приводит строку к верхнему регистру
  • strtolower() - Преобразовывает строку в нижний регистр
  • strtoupper() - Преобразовывает строку в верхний регистр
  • ucfirst() - Преобразовывает первый символ строки в верхний регистр
  • ucwords() - Преобразовывает в верхний регистр первый символ каждого слова в строке