Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

round()

Funkcja round zwraca float zaokrąglony do wskazanej precyzji dziesiętnej.

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

Składnia

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

Funkcja round zwraca float zaokrąglony do wskazanej precyzji dziesiętnej. Dodatnia precyzja liczy miejsca po przecinku, a ujemna zaokrągla do dziesiątek, setek lub wyższych pozycji. Domyślnie dokładne połowy są zaokrąglane od zera, a HalfEven wybiera parzystego sąsiada. PHP 8.4 przyjmuje warianty RoundingMode i zgłasza ValueError dla błędnego trybu liczbowego.

Sygnatura

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

Wynik przykładu

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

Przykłady

<?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); }

Wynik

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

Źródła