PHPのctype_digit()関数の使い方 – 文字列が数字のみかどうかを判定する方法

ctype_digit()関数は、文字列に含まれるすべての文字が10進数の数字（0〜9）であるかどうかを調べる関数です。検証対象の文字列が数字のみで構成されている場合にTRUEを返し、それ以外の場合はFALSEを返します。フォーム入力のバリデーションや、ユーザーID・郵便番号など数値のみで構成されたデータのチェックに活用できます。

構文

ctype_digit(str)

パラメータ

• str − 検証対象となる文字列

戻り値

文字列内のすべての文字が10進数の数字であればTRUE、そうでなければFALSEを返します。

使用例

以下はctype_digit()関数を使ったサンプルプログラムです。アルファベットと数字が混在する文字列「mac7687」と、数字のみの文字列「8798」をそれぞれ判定しています。

<?php
    $arr = array('mac7687', '8798');

    foreach ($arr as $a) {
        if (ctype_digit($a)) {
            echo "$a はすべて数字で構成されています。\n";
        } else {
            echo "$a には数字以外の文字が含まれています。\n";
        }
    }
?>

出力結果

上記プログラムの実行結果は以下の通りです。

mac7687 には数字以外の文字が含まれています。
8798 はすべて数字で構成されています。

注意点

• 空文字列（""）を渡した場合はFALSEを返します（PHP 5.1.0以降）。

• マイナス記号（-）や小数点（.）は数字として扱われないため、「-123」や「3.14」のような文字列にはFALSEが返ります。負数や小数を判定したい場合はis_numeric()関数の利用を検討してください。

• 整数値をそのまま引数に渡すのは避けてください。256未満の整数はASCIIコードとして解釈されるため、意図しない結果になる可能性があります。必ず文字列として渡しましょう。