# ctype_upper

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

ctype_upper — 检测大写字符

### 说明

ctype_upper(mixed `$text`): bool

检测提供的 string 类型的 `text` 里面的所有字符是否都是大写字符。

### 参数

`text`

  要测试的字符串。

  > 注意:

  > 如果给出一个 -128 到 255 之间(含)的int, 将会被解释为该值对应的ASCII字符 (负值将加上 256 以支持扩展ASCII字符). 其它整数将会被解释为该值对应的十进制字符串.

  警告

  自 PHP 8.1.0 起，弃用传递非字符串参数。未来该参数将解释为字符串而不是 ASCII 码点。根据预期行为，应将参数转为字符串或显式调用 chr()。

### 返回值

如果在当前区域设置中 `text` 里的每个字符都是大写字母，那么就返回 `true`；否则返回 `false`。当使用空字符串调用时，结果始终为 `false`。

### 示例

示例 #1 ctype_upper() 示例（使用当前默认语言环境）

`<?php
$strings = array('AKLWC139', 'LMNSDO', 'akwSKWsm');
foreach ($strings as $testcase) {
if (ctype_upper($testcase)) {
echo "The string $testcase consists of all uppercase letters.\n";
} else {
echo "The string $testcase does not consist of all uppercase letters.\n";
}
}
?>`

以上示例会输出：

    The string AKLWC139 does not consist of all uppercase letters.
    The string LMNSDO consists of all uppercase letters.
    The string akwSKWsm does not consist of all uppercase letters.

### 参见

- ctype_alpha() - 检测字母字符
- ctype_lower() - 检测小写字符
- setlocale() - 设置区域信息
- IntlChar::isupper() - Check if code point has the general category "Lu" (uppercase letter)

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open