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

PHPのctype_space()関数とは

PHPのctype_space()関数は、指定した文字列がすべて空白文字（ホワイトスペース）で構成されているかどうかをチェックするための関数です。文字列内のすべての文字が何らかの空白文字に該当する場合はTRUEを返し、それ以外の場合はFALSEを返します。

ここでいう空白文字には、半角スペースだけでなく、タブ・垂直タブ・ラインフィード（LF）・キャリッジリターン（CR）・フォームフィードなどの制御文字も含まれます。

基本構文

ctype_space(str)

パラメータ

• str ─ チェック対象となる文字列を指定します。

戻り値

文字列内のすべての文字が空白文字（スペース、タブ、垂直タブ、改行、キャリッジリターン、フォームフィードなど）である場合にTRUEを、1つでも空白以外の文字が含まれている場合や空文字の場合はFALSEを返します。

使用例1：配列内の複数の値を判定する

以下は、配列内の各要素に対してctype_space()関数を使って判定を行うサンプルコードです。

<?php
$arr = array(' ', '\test123');
foreach ($arr as $demo) {
    if (ctype_space($demo)) {
        echo "$demo はすべて空白文字で構成されています。\n";
    } else {
        echo "$demo はすべてが空白文字ではありません。\n";
    }
}
?>

出力結果

 はすべて空白文字で構成されています。
\test123 はすべてが空白文字ではありません。

最初の要素「' '」は半角スペースのみのためTRUEと判定され、2つ目の「'\test123'」には空白以外の文字が含まれるためFALSEと判定されます。

使用例2：単一の文字列を判定する

<?php
$str = " ";
if (ctype_space($str))
    echo "空白文字です！！\n";
else
    echo "空白文字ではありません！\n";
?>

出力結果

空白文字です！！

注意点

• 空文字列（''）を渡した場合、常にFALSEが返されます。

• 全角スペース（U+3000）は空白文字として判定されない点に注意してください。ctype_space()は半角のASCII空白文字のみを対象とします。

• 引数には必ず文字列を指定してください。PHP 8以降では文字列以外の型を渡すとTypeErrorが発生します。