Math Functions
PHP Manual

round

(PHP 4, PHP 5)

roundRounds a float

Description

float round ( float $val [, int $precision= 0 [, int $mode= PHP_ROUND_HALF_UP ]] )

Returns the rounded value of val to specified precision (number of digits after the decimal point). precision can also be negative or zero (default).

Note: PHP doesn't handle strings like "12,300.2" correctly by default. See converting from strings.

Note: The precision parameter was introduced in PHP 4.

Parameters

val

The value to round

precision

The optional number of decimal digits to round to, defaults to 0

mode

One of PHP_ROUND_HALF_UP, PHP_ROUND_HALF_DOWN, PHP_ROUND_HALF_EVEN, or PHP_ROUND_HALF_ODD.

Return Values

The rounded value

Examples

Example #1 round() examples

<?php
echo round(3.4);         // 3
echo round(3.5);         // 4
echo round(3.6);         // 4
echo round(3.60);      // 4
echo round(1.955832);  // 1.96
echo round(1241757, -3); // 1242000
echo round(5.0452);    // 5.05
echo round(5.0552);    // 5.06
?>

Changelog

Version Description
5.3.0 The mode parameter was introduced.

See Also


Math Functions
PHP Manual