Unicode 文字を小文字にする

# 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() - 文字列を小文字にする

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open