Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

round()

A função round devolve um float arredondado à precisão decimal pedida.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

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

A função round devolve um float arredondado à precisão decimal pedida. A precisão positiva conta casas decimais e a negativa arredonda às dezenas, centenas ou posições superiores. Por predefinição as metades exatas afastam-se de zero e HalfEven escolhe o vizinho par. O PHP 8.4 aceita casos RoundingMode e lança ValueError para um modo inteiro inválido.

Assinatura

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

Saída do exemplo

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

Exemplos

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

Resultado

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

Fontes