ctype_space

空白文字かどうか調べる

説明

bool ctype_space(mixed $text)

与えられた文字列 text のすべての文字が空白文字であるかどうかを調べます。

パラメータ

text

調べる文字列。

注意:
-128 から 255 までの int を渡すと、ひとつの文字の ASCII 値とみなします (負の値には 256 を足して、拡張 ASCII の範囲に収まるようにします)。それ以外の整数値は、10 進数を含む文字列とみなします。

警告

PHP 8.1.0 以降は、ctype関数に文字列でない引数を渡すことは、推奨されなくなりました。将来のバージョンでは、引数は ASCII コードポイントではなく、文字列として解釈されるようになります。ユーザが意図する振る舞いによっては、引数を文字列にキャストするか、 chr を明示的にコールすべきです。

戻り値

text のすべての文字がなんらかの空白文字を生成する場合に true 、そうでない場合に false を返します。空白文字には、タブ・垂直タブ・改行・復帰・フォームフィード文字も含まれます。空文字列を渡して呼び出した場合、結果は常に false になります。

例

例1 ctype_space の例

<?php
$strings = array(
    'string1' => "\n\r\t",
    'string2' => "\narf12",
    'string3' => '\n\r\t' // 単一引用符に注意してください。
);

foreach ($strings as $name => $testcase) {
    if (ctype_space($testcase)) {
        echo "The string '$name' consists of whitespace characters only.\n";
    } else {
        echo "The string '$name' contains non-whitespace characters.\n";
    }
}
?>

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

The string 'string1' consists of whitespace characters only.
The string 'string2' contains non-whitespace characters.
The string 'string3' contains non-whitespace characters.

参考

ctype_cntrl
ctype_graph
ctype_punct
IntlChar::isspace