PHPのIntlChar::digit()関数とは？使い方とサンプルコードを解説

PHPのIntlChar::digit()関数は、指定した基数（radix）におけるコードポイントの10進数の桁値を取得するために使用されます。文字がその基数で有効な数字として扱えるかどうかを判定し、対応する数値を返します。

構文

int IntlChar::digit( $val, $radix )

パラメータ

• val − 整数、またはUTF-8エンコードされた文字列形式の文字を指定します。

• radix − 基数（底）の値を指定します。デフォルトは10です。指定できる範囲は2から36までです。

戻り値

IntlChar::digit()関数は、指定した基数において文字が表す数値を返します。文字がその基数で有効な数字でない場合はfalse（bool型）を返します。

使用例

以下に具体的なコード例を示します。

<?php
    var_dump(IntlChar::digit("2"));
    echo "<br>";
    var_dump(IntlChar::digit("Z"));
    echo "<br>";
    var_dump(IntlChar::digit("6", 2));
?>

出力結果

上記のコードを実行すると、以下のような出力が得られます。

int(2)
bool(false)
bool(false)

出力結果の解説

• IntlChar::digit("2") − デフォルト基数は10のため、「2」は有効な数字であり、int(2)が返されます。

• IntlChar::digit("Z") − 「Z」は10進数では数字として扱えないため、bool(false)が返されます。ただし、基数36を指定すれば「Z」は35として評価されます。

• IntlChar::digit("6", 2) − 基数2（2進数）では「6」は無効な数字であるため、bool(false)が返されます。

このように、IntlChar::digit()関数を使うことで、文字やコードポイントが特定の基数で有効な数字かどうかを簡単に判定できます。