mb_convert_case

(PHP 4 >= 4.3.0, PHP 5)

mb_convert_case -- 文字列に対してケースフォルディングを行う

説明

string mb_convert_case ( string str, int mode [, string encoding] )

mb_convert_case() は、mode で指定された方法で string に対して ケースフォルディングを行い、それを返します。

mode は、MB_CASE_UPPER, MB_CASE_LOWER , MB_CASE_TITLE のいずれかの値を取ります。

encodingstr の 文字エンコーディングを指定します。省略された場合は、 内部文字エンコーディングが使用されます。

返り値は適切なケースフォルディングが適用された文字列です。

標準のケースフォルディング関数である strtolower()strtoupper() と違い、ケースフォルディングは Unicode 文字属性を基準に行われます。したがって、この関数の挙動は ロケールの設定に影響されず、また、すべてのアルファベット、 例えば A ウムラウト (Ä) を変換することができます。

Unicode 文字属性についての詳細は http://www.unicode.org/unicode/reports/tr21/ を参照してください。

例 1. mb_convert_case() の例

<?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
?>

mb_strtolower(), mb_strtoupper(), strtolower(), strtoupper(), ucfirst() そして ucwords() も参照ください。