# ctype_upper

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

ctype_upper — Prüft auf Großbuchstaben

### Beschreibung

ctype_upper(mixed `$text`): bool

Prüft, ob alle Zeichen in `text` Großbuchstaben sind.

### Parameter-Liste

`text`

  Der zu prüfende String.

  > Hinweis:

  > Wenn ein int zwischen -128 und 255 (inklusive) übergeben wird, wird dieser als ASCII-Wert eines einzelnen Buchstabens interpretiert (zu negativen Werten wird 256 dazu addiert, um Buchstaben des erweiterten ASCII-Zeichensatzes zu erlauben). Alle anderen Integer werden wie eine Zeichenkette interpretiert, welche die dezimalen Ziffern des Integers enthält.

  Warnung

  Seit PHP 8.1.0 ist die Übergabe eines Nicht-String-Arguments veraltet. In Zukunft wird das Argument statt als ASCII-Codepunkt als String interpretiert werden. Je nach beabsichtigtem Verhalten sollte das Argument entweder in String umgewandelt werden, oder es sollte ein expliziter Aufruf von chr() erfolgen.

### Rückgabewerte

Gibt `true` zurück, wenn jedes Zeichen in `text` in der aktuellen Locale ein Großbuchstabe ist, sonst `false`. Bei einem Aufruf mit einer leeren Zeichenkette wird immer `false` zurückgegeben.

### Beispiele

Beispiel #1 ctype_upper()-Beispiel (unter Verwendung der Standard-Locale)

`<?php
$strings = array('AKLWC139', 'LMNSDO', 'akwSKWsm');
foreach ($strings as $testcase) {
if (ctype_upper($testcase)) {
echo "Der String $testcase besteht aus Großbochstaben.\n";
} else {
echo "Der String $testcase enthält nicht nur Großbuchstaben.\n";
}
}
?>`

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    Der String AKLWC139 enthält nicht nur Großbuchstaben.
    Der String LMNSDO besteht aus Großbuchstaben.
    Der String akwSKWsm enthält nicht nur Großbuchstaben.

### Siehe auch

- ctype_alpha() - Prüft auf Buchstabe(n)
- ctype_lower() - Prüft auf Kleinbuchstaben
- setlocale() - Legt regionale (locale) Einstellungen fest
- IntlChar::isupper() - Check if code point has the general category "Lu" (uppercase letter)

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