PHP RFC: Add 4 new rounding modes to round() function

• Date: 2023-08-31
• Target version: PHP 8.4
• Author: Jorg Sowa jorg.sowa@gmail.com
• Status: Under Discussion
• Implementation: https://github.com/php/php-src/pull/12056
• First Published at: http://wiki.php.net/rfc/new_rounding_modes_to_round_function

The RFC proposes to add 4 new modes to the round() function.

- PHP_ROUND_CEILING, - PHP_ROUND_FLOOR, - PHP_ROUND_AWAY_FROM_ZERO, - PHP_ROUND_TOWARD_ZERO.

Two first comments on the documentation page of the round() function are related to the missing modes of rounding. The first comment has a outstanding 309 votes.

Moreover, the NumberFormatter already implements 4 new proposed modes known as ROUND_CEILING, ROUND_FLOOR, ROUND_DOWN, ROUND_UP.

Adding 4 new constants for the rounding modes of function round():

- PHP_ROUND_CEILING - rounds num to the nearest integer bigger than num, - PHP_ROUND_FLOOR - rounds num to the nearest integer lower than num, - PHP_ROUND_AWAY_FROM_ZERO - rounds num away from zero, - PHP_ROUND_TOWARD_ZERO - rounds num towards zero.

None

8.4

The functions ceil() and floor() round numbers to the full integer, while the function round() roundes the number by given precision.

Such constants already exist in the NumberFormatter and represent rounding modes 'away from zero' and 'toward zero'. However the names rounding up and down are not straightforward and thus I restrained from using them.

As per the voting RFC a yes/no vote with a 2/3 majority is needed for this proposal to be accepted.

Voting started on 2023-09-x and will end on 2023-09-x.

GitHub pull request: https://github.com/php/php-src/pull/12056

Links to external references, discussions or RFCs

Keep this updated with features that were discussed on the mail lists.