【PHP】ctype_cntrl()関数の使い方 – 制御文字の判定方法

ctype_cntrl()関数とは

PHPのctype_cntrl()関数は、文字列に含まれるすべての文字が制御文字であるかどうかをチェックする関数です。現在のロケール設定に基づいて判定が行われ、すべての文字が制御文字であればTRUE、1つでも制御文字以外が含まれていればFALSEを返します。

制御文字とは、改行（\n）、キャリッジリターン（\r）、タブ（\t）、エスケープ文字など、画面上に直接表示されない特殊な文字のことです。

構文

ctype_cntrl(str)

パラメータ

• str − チェック対象の文字列を指定します。

戻り値

文字列内のすべての文字が現在のロケールにおける制御文字であればTRUEを、それ以外の場合はFALSEを返します。

使用例

以下は、ctype_cntrl()関数を使用して制御文字を判定するサンプルコードです。

<?php
$arr = array('str1' => "\n\r\t", 'str2' => "demo76876test");
foreach ($arr as $a => $demo) {
    if (ctype_cntrl($demo)) {
        echo "$a はすべて制御文字です。 \n";
    } else {
        echo "$a はすべてが制御文字ではありません。 \n";
    }
}
?>

出力結果

str1 はすべて制御文字です。
str2 はすべてが制御文字ではありません。

注意点

空の文字列を渡した場合はFALSEが返されます（PHP 5.1以降）。また、判定は現在のロケールに依存するため、setlocale()による設定内容によって結果が変わる場合があります。文字の種類を判定するその他の関数として、数字を判定するctype_digit()や英字を判定するctype_alpha()などもあり、用途に応じて使い分けるとよいでしょう。