PHP round() Function

In this chapter you will learn:

  1. Definition for PHP round() Function
  2. Syntax for PHP round() Function
  3. Parameter for PHP round() Function
  4. Return for PHP round() Function
  5. Note for PHP round() Function
  6. Example - round value in PHP
  7. Example - Round value and set number of decimal places to keep
  8. Example - Round float with round mode

Definition

The round() function rounds a floating-point number to the nearest integer.

Syntax

PHP round() function has following syntax.

float round ( float num [, int precision] )

Parameter

ParameterIs Required Description
number Required.Value to round
precision Optional. Number of decimal digits to round to. Default is 0
modeOptional. Rounding mode:

The rounding mode value can the one of the following.

  • PHP_ROUND_HALF_UP - Default. Rounds number up to precision decimal, when it is half way there. Rounds 1.5 to 2 and -1.5 to -2
  • PHP_ROUND_HALF_DOWN - Round number down to precision decimal places, when it is half way there. Rounds 1.5 to 1 and -1.5 to -1
  • PHP_ROUND_HALF_EVEN - Round number to precision decimal places towards the next even value
  • PHP_ROUND_HALF_ODD - Round number to precision decimal places towards the next odd value

Return

Item Value
Return Value:The rounded value
Return Type:Float

Note

To round a number UP to the nearest integer, use the ceil() function.

To round a number DOWN to the nearest integer, use the floor() function.

Example

If a number is exactly halfway between two integers, round() will always round up. If you provide an integer, nothing will happen.


<?PHP/*j a  va 2  s. c  o m*/
$number = round(11.1); // 11 
print $number;
print("\n");
$number = round(11.9); // 12 
print $number;
print("\n");
$number = round(11.5); // 12 
print $number;
print("\n");
$number = round(11); // 11 
print $number;
print("\n");
?>

The code above generates the following result.

Example 2

You can also provide the number of decimal places to round to:


<?PHP/*from  j ava2  s. c  om*/
$a = round(4.4999); // 4 
print $a;
print("\n");
$b = round(4.123456, 3); // 4.123 
print $b;
print("\n");
$c = round(4.12345, 4); // 4.1235 
print $c;
print("\n");
$d = round(1000 / 160); // 6 
print $d;
?>

The code above generates the following result.

Example 3

Round numbers using the rounding mode constants:


<?php/*from   j ava 2  s. co m*/
echo(round(1.5,0,PHP_ROUND_HALF_UP) . "\n");
echo(round(-1.5,0,PHP_ROUND_HALF_UP) . "\n");

echo(round(1.5,0,PHP_ROUND_HALF_DOWN) . "\n");
echo(round(-1.5,0,PHP_ROUND_HALF_DOWN) . "\n");

echo(round(1.5,0,PHP_ROUND_HALF_EVEN) . "\n");
echo(round(-1.5,0,PHP_ROUND_HALF_EVEN) . "\n");

echo(round(1.5,0,PHP_ROUND_HALF_ODD) . "\n");
echo(round(-1.5,0,PHP_ROUND_HALF_ODD));
?>

The code above generates the following result.

Next chapter...

What you will learn in the next chapter:

  1. Definition for PHP sin() Function
  2. Syntax for PHP sin() Function
  3. Parameter for PHP sin() Function
  4. Return for PHP sin() Function
  5. Example - Return the sine of different numbers