PHPのIntlChar::isJavaSpaceChar()関数の使い方を徹底解説

PHPのIntlChar::isJavaSpaceChar()関数は、入力された値がJavaの規約（JavaのCharacter.isSpaceChar()メソッドと同等の基準）に従って空白文字であるかどうかを判定するために使用される関数です。国際化対応の文字列処理を行う際に、Unicode文字の種類を確認するケースで役立ちます。

構文

IntlChar::isJavaSpaceChar(val)

パラメータ

• val − 判定対象となる文字値。UTF-8エンコードされた文字列として指定します。単一の文字だけでなく、コードポイントの整数値を渡すことも可能です。

戻り値

IntlChar::isJavaSpaceChar()関数は、引数valがJavaの規約における空白文字である場合にTRUE（bool(true)）を返します。空白文字でない場合はFALSE（bool(false)）を返します。

なお、空文字や複数文字からなる文字列など、有効な単一のコードポイントとして評価できない値が渡された場合はNULLが返される点に注意が必要です。

使用例

以下に、IntlChar::isJavaSpaceChar()関数の具体的な使用例を示します。

<?php
   var_dump(IntlChar::isJavaSpaceChar(""));
   echo "<br>";
   var_dump(IntlChar::isJavaSpaceChar("!"));
   echo "<br>";
   var_dump(IntlChar::isJavaSpaceChar(" "));
   echo "<br>";
   var_dump(IntlChar::isJavaSpaceChar("K"));
   echo "<br>";
   var_dump(IntlChar::isJavaSpaceChar("Kite!"));
   echo "<br>";
?>

出力結果

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

NULL
bool(false)
bool(true)
bool(false)
NULL

出力結果の解説

• 空文字（""）：有効なコードポイントとして評価できないため、NULLが返されます。

• 感嘆符（"!"）：記号であり空白文字ではないため、bool(false)が返されます。

• 半角スペース（" "）：Javaの規約における空白文字に該当するため、bool(true)が返されます。

• 英字（"K"）：アルファベットの文字であり空白文字ではないため、bool(false)が返されます。

• 複数文字の文字列（"Kite!"）：単一のコードポイントではないため、NULLが返されます。

このように、IntlChar::isJavaSpaceChar()関数を使用することで、Unicode文字がJavaの基準で空白文字に分類されるかどうかを簡単にプログラム上で判定できます。