PHPのctype_upper()関数とは？文字列がすべて大文字かどうかを判定する方法

PHPのctype_upper()関数は、指定した文字列に含まれるすべての文字が大文字（アルファベットの大文字）であるかどうかをチェックするための関数です。現在のロケール設定において、文字列内のすべての文字が大文字の場合に TRUE を返し、それ以外の場合は FALSE を返します。

なお、数字や記号は大文字とはみなされないため、文字列にこれらが含まれている場合も FALSE が返される点に注意してください。

構文

ctype_upper(str)

パラメータ

• str − 検証対象となる文字列を指定します。

戻り値

現在のロケールにおいて、文字列内のすべての文字が大文字である場合に TRUE を返します。小文字や数字、記号などが1つでも含まれていれば FALSE を返します。

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

以下は、配列に格納された複数の文字列に対して ctype_upper() 関数を使って判定を行う例です。

<?php
   $arr = array('9898jjhh', 'PQR', 'Amit');

   foreach ($arr as $demo) {
      if (ctype_upper($demo)) {
         echo "$demo has all uppercase letters. \n";
      } else {
         echo "$demo does not have all uppercase letters. \n";
      }
   }
?>

出力結果

9898jjhh does not have all uppercase letters.
PQR has all uppercase letters.
Amit does not have all uppercase letters.

この例では、「9898jjhh」には数字と小文字が含まれ、「Amit」には小文字が含まれているため FALSE となり、すべて大文字の「PQR」のみ TRUE と判定されています。

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

次に、単一の文字列がすべて大文字かどうかを確認するシンプルな例を見てみましょう。

<?php
   $str = 'AUSTRALIA';

   if (ctype_upper($str)) {
      echo "Word has all uppercase characters!\n";
   } else {
      // FALSE の場合の出力
      echo "Word does not have all uppercase characters!\n";
   }
?>

出力結果

Word has all uppercase characters!

「AUSTRALIA」はすべて大文字で構成されているため、TRUE が返され、該当するメッセージが出力されます。

まとめ

ctype_upper() 関数は、入力値のバリデーションやデータの正規化チェックなどにおいて便利な関数です。空文字列を渡した場合は FALSE が返されることにも留意し、必要に応じて他の ctype 系関数（ctype_alpha() や ctype_lower() など）と組み合わせて活用するとよいでしょう。