IntlChar::totitle

(PHP 7, PHP 8)

IntlChar::totitle — Unicode 文字をタイトルケースにする

説明

public static function IntlChar::totitle(int|string $codepoint): int|string|null

指定した文字を、同等のタイトルケースにマップします。同等のタイトルケースが存在しない場合、指定された文字そのものを返します。

パラメータ

codepoint: コードポイントを表す int 型の値 (例: U+2603 SNOWMAN を表す 0x2603)、あるいは UTF-8 文字列としてエンコードされた文字 (例: "\u{2603}")。

戻り値

存在する場合に、コードポイントの Simple_Titlecase_Mapping の値を返します。存在しない場合は、コードポイントそのものを返します。失敗した場合は、null を返します。

戻り値の型は int になります。ただし、コードポイントを UTF-8 文字列で渡した場合は別で、その場合の返り値の型は文字列になります。失敗した場合は、null を返します。

例

例1 さまざまなコードポイントの例

<?php
var_dump(IntlChar::totitle("Ǆ"));
var_dump(IntlChar::totitle("ǆ"));
var_dump(IntlChar::totitle("Φ"));
var_dump(IntlChar::totitle("φ"));
var_dump(IntlChar::totitle("1"));
var_dump(IntlChar::totitle("ᾳ"));
var_dump(IntlChar::totitle(ord("A")));
?>

上の例の出力は以下となります。

string(1) "ǅ"
string(1) "ǅ"
string(2) "Φ"
string(2) "φ"
string(1) "1"
string(1) "ᾼ"
int(65)

参考

IntlChar::tolower() - Unicode 文字を小文字にする
IntlChar::toupper() - Unicode 文字を大文字にする
IntlChar::istitle() - コードポイントがタイトルケース文字であるかを調べる
mb_convert_case() - 文字列に対してケースフォールディングを行う

関連キーワード:

IntlChar totitle ケース dump タイトルコードポイント Unicode tolower toupper codepoint static マップエンコード Titlecase Mapping 返り値参考小文字大文字 istitle convert case フォールディング