WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

round()

Die Funktion round liefert einen auf die angegebene Dezimalpräzision gerundeten float.

Version: PHP 8.4; repository runtime, production runtime not attested

Syntax

round(int|float $num, int $precision = 0, int|RoundingMode $mode = RoundingMode::HalfAwayFromZero): float

Die Funktion round liefert einen auf die angegebene Dezimalpräzision gerundeten float. Positive Präzision zählt Nachkommastellen und negative rundet auf Zehner, Hunderter oder höhere Stellen. Exakte Hälften werden standardmäßig von null weg gerundet und HalfEven wählt den geraden Nachbarn. PHP 8.4 akzeptiert RoundingMode-Fälle und wirft bei ungültigem ganzzahligem Modus ValueError.

Signatur

round(int|float $num, int $precision = 0, int|RoundingMode $mode = RoundingMode::HalfAwayFromZero): float

Ausgabe des Beispiels

[1.3,-1.3,2,100,"float"]
ValueError

Beispiele

<?php
echo json_encode([round(1.25, 1), round(-1.25, 1), round(2.5, 0, RoundingMode::HalfEven), round(149, -2), get_debug_type(round(2))]), PHP_EOL;
try { round(2.5, 0, 999); } catch (ValueError $e) { echo get_class($e); }

Ergebnis

[1.3,-1.3,2,100,"float"]
ValueError

Quellen