IntlChar::tolower

(PHP 7, PHP 8)

IntlChar::tolower — Unicode 文字を小文字にする

説明

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

指定した文字を、同等の小文字にマップします。同等の小文字が存在しない場合、指定された文字そのものを返します。

パラメータ

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

戻り値

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

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

例

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

<?php
var_dump(IntlChar::tolower("A"));
var_dump(IntlChar::tolower("a"));
var_dump(IntlChar::tolower("Φ"));
var_dump(IntlChar::tolower("φ"));
var_dump(IntlChar::tolower("1"));
var_dump(IntlChar::tolower(ord("A")));
var_dump(IntlChar::tolower(ord("a")));
?>

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

string(1) "a"
string(1) "a"
string(2) "φ"
string(2) "φ"
string(1) "1"
int(97)
int(97)

参考

IntlChar::totitle() - Unicode 文字をタイトルケースにする
IntlChar::toupper() - Unicode 文字を大文字にする
mb_strtolower() - 文字列を小文字にする

関連キーワード:

IntlChar tolower dump 小文字 Unicode コードポイント totitle codepoint static マップエンコード Lowercase Mapping 返り値参考タイトルケース toupper 大文字 strtolower