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

PHPのIntlChar::isUUppercase()関数は、指定された文字がUnicodeの大文字（Uppercase）であるかどうかを判定するための関数です。国際化対応のアプリケーションで、文字種のチェックを行いたい場合に便利です。

基本構文

IntlChar::isUUppercase(val)

パラメータ

• val − 判定対象となる文字の値を指定します。UTF-8エンコードされた文字列として渡します。なお、この関数は単一の文字を想定しているため、複数文字の文字列を渡すとNULLが返される点に注意してください。

戻り値

指定した値がUnicodeの大文字である場合はTRUEを返し、大文字でない場合や記号・数字などの場合はFALSEを返します。また、引数として複数文字の文字列を渡した場合はNULLが返されます。

使用例

以下はIntlChar::isUUppercase()関数を使用した基本的なサンプルコードです。

<?php
    var_dump(IntlChar::isUUppercase("2"));
    echo "<br>";
    var_dump(IntlChar::isUUppercase("Jack"));
    echo "<br>";
    var_dump(IntlChar::isUUppercase("K"));
?>

出力結果

bool(false)
NULL
bool(true)

この例では、数字「2」は大文字ではないためfalse、複数文字の「Jack」を渡した場合は単一文字ではないためNULL、大文字の「K」は正しく判定されtrueが返されています。

別の使用例

続いて、記号・小文字・大文字それぞれの判定例を見てみましょう。

<?php
    var_dump(IntlChar::isUUppercase("*"));
    echo "<br>";
    var_dump(IntlChar::isUUppercase("n"));
    echo "<br>";
    var_dump(IntlChar::isUUppercase("D"));
?>

出力結果

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

記号「*」と小文字の「n」は大文字ではないためfalseが返り、大文字の「D」に対してはtrueが返されていることがわかります。

まとめ

IntlChar::isUUppercase()関数を使うことで、文字がUnicode上の大文字かどうかを簡単に判定できます。入力バリデーションやテキスト処理において、英字の大小判別が必要なケースで活用できるでしょう。ただし、引数には必ず単一の文字を渡すことを忘れないようにしましょう。