mb_convert_case
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
mb_convert_case — Perform case folding on a string
Beschreibung
$string
, int $mode
, ?string $encoding
= null
): string
Performs case folding on a string, converted in the way specified by
mode
.
Parameter-Liste
-
string
-
The string being converted.
-
mode
-
The mode of the conversion. It can be one of
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
-
Der Parameter
encoding
legt das Zeichenencoding fest. Wird er nicht übergeben so wird die interne Zeichenkodierung genutzt.
Rückgabewerte
A case folded version of string
converted in the
way specified by mode
.
Changelog
Version | Beschreibung |
---|---|
7.3.0 |
Added support for
MB_CASE_FOLD ,
MB_CASE_UPPER_SIMPLE ,
MB_CASE_LOWER_SIMPLE ,
MB_CASE_TITLE_SIMPLE , and
MB_CASE_FOLD_SIMPLE
as mode .
|
Beispiele
Beispiel #1 mb_convert_case() example
<?php
$str = "mary had a Little lamb and she loved it so";
$str = mb_convert_case($str, MB_CASE_UPPER, "UTF-8");
echo $str; // Prints MARY HAD A LITTLE LAMB AND SHE LOVED IT SO
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Prints Mary Had A Little Lamb And She Loved It So
?>
Beispiel #2 mb_convert_case() example with non-Latin UTF-8 text
<?php
$str = "Τάχιστη αλώπηξ βαφής ψημένη γη, δρασκελίζει υπέρ νωθρού κυνός";
$str = mb_convert_case($str, MB_CASE_UPPER, "UTF-8");
echo $str; // Prints ΤΆΧΙΣΤΗ ΑΛΏΠΗΞ ΒΑΦΉΣ ΨΗΜΈΝΗ ΓΗ, ΔΡΑΣΚΕΛΊΖΕΙ ΥΠΈΡ ΝΩΘΡΟΎ ΚΥΝΌΣ
$str = mb_convert_case($str, MB_CASE_TITLE, "UTF-8");
echo $str; // Prints Τάχιστη Αλώπηξ Βαφήσ Ψημένη Γη, Δρασκελίζει Υπέρ Νωθρού Κυνόσ
?>
Anmerkungen
By contrast to the standard case folding functions such as strtolower() and strtoupper(), case folding is performed on the basis of the Unicode character properties. Thus the behaviour of this function is not affected by locale settings and it can convert any characters that have 'alphabetic' property, such a-umlaut (ä).
For more information about the Unicode properties, please see » http://www.unicode.org/reports/tr21/.
Siehe auch
- mb_strtolower() - Make a string lowercase
- mb_strtoupper() - Make a string uppercase
- strtolower() - Setzt einen String in Kleinbuchstaben um
- strtoupper() - Wandelt alle Zeichen eines Strings in Großbuchstaben um
- ucfirst() - Verwandelt das erste Zeichen eines Strings in einen Großbuchstaben
- ucwords() - Wandelt jeden ersten Buchstaben eines Wortes innerhalb eines Strings in einen Großbuchstaben um