array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.mb-convert-case.php', 1 => 'mb_convert_case', 2 => 'Меняет регистр символов в строке', ), 'up' => array ( 0 => 'ref.mbstring.php', 1 => 'Функции для работы с многобайтовыми строками', ), 'prev' => array ( 0 => 'function.mb-chr.php', 1 => 'mb_chr', ), 'next' => array ( 0 => 'function.mb-convert-encoding.php', 1 => 'mb_convert_encoding', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/mbstring/functions/mb-convert-case.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

Функция преобразовывает регистр символов в строке (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/.

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