is_real — Funktion · PHP-Referenz

Signatur

is_real(mixed $value): bool

Beschreibung

is_real() ist ein Alias der Funktion is_float() und gibt true zurück, wenn der übergebene Wert vom Typ float (Gleitkommazahl) ist. Ansonsten wird false zurückgegeben.

Die Funktion verhält sich in jeder Hinsicht identisch zu is_float() und is_double(), die ebenfalls als Aliasse existieren. Es empfiehlt sich, bevorzugt is_float() zu verwenden, da is_real() seit PHP 7.4 als deprecated (veraltet) markiert ist und ab PHP 8.0 offiziell nicht mehr empfohlen wird.

Typische Anwendungsfälle sind Eingabevalidierungen, bei denen sichergestellt werden muss, dass ein Wert tatsächlich eine Gleitkommazahl ist – etwa bei mathematischen Berechnungen oder bei der Verarbeitung von Messwerten und Preisen.

Gibt true zurück für Werte wie 1.5, 0.0, -3.14.
Gibt false zurück für int, string, bool, null und andere Typen.

Parameter

Name	Typ	Default	Beschreibung
$value Pflicht	mixed		Der zu prüfende Wert beliebigen Typs.

Rückgabewert

Typ

bool

Beschreibung

Gibt true zurück, wenn value vom Typ float ist, andernfalls false.

Beispiele

Grundlegende Typprüfung mit is_real()

<?php
$a = 3.14;
$b = 42;
$c = "3.14";

var_dump(is_real($a)); // true
var_dump(is_real($b)); // false
var_dump(is_real($c)); // false
var_dump(is_real(0.0)); // true
var_dump(is_real(INF)); // true

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

Eingabevalidierung vor einer Berechnung

<?php
function berechneKreisflaeche(mixed $radius): string {
    if (!is_real($radius) || $radius <= 0.0) {
        return "Ungültiger Radius: Es wird ein positiver Float erwartet.";
    }
    $flaeche = M_PI * $radius ** 2;
    return "Fläche: " . round($flaeche, 4);
}

echo berechneKreisflaeche(5.0) . PHP_EOL;
echo berechneKreisflaeche(3)   . PHP_EOL;
echo berechneKreisflaeche(-1.5) . PHP_EOL;

Fläche: 78.5398 Ungültiger Radius: Es wird ein positiver Float erwartet. Ungültiger Radius: Es wird ein positiver Float erwartet.

// Wichtig · Fallstricke

Deprecation-Hinweis: is_real() wurde in PHP 7.4 als veraltet (deprecated) markiert. Seit PHP 8.0 erzeugt die Verwendung eine Deprecation-Warnung. Ab PHP 8.4 wurde der Alias vollständig entfernt. Es sollte stattdessen is_float() verwendet werden, da diese Funktion semantisch identisch, aber zukunftssicher ist.

Beachte außerdem, dass spezielle Gleitkommazahlen wie INF (unendlich) und NAN (Not a Number) ebenfalls den Typ float haben und daher true zurückgeben.

Siehe auch

is_float is_double is_int is_numeric gettype floatval