RFC: Integer rounding#12301

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
marc-mabe wants to merge 3 commits into from
Closed

RFC: Integer rounding #12301

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
db98d1d
ceil/floor/round keeps given int type if possible
marc-mabe Jun 14, 2023
2483a75
UNEXPECTED conditions
marc-mabe Sep 26, 2023
f9ae196
Update link to RFC
marc-mabe Sep 26, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions ext/standard/basic_functions.stub.php
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -3069,13 +3069,13 @@ function mail(string $to, string $subject, string $message, array|string $additi
function abs(int|float $num): int|float {}

/** @compile-time-eval */
function ceil(int|float $num): float {}
function ceil(int|float $num): int|float {}

/** @compile-time-eval */
function floor(int|float $num): float {}
function floor(int|float $num): int|float {}
Comment on lines 3071 to 3075

@GirgiasGirgiasSep 26, 2023

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?

Also, $num to be of type int doesn't make any sense, as the function is a no-op in this case.

@GirgiasGirgiasSep 26, 2023

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wait... that's already a bug in the stubs.
This needs to be backported to 8.1.

@TimWollaTimWollaSep 26, 2023

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?

flooring 2.5e300 should be legal and the result is only representable as float.

@marc-mabemarc-mabeSep 26, 2023

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This RFC proposes to keep the given type if possible.

  • float given -> float returned (guarantied)
  • int given -> int returned (except for int overflow on round with precision < 0)


/** @compile-time-eval */
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): float {}
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): int|float {}
Comment thread
TimWolla marked this conversation as resolved.

/** @compile-time-eval */
function sin(float $num): float {}
Expand Down
10 changes: 4 additions & 6 deletions ext/standard/basic_functions_arginfo.h
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

115 changes: 109 additions & 6 deletions ext/standard/math.c
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -164,7 +164,7 @@ static inline double php_round_helper(double value, int mode) {

/* {{{ _php_math_round */
/*
* Rounds a number to a certain number of decimal places in a certain rounding
* Rounds a floating point to a certain number of decimal places in a certain rounding
* mode. For the specifics of the algorithm, see http://wiki.php.net/rfc/rounding
*/
PHPAPI double _php_math_round(double value, int places, int mode) {
Expand DownExpand Up@@ -249,6 +249,108 @@ PHPAPI double _php_math_round(double value, int places, int mode) {
}
/* }}} */

/* {{{ _php_math_round_long */
/*
* Rounds a zend_long to a certain number of decimal places in a certain rounding
* mode. For the specifics of the algorithm, see https://wiki.php.net/rfc/integer-rounding
*/
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result) {

@TimWollaTimWollaSep 29, 2023

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Frankly I find this implementation incomprehensible. I've specifically refactored the floating point implementation to leverage a switch statement with very simple logic to make the code easier to verify for correctness in #12220.

This pattern should likely also be applied here. It also doesn't help that the logic is effectively duplicated for the “above zero” and “below zero” cases.

@marc-mabemarc-mabeSep 30, 2023

Copy link
Copy Markdown
ContributorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Tim,
This is a first working version actually started before #12220 and as such I was following the previous style.
But you are right this can and should be improved. If the RFC gets accepted I'll update the PR according.

static const zend_long powers[] = {
1, 10, 100, 1000, 10000,
100000, 1000000, 10000000, 100000000, 1000000000,
#if SIZEOF_ZEND_LONG >= 8
10000000000, 100000000000, 1000000000000, 10000000000000, 100000000000000,
1000000000000000, 10000000000000000, 100000000000000000, 1000000000000000000
#elif SIZEOF_ZEND_LONG > 8
# error "Unknown SIZEOF_ZEND_LONG"
#endif
};

zend_long tmp_value = value;
zend_long power;
zend_long power_half;
zend_long rest;

// Boolean if the number of places used matches the number of places possible
int max_places = 0;

// Simple case - long that does not need to be rounded
if (places >= 0) {
*result = tmp_value;
return SUCCESS;
}

if (UNEXPECTED(-places > sizeof(powers) / sizeof(powers[0]) - 1)) {
// Special case for rounding to the same number of places as max length possible
// as this would overflow the power of 10
if (places == -MAX_LENGTH_OF_LONG + 1) {
max_places = 1;
rest = tmp_value;
tmp_value = 0;
power_half = powers[-places - 1] * 5;
} else {
// Rounding more places will always be zero
*result = 0;
return SUCCESS;
}
} else {
power = powers[-places];
rest = tmp_value % power;
power_half = power / 2;
tmp_value = tmp_value / power;
}

if (value >= 0) {
if ((mode == PHP_ROUND_HALF_UP && rest >= power_half)
|| (mode == PHP_ROUND_HALF_DOWN && rest > power_half)
|| (mode == PHP_ROUND_HALF_EVEN && (rest > power_half || (rest == power_half && tmp_value % 2 == 1)))
|| (mode == PHP_ROUND_HALF_ODD && (rest > power_half || (rest == power_half && tmp_value % 2 == 0)))
) {
if (UNEXPECTED(max_places)) {
return FAILURE; // would overflow
}

tmp_value = tmp_value * power;

if (UNEXPECTED(tmp_value > ZEND_LONG_MAX - power)) {
return FAILURE; // would overflow
}
tmp_value = tmp_value + power;
} else if (UNEXPECTED(max_places)) {
tmp_value = 0;
} else {
tmp_value = tmp_value * power;
}
} else {
if ((mode == PHP_ROUND_HALF_UP && rest <= -power_half)
|| (mode == PHP_ROUND_HALF_DOWN && rest < -power_half)
|| (mode == PHP_ROUND_HALF_EVEN && (rest < -power_half || (rest == -power_half && tmp_value % 2 == -1)))
|| (mode == PHP_ROUND_HALF_ODD && (rest < -power_half || (rest == -power_half && tmp_value % 2 == 0)))
) {
if (UNEXPECTED(max_places)) {
return FAILURE; // would underflow
}

tmp_value = tmp_value * power;

if (UNEXPECTED(tmp_value < ZEND_LONG_MIN + power)) {
return FAILURE; // would underflow
}

tmp_value = tmp_value - power;
} else if (UNEXPECTED(max_places)) {
tmp_value = 0;
} else {
tmp_value = tmp_value * power;
}
}

*result = tmp_value;
return SUCCESS;
}
/* }}} */


/* {{{ Return the absolute value of the number */
PHP_FUNCTION(abs)
{
Expand DownExpand Up@@ -283,7 +385,7 @@ PHP_FUNCTION(ceil)

switch (Z_TYPE_P(value)) {
case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
case IS_DOUBLE:
RETURN_DOUBLE(ceil(Z_DVAL_P(value)));
EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -302,7 +404,7 @@ PHP_FUNCTION(floor)

switch (Z_TYPE_P(value)) {
case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
case IS_DOUBLE:
RETURN_DOUBLE(floor(Z_DVAL_P(value)));
EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -317,6 +419,7 @@ PHP_FUNCTION(round)
int places = 0;
zend_long precision = 0;
zend_long mode = PHP_ROUND_HALF_UP;
zend_long return_val_l;

@bukkabukkaOct 13, 2023

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use preferable some better name rather than something ending with just l (e.g. something like return_long_val or return_lval)


ZEND_PARSE_PARAMETERS_START(1, 3)
Z_PARAM_NUMBER(value)
Expand DownExpand Up@@ -346,10 +449,10 @@ PHP_FUNCTION(round)

switch (Z_TYPE_P(value)) {
case IS_LONG:
/* Simple case - long that doesn't need to be rounded. */
if (places >= 0) {
RETURN_DOUBLE(zval_get_double(value));
if (_php_math_round_long(Z_LVAL_P(value), places, (int)mode, &return_val_l) == SUCCESS) {
RETURN_LONG(return_val_l);
}

ZEND_FALLTHROUGH;

case IS_DOUBLE:
Expand Down
1 change: 1 addition & 0 deletions ext/standard/php_math.h
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@
#define PHP_MATH_H

PHPAPI double _php_math_round(double value, int places, int mode);
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result);
PHPAPI zend_string *_php_math_number_format(double d, int dec, char dec_point, char thousand_sep);
PHPAPI zend_string *_php_math_number_format_ex(double d, int dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
PHPAPI zend_string *_php_math_number_format_long(zend_long num, zend_long dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
Expand Down
22 changes: 15 additions & 7 deletions ext/standard/tests/math/ceil_basic.phpt
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -7,10 +7,14 @@ precision=14
echo "*** Testing ceil() : basic functionality ***\n";
$values = array(0,
-0,
0.0,
-0.0,
0.5,
-0.5,
1,
-1,
1.0,
-1.0,
1.5,
-1.5,
2.6,
Expand All@@ -35,25 +39,29 @@ for ($i = 0; $i < count($values); $i++) {
?>
--EXPECTF--
*** Testing ceil() : basic functionality ***
int(0)
int(0)
float(0)
float(0)
float(-0)
float(1)
float(-0)
int(1)
int(-1)
float(1)
float(-1)
float(2)
float(-1)
float(3)
float(-2)
float(31)
float(95)
int(31)
int(95)
float(11)
float(-10)
float(3950)
float(-3950)
float(39)
float(1)
float(0)
int(39)
int(1)
int(0)

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)
26 changes: 13 additions & 13 deletions ext/standard/tests/math/ceil_basiclong_64bit.phpt
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -27,32 +27,32 @@ foreach ($longVals as $longVal) {
?>
--EXPECT--
--- testing: 9223372036854775807 ---
float(9.223372036854776E+18)
int(9223372036854775807)
--- testing: -9223372036854775808 ---
float(-9.223372036854776E+18)
int(-9223372036854775808)
--- testing: 2147483647 ---
float(2147483647)
int(2147483647)
--- testing: -2147483648 ---
float(-2147483648)
int(-2147483648)
--- testing: 9223372034707292160 ---
float(9.223372034707292E+18)
int(9223372034707292160)
--- testing: -9223372034707292160 ---
float(-9.223372034707292E+18)
int(-9223372034707292160)
--- testing: 2147483648 ---
float(2147483648)
int(2147483648)
--- testing: -2147483649 ---
float(-2147483649)
int(-2147483649)
--- testing: 4294967294 ---
float(4294967294)
int(4294967294)
--- testing: 4294967295 ---
float(4294967295)
int(4294967295)
--- testing: 4294967293 ---
float(4294967293)
int(4294967293)
--- testing: 9223372036854775806 ---
float(9.223372036854776E+18)
int(9223372036854775806)
--- testing: 9.2233720368548E+18 ---
float(9.223372036854776E+18)
--- testing: -9223372036854775807 ---
float(-9.223372036854776E+18)
int(-9223372036854775807)
--- testing: -9.2233720368548E+18 ---
float(-9.223372036854776E+18)
16 changes: 8 additions & 8 deletions ext/standard/tests/math/ceil_variation1.phpt
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -77,24 +77,24 @@ fclose($fp);
-- Iteration 1 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 2 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 3 --
float(1)
int(1)

-- Iteration 4 --
float(0)
int(0)

-- Iteration 5 --
float(1)
int(1)

-- Iteration 6 --
float(0)
int(0)

-- Iteration 7 --
ceil(): Argument #1 ($num) must be of type int|float, string given
Expand All@@ -120,12 +120,12 @@ ceil(): Argument #1 ($num) must be of type int|float, classA given
-- Iteration 14 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 15 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 16 --
ceil(): Argument #1 ($num) must be of type int|float, resource given
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
RFC: Integer rounding#12301

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

marc-mabe
wants to merge
3
commits into

from

 Closed


RFC: Integer rounding
#12301
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
db98d1d

ceil/floor/round keeps given int type if possible


marc-mabe Jun 14, 2023
2483a75

UNEXPECTED conditions


marc-mabe Sep 26, 2023
f9ae196

Update link to RFC


marc-mabe Sep 26, 2023

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


6 changes: 3 additions & 3 deletions
ext/standard/basic_functions.stub.php

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -3069,13 +3069,13 @@ function mail(string $to, string $subject, string $message, array|string $additi
function abs(int|float $num): int|float {}

/** @compile-time-eval */
function ceil(int|float $num): float {}
function ceil(int|float $num): int|float {}

/** @compile-time-eval */
function floor(int|float $num): float {}
function floor(int|float $num): int|float {}

Comment on lines

3071
 to 
3075

@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
Also, $num to be of type int doesn't make any sense, as the function is a no-op in this case.
@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wait... that's already a bug in the stubs.

This needs to be backported to 8.1.
@TimWollaTimWollaSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
flooring 2.5e300 should be legal and the result is only representable as float.
@marc-mabemarc-mabeSep 26, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This RFC proposes to keep the given type if possible.
  • float given -> float returned (guarantied)
  • int given -> int returned (except for int overflow on round with precision < 0)

/** @compile-time-eval */
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): float {}
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): int|float {}
Comment thread
TimWolla marked this conversation as resolved.


/** @compile-time-eval */
function sin(float $num): float {}
Expand Down

10 changes: 4 additions & 6 deletions
ext/standard/basic_functions_arginfo.h

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


115 changes: 109 additions & 6 deletions
ext/standard/math.c

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -164,7 +164,7 @@ static inline double php_round_helper(double value, int mode) {

/* {{{ _php_math_round */
/*
 * Rounds a number to a certain number of decimal places in a certain rounding
 * Rounds a floating point to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see http://wiki.php.net/rfc/rounding
 */
PHPAPI double _php_math_round(double value, int places, int mode) {
Expand DownExpand Up@@ -249,6 +249,108 @@ PHPAPI double _php_math_round(double value, int places, int mode) {
}
/* }}} */

/* {{{ _php_math_round_long */
/*
 * Rounds a zend_long to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see https://wiki.php.net/rfc/integer-rounding
 */
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result) {
@TimWollaTimWollaSep 29, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Frankly I find this implementation incomprehensible. I've specifically refactored the floating point implementation to leverage a switch statement with very simple logic to make the code easier to verify for correctness in #12220.
This pattern should likely also be applied here. It also doesn't help that the logic is effectively duplicated for the “above zero” and “below zero” cases.
@marc-mabemarc-mabeSep 30, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Tim,

This is a first working version actually started before #12220 and as such I was following the previous style.

But you are right this can and should be improved. If the RFC gets accepted I'll update the PR according.
	static const zend_long powers[] = {
 1, 10, 100, 1000, 10000,
 100000, 1000000, 10000000, 100000000, 1000000000,
#if SIZEOF_ZEND_LONG >= 8
 10000000000, 100000000000, 1000000000000, 10000000000000, 100000000000000,
 1000000000000000, 10000000000000000, 100000000000000000, 1000000000000000000
#elif SIZEOF_ZEND_LONG > 8
# error "Unknown SIZEOF_ZEND_LONG"
#endif
 };

	zend_long tmp_value = value;
	zend_long power;
	zend_long power_half;
	zend_long rest;

	// Boolean if the number of places used matches the number of places possible
	int max_places = 0;

	// Simple case - long that does not need to be rounded
	if (places >= 0) {
 *result = tmp_value;
 return SUCCESS;
	}

	if (UNEXPECTED(-places > sizeof(powers) / sizeof(powers[0]) - 1)) {
 // Special case for rounding to the same number of places as max length possible
 // as this would overflow the power of 10
 if (places == -MAX_LENGTH_OF_LONG + 1) {
 max_places = 1;
 rest = tmp_value;
 tmp_value = 0;
 power_half = powers[-places - 1] * 5;
 } else {
 // Rounding more places will always be zero
 *result = 0;
 return SUCCESS;
 }
	} else {
 power = powers[-places];
 rest = tmp_value % power;
 power_half = power / 2;
 tmp_value = tmp_value / power;
	}

	if (value >= 0) {
 if ((mode == PHP_ROUND_HALF_UP && rest >= power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest > power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest > power_half || (rest == power_half && tmp_value % 2 == 1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest > power_half || (rest == power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would overflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value > ZEND_LONG_MAX - power)) {
 return FAILURE; // would overflow
 }
 tmp_value = tmp_value + power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	} else {
 if ((mode == PHP_ROUND_HALF_UP && rest <= -power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest < -power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest < -power_half || (rest == -power_half && tmp_value % 2 == -1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest < -power_half || (rest == -power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value < ZEND_LONG_MIN + power)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value - power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	}

	*result = tmp_value;
	return SUCCESS;
}
/* }}} */


/* {{{ Return the absolute value of the number */
PHP_FUNCTION(abs)
{
Expand DownExpand Up@@ -283,7 +385,7 @@ PHP_FUNCTION(ceil)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(ceil(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -302,7 +404,7 @@ PHP_FUNCTION(floor)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(floor(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -317,6 +419,7 @@ PHP_FUNCTION(round)
	int places = 0;
	zend_long precision = 0;
	zend_long mode = PHP_ROUND_HALF_UP;
	zend_long return_val_l;
@bukkabukkaOct 13, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use preferable some better name rather than something ending with just l (e.g. something like return_long_val or return_lval)

	ZEND_PARSE_PARAMETERS_START(1, 3)
 Z_PARAM_NUMBER(value)
Expand DownExpand Up@@ -346,10 +449,10 @@ PHP_FUNCTION(round)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
 /* Simple case - long that doesn't need to be rounded. */
 if (places >= 0) {
 RETURN_DOUBLE(zval_get_double(value));
 if (_php_math_round_long(Z_LVAL_P(value), places, (int)mode, &return_val_l) == SUCCESS) {
 RETURN_LONG(return_val_l);
 }

 ZEND_FALLTHROUGH;

 case IS_DOUBLE:
Expand Down

1 change: 1 addition & 0 deletions
ext/standard/php_math.h

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@
#define PHP_MATH_H

PHPAPI double _php_math_round(double value, int places, int mode);
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result);
PHPAPI zend_string *_php_math_number_format(double d, int dec, char dec_point, char thousand_sep);
PHPAPI zend_string *_php_math_number_format_ex(double d, int dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
PHPAPI zend_string *_php_math_number_format_long(zend_long num, zend_long dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
Expand Down

22 changes: 15 additions & 7 deletions
ext/standard/tests/math/ceil_basic.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -7,10 +7,14 @@ precision=14
echo "*** Testing ceil() : basic functionality ***\n";
$values = array(0,
 -0,
 0.0,
 -0.0,
 0.5,
 -0.5,
 1,
 -1,
 1.0,
 -1.0,
 1.5,
 -1.5,
 2.6,
Expand All@@ -35,25 +39,29 @@ for ($i = 0; $i < count($values); $i++) {
?>
--EXPECTF--
*** Testing ceil() : basic functionality ***
int(0)
int(0)
float(0)
float(0)
float(-0)
float(1)
float(-0)
int(1)
int(-1)
float(1)
float(-1)
float(2)
float(-1)
float(3)
float(-2)
float(31)
float(95)
int(31)
int(95)
float(11)
float(-10)
float(3950)
float(-3950)
float(39)
float(1)
float(0)
int(39)
int(1)
int(0)

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

26 changes: 13 additions & 13 deletions
ext/standard/tests/math/ceil_basiclong_64bit.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -27,32 +27,32 @@ foreach ($longVals as $longVal) {
?>
--EXPECT--
--- testing: 9223372036854775807 ---
float(9.223372036854776E+18)
int(9223372036854775807)
--- testing: -9223372036854775808 ---
float(-9.223372036854776E+18)
int(-9223372036854775808)
--- testing: 2147483647 ---
float(2147483647)
int(2147483647)
--- testing: -2147483648 ---
float(-2147483648)
int(-2147483648)
--- testing: 9223372034707292160 ---
float(9.223372034707292E+18)
int(9223372034707292160)
--- testing: -9223372034707292160 ---
float(-9.223372034707292E+18)
int(-9223372034707292160)
--- testing: 2147483648 ---
float(2147483648)
int(2147483648)
--- testing: -2147483649 ---
float(-2147483649)
int(-2147483649)
--- testing: 4294967294 ---
float(4294967294)
int(4294967294)
--- testing: 4294967295 ---
float(4294967295)
int(4294967295)
--- testing: 4294967293 ---
float(4294967293)
int(4294967293)
--- testing: 9223372036854775806 ---
float(9.223372036854776E+18)
int(9223372036854775806)
--- testing: 9.2233720368548E+18 ---
float(9.223372036854776E+18)
--- testing: -9223372036854775807 ---
float(-9.223372036854776E+18)
int(-9223372036854775807)
--- testing: -9.2233720368548E+18 ---
float(-9.223372036854776E+18)

16 changes: 8 additions & 8 deletions
ext/standard/tests/math/ceil_variation1.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -77,24 +77,24 @@ fclose($fp);
-- Iteration 1 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 2 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 3 --
float(1)
int(1)

-- Iteration 4 --
float(0)
int(0)

-- Iteration 5 --
float(1)
int(1)

-- Iteration 6 --
float(0)
int(0)

-- Iteration 7 --
ceil(): Argument #1 ($num) must be of type int|float, string given
Expand All@@ -120,12 +120,12 @@ ceil(): Argument #1 ($num) must be of type int|float, classA given
-- Iteration 14 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 15 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 16 --
ceil(): Argument #1 ($num) must be of type int|float, resource given
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
RFC: Integer rounding#12301

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

marc-mabe
wants to merge
3
commits into

from

 Closed


RFC: Integer rounding
#12301
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
db98d1d

ceil/floor/round keeps given int type if possible


marc-mabe Jun 14, 2023
2483a75

UNEXPECTED conditions


marc-mabe Sep 26, 2023
f9ae196

Update link to RFC


marc-mabe Sep 26, 2023

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


6 changes: 3 additions & 3 deletions
ext/standard/basic_functions.stub.php

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -3069,13 +3069,13 @@ function mail(string $to, string $subject, string $message, array|string $additi
function abs(int|float $num): int|float {}

/** @compile-time-eval */
function ceil(int|float $num): float {}
function ceil(int|float $num): int|float {}

/** @compile-time-eval */
function floor(int|float $num): float {}
function floor(int|float $num): int|float {}

Comment on lines

3071
 to 
3075

@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
Also, $num to be of type int doesn't make any sense, as the function is a no-op in this case.
@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wait... that's already a bug in the stubs.

This needs to be backported to 8.1.
@TimWollaTimWollaSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
flooring 2.5e300 should be legal and the result is only representable as float.
@marc-mabemarc-mabeSep 26, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This RFC proposes to keep the given type if possible.
  • float given -> float returned (guarantied)
  • int given -> int returned (except for int overflow on round with precision < 0)

/** @compile-time-eval */
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): float {}
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): int|float {}
Comment thread
TimWolla marked this conversation as resolved.


/** @compile-time-eval */
function sin(float $num): float {}
Expand Down

10 changes: 4 additions & 6 deletions
ext/standard/basic_functions_arginfo.h

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


115 changes: 109 additions & 6 deletions
ext/standard/math.c

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -164,7 +164,7 @@ static inline double php_round_helper(double value, int mode) {

/* {{{ _php_math_round */
/*
 * Rounds a number to a certain number of decimal places in a certain rounding
 * Rounds a floating point to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see http://wiki.php.net/rfc/rounding
 */
PHPAPI double _php_math_round(double value, int places, int mode) {
Expand DownExpand Up@@ -249,6 +249,108 @@ PHPAPI double _php_math_round(double value, int places, int mode) {
}
/* }}} */

/* {{{ _php_math_round_long */
/*
 * Rounds a zend_long to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see https://wiki.php.net/rfc/integer-rounding
 */
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result) {
@TimWollaTimWollaSep 29, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Frankly I find this implementation incomprehensible. I've specifically refactored the floating point implementation to leverage a switch statement with very simple logic to make the code easier to verify for correctness in #12220.
This pattern should likely also be applied here. It also doesn't help that the logic is effectively duplicated for the “above zero” and “below zero” cases.
@marc-mabemarc-mabeSep 30, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Tim,

This is a first working version actually started before #12220 and as such I was following the previous style.

But you are right this can and should be improved. If the RFC gets accepted I'll update the PR according.
	static const zend_long powers[] = {
 1, 10, 100, 1000, 10000,
 100000, 1000000, 10000000, 100000000, 1000000000,
#if SIZEOF_ZEND_LONG >= 8
 10000000000, 100000000000, 1000000000000, 10000000000000, 100000000000000,
 1000000000000000, 10000000000000000, 100000000000000000, 1000000000000000000
#elif SIZEOF_ZEND_LONG > 8
# error "Unknown SIZEOF_ZEND_LONG"
#endif
 };

	zend_long tmp_value = value;
	zend_long power;
	zend_long power_half;
	zend_long rest;

	// Boolean if the number of places used matches the number of places possible
	int max_places = 0;

	// Simple case - long that does not need to be rounded
	if (places >= 0) {
 *result = tmp_value;
 return SUCCESS;
	}

	if (UNEXPECTED(-places > sizeof(powers) / sizeof(powers[0]) - 1)) {
 // Special case for rounding to the same number of places as max length possible
 // as this would overflow the power of 10
 if (places == -MAX_LENGTH_OF_LONG + 1) {
 max_places = 1;
 rest = tmp_value;
 tmp_value = 0;
 power_half = powers[-places - 1] * 5;
 } else {
 // Rounding more places will always be zero
 *result = 0;
 return SUCCESS;
 }
	} else {
 power = powers[-places];
 rest = tmp_value % power;
 power_half = power / 2;
 tmp_value = tmp_value / power;
	}

	if (value >= 0) {
 if ((mode == PHP_ROUND_HALF_UP && rest >= power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest > power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest > power_half || (rest == power_half && tmp_value % 2 == 1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest > power_half || (rest == power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would overflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value > ZEND_LONG_MAX - power)) {
 return FAILURE; // would overflow
 }
 tmp_value = tmp_value + power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	} else {
 if ((mode == PHP_ROUND_HALF_UP && rest <= -power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest < -power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest < -power_half || (rest == -power_half && tmp_value % 2 == -1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest < -power_half || (rest == -power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value < ZEND_LONG_MIN + power)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value - power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	}

	*result = tmp_value;
	return SUCCESS;
}
/* }}} */


/* {{{ Return the absolute value of the number */
PHP_FUNCTION(abs)
{
Expand DownExpand Up@@ -283,7 +385,7 @@ PHP_FUNCTION(ceil)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(ceil(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -302,7 +404,7 @@ PHP_FUNCTION(floor)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(floor(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -317,6 +419,7 @@ PHP_FUNCTION(round)
	int places = 0;
	zend_long precision = 0;
	zend_long mode = PHP_ROUND_HALF_UP;
	zend_long return_val_l;
@bukkabukkaOct 13, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use preferable some better name rather than something ending with just l (e.g. something like return_long_val or return_lval)

	ZEND_PARSE_PARAMETERS_START(1, 3)
 Z_PARAM_NUMBER(value)
Expand DownExpand Up@@ -346,10 +449,10 @@ PHP_FUNCTION(round)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
 /* Simple case - long that doesn't need to be rounded. */
 if (places >= 0) {
 RETURN_DOUBLE(zval_get_double(value));
 if (_php_math_round_long(Z_LVAL_P(value), places, (int)mode, &return_val_l) == SUCCESS) {
 RETURN_LONG(return_val_l);
 }

 ZEND_FALLTHROUGH;

 case IS_DOUBLE:
Expand Down

1 change: 1 addition & 0 deletions
ext/standard/php_math.h

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@
#define PHP_MATH_H

PHPAPI double _php_math_round(double value, int places, int mode);
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result);
PHPAPI zend_string *_php_math_number_format(double d, int dec, char dec_point, char thousand_sep);
PHPAPI zend_string *_php_math_number_format_ex(double d, int dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
PHPAPI zend_string *_php_math_number_format_long(zend_long num, zend_long dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
Expand Down

22 changes: 15 additions & 7 deletions
ext/standard/tests/math/ceil_basic.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -7,10 +7,14 @@ precision=14
echo "*** Testing ceil() : basic functionality ***\n";
$values = array(0,
 -0,
 0.0,
 -0.0,
 0.5,
 -0.5,
 1,
 -1,
 1.0,
 -1.0,
 1.5,
 -1.5,
 2.6,
Expand All@@ -35,25 +39,29 @@ for ($i = 0; $i < count($values); $i++) {
?>
--EXPECTF--
*** Testing ceil() : basic functionality ***
int(0)
int(0)
float(0)
float(0)
float(-0)
float(1)
float(-0)
int(1)
int(-1)
float(1)
float(-1)
float(2)
float(-1)
float(3)
float(-2)
float(31)
float(95)
int(31)
int(95)
float(11)
float(-10)
float(3950)
float(-3950)
float(39)
float(1)
float(0)
int(39)
int(1)
int(0)

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

26 changes: 13 additions & 13 deletions
ext/standard/tests/math/ceil_basiclong_64bit.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -27,32 +27,32 @@ foreach ($longVals as $longVal) {
?>
--EXPECT--
--- testing: 9223372036854775807 ---
float(9.223372036854776E+18)
int(9223372036854775807)
--- testing: -9223372036854775808 ---
float(-9.223372036854776E+18)
int(-9223372036854775808)
--- testing: 2147483647 ---
float(2147483647)
int(2147483647)
--- testing: -2147483648 ---
float(-2147483648)
int(-2147483648)
--- testing: 9223372034707292160 ---
float(9.223372034707292E+18)
int(9223372034707292160)
--- testing: -9223372034707292160 ---
float(-9.223372034707292E+18)
int(-9223372034707292160)
--- testing: 2147483648 ---
float(2147483648)
int(2147483648)
--- testing: -2147483649 ---
float(-2147483649)
int(-2147483649)
--- testing: 4294967294 ---
float(4294967294)
int(4294967294)
--- testing: 4294967295 ---
float(4294967295)
int(4294967295)
--- testing: 4294967293 ---
float(4294967293)
int(4294967293)
--- testing: 9223372036854775806 ---
float(9.223372036854776E+18)
int(9223372036854775806)
--- testing: 9.2233720368548E+18 ---
float(9.223372036854776E+18)
--- testing: -9223372036854775807 ---
float(-9.223372036854776E+18)
int(-9223372036854775807)
--- testing: -9.2233720368548E+18 ---
float(-9.223372036854776E+18)

16 changes: 8 additions & 8 deletions
ext/standard/tests/math/ceil_variation1.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -77,24 +77,24 @@ fclose($fp);
-- Iteration 1 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 2 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 3 --
float(1)
int(1)

-- Iteration 4 --
float(0)
int(0)

-- Iteration 5 --
float(1)
int(1)

-- Iteration 6 --
float(0)
int(0)

-- Iteration 7 --
ceil(): Argument #1 ($num) must be of type int|float, string given
Expand All@@ -120,12 +120,12 @@ ceil(): Argument #1 ($num) must be of type int|float, classA given
-- Iteration 14 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 15 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 16 --
ceil(): Argument #1 ($num) must be of type int|float, resource given
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
RFC: Integer rounding#12301

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

marc-mabe
wants to merge
3
commits into

from

 Closed


RFC: Integer rounding
#12301
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
db98d1d

ceil/floor/round keeps given int type if possible


marc-mabe Jun 14, 2023
2483a75

UNEXPECTED conditions


marc-mabe Sep 26, 2023
f9ae196

Update link to RFC


marc-mabe Sep 26, 2023

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


6 changes: 3 additions & 3 deletions
ext/standard/basic_functions.stub.php

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -3069,13 +3069,13 @@ function mail(string $to, string $subject, string $message, array|string $additi
function abs(int|float $num): int|float {}

/** @compile-time-eval */
function ceil(int|float $num): float {}
function ceil(int|float $num): int|float {}

/** @compile-time-eval */
function floor(int|float $num): float {}
function floor(int|float $num): int|float {}

Comment on lines

3071
 to 
3075

@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
Also, $num to be of type int doesn't make any sense, as the function is a no-op in this case.
@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wait... that's already a bug in the stubs.

This needs to be backported to 8.1.
@TimWollaTimWollaSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
flooring 2.5e300 should be legal and the result is only representable as float.
@marc-mabemarc-mabeSep 26, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This RFC proposes to keep the given type if possible.
  • float given -> float returned (guarantied)
  • int given -> int returned (except for int overflow on round with precision < 0)

/** @compile-time-eval */
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): float {}
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): int|float {}
Comment thread
TimWolla marked this conversation as resolved.


/** @compile-time-eval */
function sin(float $num): float {}
Expand Down

10 changes: 4 additions & 6 deletions
ext/standard/basic_functions_arginfo.h

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


115 changes: 109 additions & 6 deletions
ext/standard/math.c

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -164,7 +164,7 @@ static inline double php_round_helper(double value, int mode) {

/* {{{ _php_math_round */
/*
 * Rounds a number to a certain number of decimal places in a certain rounding
 * Rounds a floating point to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see http://wiki.php.net/rfc/rounding
 */
PHPAPI double _php_math_round(double value, int places, int mode) {
Expand DownExpand Up@@ -249,6 +249,108 @@ PHPAPI double _php_math_round(double value, int places, int mode) {
}
/* }}} */

/* {{{ _php_math_round_long */
/*
 * Rounds a zend_long to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see https://wiki.php.net/rfc/integer-rounding
 */
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result) {
@TimWollaTimWollaSep 29, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Frankly I find this implementation incomprehensible. I've specifically refactored the floating point implementation to leverage a switch statement with very simple logic to make the code easier to verify for correctness in #12220.
This pattern should likely also be applied here. It also doesn't help that the logic is effectively duplicated for the “above zero” and “below zero” cases.
@marc-mabemarc-mabeSep 30, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Tim,

This is a first working version actually started before #12220 and as such I was following the previous style.

But you are right this can and should be improved. If the RFC gets accepted I'll update the PR according.
	static const zend_long powers[] = {
 1, 10, 100, 1000, 10000,
 100000, 1000000, 10000000, 100000000, 1000000000,
#if SIZEOF_ZEND_LONG >= 8
 10000000000, 100000000000, 1000000000000, 10000000000000, 100000000000000,
 1000000000000000, 10000000000000000, 100000000000000000, 1000000000000000000
#elif SIZEOF_ZEND_LONG > 8
# error "Unknown SIZEOF_ZEND_LONG"
#endif
 };

	zend_long tmp_value = value;
	zend_long power;
	zend_long power_half;
	zend_long rest;

	// Boolean if the number of places used matches the number of places possible
	int max_places = 0;

	// Simple case - long that does not need to be rounded
	if (places >= 0) {
 *result = tmp_value;
 return SUCCESS;
	}

	if (UNEXPECTED(-places > sizeof(powers) / sizeof(powers[0]) - 1)) {
 // Special case for rounding to the same number of places as max length possible
 // as this would overflow the power of 10
 if (places == -MAX_LENGTH_OF_LONG + 1) {
 max_places = 1;
 rest = tmp_value;
 tmp_value = 0;
 power_half = powers[-places - 1] * 5;
 } else {
 // Rounding more places will always be zero
 *result = 0;
 return SUCCESS;
 }
	} else {
 power = powers[-places];
 rest = tmp_value % power;
 power_half = power / 2;
 tmp_value = tmp_value / power;
	}

	if (value >= 0) {
 if ((mode == PHP_ROUND_HALF_UP && rest >= power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest > power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest > power_half || (rest == power_half && tmp_value % 2 == 1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest > power_half || (rest == power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would overflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value > ZEND_LONG_MAX - power)) {
 return FAILURE; // would overflow
 }
 tmp_value = tmp_value + power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	} else {
 if ((mode == PHP_ROUND_HALF_UP && rest <= -power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest < -power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest < -power_half || (rest == -power_half && tmp_value % 2 == -1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest < -power_half || (rest == -power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value < ZEND_LONG_MIN + power)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value - power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	}

	*result = tmp_value;
	return SUCCESS;
}
/* }}} */


/* {{{ Return the absolute value of the number */
PHP_FUNCTION(abs)
{
Expand DownExpand Up@@ -283,7 +385,7 @@ PHP_FUNCTION(ceil)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(ceil(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -302,7 +404,7 @@ PHP_FUNCTION(floor)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(floor(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -317,6 +419,7 @@ PHP_FUNCTION(round)
	int places = 0;
	zend_long precision = 0;
	zend_long mode = PHP_ROUND_HALF_UP;
	zend_long return_val_l;
@bukkabukkaOct 13, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use preferable some better name rather than something ending with just l (e.g. something like return_long_val or return_lval)

	ZEND_PARSE_PARAMETERS_START(1, 3)
 Z_PARAM_NUMBER(value)
Expand DownExpand Up@@ -346,10 +449,10 @@ PHP_FUNCTION(round)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
 /* Simple case - long that doesn't need to be rounded. */
 if (places >= 0) {
 RETURN_DOUBLE(zval_get_double(value));
 if (_php_math_round_long(Z_LVAL_P(value), places, (int)mode, &return_val_l) == SUCCESS) {
 RETURN_LONG(return_val_l);
 }

 ZEND_FALLTHROUGH;

 case IS_DOUBLE:
Expand Down

1 change: 1 addition & 0 deletions
ext/standard/php_math.h

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@
#define PHP_MATH_H

PHPAPI double _php_math_round(double value, int places, int mode);
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result);
PHPAPI zend_string *_php_math_number_format(double d, int dec, char dec_point, char thousand_sep);
PHPAPI zend_string *_php_math_number_format_ex(double d, int dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
PHPAPI zend_string *_php_math_number_format_long(zend_long num, zend_long dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
Expand Down

22 changes: 15 additions & 7 deletions
ext/standard/tests/math/ceil_basic.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -7,10 +7,14 @@ precision=14
echo "*** Testing ceil() : basic functionality ***\n";
$values = array(0,
 -0,
 0.0,
 -0.0,
 0.5,
 -0.5,
 1,
 -1,
 1.0,
 -1.0,
 1.5,
 -1.5,
 2.6,
Expand All@@ -35,25 +39,29 @@ for ($i = 0; $i < count($values); $i++) {
?>
--EXPECTF--
*** Testing ceil() : basic functionality ***
int(0)
int(0)
float(0)
float(0)
float(-0)
float(1)
float(-0)
int(1)
int(-1)
float(1)
float(-1)
float(2)
float(-1)
float(3)
float(-2)
float(31)
float(95)
int(31)
int(95)
float(11)
float(-10)
float(3950)
float(-3950)
float(39)
float(1)
float(0)
int(39)
int(1)
int(0)

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

26 changes: 13 additions & 13 deletions
ext/standard/tests/math/ceil_basiclong_64bit.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -27,32 +27,32 @@ foreach ($longVals as $longVal) {
?>
--EXPECT--
--- testing: 9223372036854775807 ---
float(9.223372036854776E+18)
int(9223372036854775807)
--- testing: -9223372036854775808 ---
float(-9.223372036854776E+18)
int(-9223372036854775808)
--- testing: 2147483647 ---
float(2147483647)
int(2147483647)
--- testing: -2147483648 ---
float(-2147483648)
int(-2147483648)
--- testing: 9223372034707292160 ---
float(9.223372034707292E+18)
int(9223372034707292160)
--- testing: -9223372034707292160 ---
float(-9.223372034707292E+18)
int(-9223372034707292160)
--- testing: 2147483648 ---
float(2147483648)
int(2147483648)
--- testing: -2147483649 ---
float(-2147483649)
int(-2147483649)
--- testing: 4294967294 ---
float(4294967294)
int(4294967294)
--- testing: 4294967295 ---
float(4294967295)
int(4294967295)
--- testing: 4294967293 ---
float(4294967293)
int(4294967293)
--- testing: 9223372036854775806 ---
float(9.223372036854776E+18)
int(9223372036854775806)
--- testing: 9.2233720368548E+18 ---
float(9.223372036854776E+18)
--- testing: -9223372036854775807 ---
float(-9.223372036854776E+18)
int(-9223372036854775807)
--- testing: -9.2233720368548E+18 ---
float(-9.223372036854776E+18)

16 changes: 8 additions & 8 deletions
ext/standard/tests/math/ceil_variation1.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -77,24 +77,24 @@ fclose($fp);
-- Iteration 1 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 2 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 3 --
float(1)
int(1)

-- Iteration 4 --
float(0)
int(0)

-- Iteration 5 --
float(1)
int(1)

-- Iteration 6 --
float(0)
int(0)

-- Iteration 7 --
ceil(): Argument #1 ($num) must be of type int|float, string given
Expand All@@ -120,12 +120,12 @@ ceil(): Argument #1 ($num) must be of type int|float, classA given
-- Iteration 14 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 15 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 16 --
ceil(): Argument #1 ($num) must be of type int|float, resource given
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
RFC: Integer rounding#12301

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

marc-mabe
wants to merge
3
commits into

from

 Closed


RFC: Integer rounding
#12301
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
db98d1d

ceil/floor/round keeps given int type if possible


marc-mabe Jun 14, 2023
2483a75

UNEXPECTED conditions


marc-mabe Sep 26, 2023
f9ae196

Update link to RFC


marc-mabe Sep 26, 2023

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


6 changes: 3 additions & 3 deletions
ext/standard/basic_functions.stub.php

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -3069,13 +3069,13 @@ function mail(string $to, string $subject, string $message, array|string $additi
function abs(int|float $num): int|float {}

/** @compile-time-eval */
function ceil(int|float $num): float {}
function ceil(int|float $num): int|float {}

/** @compile-time-eval */
function floor(int|float $num): float {}
function floor(int|float $num): int|float {}

Comment on lines

3071
 to 
3075

@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
Also, $num to be of type int doesn't make any sense, as the function is a no-op in this case.
@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wait... that's already a bug in the stubs.

This needs to be backported to 8.1.
@TimWollaTimWollaSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
flooring 2.5e300 should be legal and the result is only representable as float.
@marc-mabemarc-mabeSep 26, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This RFC proposes to keep the given type if possible.
  • float given -> float returned (guarantied)
  • int given -> int returned (except for int overflow on round with precision < 0)

/** @compile-time-eval */
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): float {}
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): int|float {}
Comment thread
TimWolla marked this conversation as resolved.


/** @compile-time-eval */
function sin(float $num): float {}
Expand Down

10 changes: 4 additions & 6 deletions
ext/standard/basic_functions_arginfo.h

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


115 changes: 109 additions & 6 deletions
ext/standard/math.c

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -164,7 +164,7 @@ static inline double php_round_helper(double value, int mode) {

/* {{{ _php_math_round */
/*
 * Rounds a number to a certain number of decimal places in a certain rounding
 * Rounds a floating point to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see http://wiki.php.net/rfc/rounding
 */
PHPAPI double _php_math_round(double value, int places, int mode) {
Expand DownExpand Up@@ -249,6 +249,108 @@ PHPAPI double _php_math_round(double value, int places, int mode) {
}
/* }}} */

/* {{{ _php_math_round_long */
/*
 * Rounds a zend_long to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see https://wiki.php.net/rfc/integer-rounding
 */
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result) {
@TimWollaTimWollaSep 29, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Frankly I find this implementation incomprehensible. I've specifically refactored the floating point implementation to leverage a switch statement with very simple logic to make the code easier to verify for correctness in #12220.
This pattern should likely also be applied here. It also doesn't help that the logic is effectively duplicated for the “above zero” and “below zero” cases.
@marc-mabemarc-mabeSep 30, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Tim,

This is a first working version actually started before #12220 and as such I was following the previous style.

But you are right this can and should be improved. If the RFC gets accepted I'll update the PR according.
	static const zend_long powers[] = {
 1, 10, 100, 1000, 10000,
 100000, 1000000, 10000000, 100000000, 1000000000,
#if SIZEOF_ZEND_LONG >= 8
 10000000000, 100000000000, 1000000000000, 10000000000000, 100000000000000,
 1000000000000000, 10000000000000000, 100000000000000000, 1000000000000000000
#elif SIZEOF_ZEND_LONG > 8
# error "Unknown SIZEOF_ZEND_LONG"
#endif
 };

	zend_long tmp_value = value;
	zend_long power;
	zend_long power_half;
	zend_long rest;

	// Boolean if the number of places used matches the number of places possible
	int max_places = 0;

	// Simple case - long that does not need to be rounded
	if (places >= 0) {
 *result = tmp_value;
 return SUCCESS;
	}

	if (UNEXPECTED(-places > sizeof(powers) / sizeof(powers[0]) - 1)) {
 // Special case for rounding to the same number of places as max length possible
 // as this would overflow the power of 10
 if (places == -MAX_LENGTH_OF_LONG + 1) {
 max_places = 1;
 rest = tmp_value;
 tmp_value = 0;
 power_half = powers[-places - 1] * 5;
 } else {
 // Rounding more places will always be zero
 *result = 0;
 return SUCCESS;
 }
	} else {
 power = powers[-places];
 rest = tmp_value % power;
 power_half = power / 2;
 tmp_value = tmp_value / power;
	}

	if (value >= 0) {
 if ((mode == PHP_ROUND_HALF_UP && rest >= power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest > power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest > power_half || (rest == power_half && tmp_value % 2 == 1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest > power_half || (rest == power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would overflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value > ZEND_LONG_MAX - power)) {
 return FAILURE; // would overflow
 }
 tmp_value = tmp_value + power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	} else {
 if ((mode == PHP_ROUND_HALF_UP && rest <= -power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest < -power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest < -power_half || (rest == -power_half && tmp_value % 2 == -1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest < -power_half || (rest == -power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value < ZEND_LONG_MIN + power)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value - power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	}

	*result = tmp_value;
	return SUCCESS;
}
/* }}} */


/* {{{ Return the absolute value of the number */
PHP_FUNCTION(abs)
{
Expand DownExpand Up@@ -283,7 +385,7 @@ PHP_FUNCTION(ceil)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(ceil(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -302,7 +404,7 @@ PHP_FUNCTION(floor)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(floor(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -317,6 +419,7 @@ PHP_FUNCTION(round)
	int places = 0;
	zend_long precision = 0;
	zend_long mode = PHP_ROUND_HALF_UP;
	zend_long return_val_l;
@bukkabukkaOct 13, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use preferable some better name rather than something ending with just l (e.g. something like return_long_val or return_lval)

	ZEND_PARSE_PARAMETERS_START(1, 3)
 Z_PARAM_NUMBER(value)
Expand DownExpand Up@@ -346,10 +449,10 @@ PHP_FUNCTION(round)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
 /* Simple case - long that doesn't need to be rounded. */
 if (places >= 0) {
 RETURN_DOUBLE(zval_get_double(value));
 if (_php_math_round_long(Z_LVAL_P(value), places, (int)mode, &return_val_l) == SUCCESS) {
 RETURN_LONG(return_val_l);
 }

 ZEND_FALLTHROUGH;

 case IS_DOUBLE:
Expand Down

1 change: 1 addition & 0 deletions
ext/standard/php_math.h

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@
#define PHP_MATH_H

PHPAPI double _php_math_round(double value, int places, int mode);
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result);
PHPAPI zend_string *_php_math_number_format(double d, int dec, char dec_point, char thousand_sep);
PHPAPI zend_string *_php_math_number_format_ex(double d, int dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
PHPAPI zend_string *_php_math_number_format_long(zend_long num, zend_long dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
Expand Down

22 changes: 15 additions & 7 deletions
ext/standard/tests/math/ceil_basic.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -7,10 +7,14 @@ precision=14
echo "*** Testing ceil() : basic functionality ***\n";
$values = array(0,
 -0,
 0.0,
 -0.0,
 0.5,
 -0.5,
 1,
 -1,
 1.0,
 -1.0,
 1.5,
 -1.5,
 2.6,
Expand All@@ -35,25 +39,29 @@ for ($i = 0; $i < count($values); $i++) {
?>
--EXPECTF--
*** Testing ceil() : basic functionality ***
int(0)
int(0)
float(0)
float(0)
float(-0)
float(1)
float(-0)
int(1)
int(-1)
float(1)
float(-1)
float(2)
float(-1)
float(3)
float(-2)
float(31)
float(95)
int(31)
int(95)
float(11)
float(-10)
float(3950)
float(-3950)
float(39)
float(1)
float(0)
int(39)
int(1)
int(0)

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

26 changes: 13 additions & 13 deletions
ext/standard/tests/math/ceil_basiclong_64bit.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -27,32 +27,32 @@ foreach ($longVals as $longVal) {
?>
--EXPECT--
--- testing: 9223372036854775807 ---
float(9.223372036854776E+18)
int(9223372036854775807)
--- testing: -9223372036854775808 ---
float(-9.223372036854776E+18)
int(-9223372036854775808)
--- testing: 2147483647 ---
float(2147483647)
int(2147483647)
--- testing: -2147483648 ---
float(-2147483648)
int(-2147483648)
--- testing: 9223372034707292160 ---
float(9.223372034707292E+18)
int(9223372034707292160)
--- testing: -9223372034707292160 ---
float(-9.223372034707292E+18)
int(-9223372034707292160)
--- testing: 2147483648 ---
float(2147483648)
int(2147483648)
--- testing: -2147483649 ---
float(-2147483649)
int(-2147483649)
--- testing: 4294967294 ---
float(4294967294)
int(4294967294)
--- testing: 4294967295 ---
float(4294967295)
int(4294967295)
--- testing: 4294967293 ---
float(4294967293)
int(4294967293)
--- testing: 9223372036854775806 ---
float(9.223372036854776E+18)
int(9223372036854775806)
--- testing: 9.2233720368548E+18 ---
float(9.223372036854776E+18)
--- testing: -9223372036854775807 ---
float(-9.223372036854776E+18)
int(-9223372036854775807)
--- testing: -9.2233720368548E+18 ---
float(-9.223372036854776E+18)

16 changes: 8 additions & 8 deletions
ext/standard/tests/math/ceil_variation1.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -77,24 +77,24 @@ fclose($fp);
-- Iteration 1 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 2 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 3 --
float(1)
int(1)

-- Iteration 4 --
float(0)
int(0)

-- Iteration 5 --
float(1)
int(1)

-- Iteration 6 --
float(0)
int(0)

-- Iteration 7 --
ceil(): Argument #1 ($num) must be of type int|float, string given
Expand All@@ -120,12 +120,12 @@ ceil(): Argument #1 ($num) must be of type int|float, classA given
-- Iteration 14 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 15 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 16 --
ceil(): Argument #1 ($num) must be of type int|float, resource given
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
RFC: Integer rounding#12301

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

marc-mabe
wants to merge
3
commits into

from

 Closed


RFC: Integer rounding
#12301
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
db98d1d

ceil/floor/round keeps given int type if possible


marc-mabe Jun 14, 2023
2483a75

UNEXPECTED conditions


marc-mabe Sep 26, 2023
f9ae196

Update link to RFC


marc-mabe Sep 26, 2023

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


6 changes: 3 additions & 3 deletions
ext/standard/basic_functions.stub.php

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -3069,13 +3069,13 @@ function mail(string $to, string $subject, string $message, array|string $additi
function abs(int|float $num): int|float {}

/** @compile-time-eval */
function ceil(int|float $num): float {}
function ceil(int|float $num): int|float {}

/** @compile-time-eval */
function floor(int|float $num): float {}
function floor(int|float $num): int|float {}

Comment on lines

3071
 to 
3075

@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
Also, $num to be of type int doesn't make any sense, as the function is a no-op in this case.
@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wait... that's already a bug in the stubs.

This needs to be backported to 8.1.
@TimWollaTimWollaSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
flooring 2.5e300 should be legal and the result is only representable as float.
@marc-mabemarc-mabeSep 26, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This RFC proposes to keep the given type if possible.
  • float given -> float returned (guarantied)
  • int given -> int returned (except for int overflow on round with precision < 0)

/** @compile-time-eval */
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): float {}
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): int|float {}
Comment thread
TimWolla marked this conversation as resolved.


/** @compile-time-eval */
function sin(float $num): float {}
Expand Down

10 changes: 4 additions & 6 deletions
ext/standard/basic_functions_arginfo.h

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


115 changes: 109 additions & 6 deletions
ext/standard/math.c

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -164,7 +164,7 @@ static inline double php_round_helper(double value, int mode) {

/* {{{ _php_math_round */
/*
 * Rounds a number to a certain number of decimal places in a certain rounding
 * Rounds a floating point to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see http://wiki.php.net/rfc/rounding
 */
PHPAPI double _php_math_round(double value, int places, int mode) {
Expand DownExpand Up@@ -249,6 +249,108 @@ PHPAPI double _php_math_round(double value, int places, int mode) {
}
/* }}} */

/* {{{ _php_math_round_long */
/*
 * Rounds a zend_long to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see https://wiki.php.net/rfc/integer-rounding
 */
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result) {
@TimWollaTimWollaSep 29, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Frankly I find this implementation incomprehensible. I've specifically refactored the floating point implementation to leverage a switch statement with very simple logic to make the code easier to verify for correctness in #12220.
This pattern should likely also be applied here. It also doesn't help that the logic is effectively duplicated for the “above zero” and “below zero” cases.
@marc-mabemarc-mabeSep 30, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Tim,

This is a first working version actually started before #12220 and as such I was following the previous style.

But you are right this can and should be improved. If the RFC gets accepted I'll update the PR according.
	static const zend_long powers[] = {
 1, 10, 100, 1000, 10000,
 100000, 1000000, 10000000, 100000000, 1000000000,
#if SIZEOF_ZEND_LONG >= 8
 10000000000, 100000000000, 1000000000000, 10000000000000, 100000000000000,
 1000000000000000, 10000000000000000, 100000000000000000, 1000000000000000000
#elif SIZEOF_ZEND_LONG > 8
# error "Unknown SIZEOF_ZEND_LONG"
#endif
 };

	zend_long tmp_value = value;
	zend_long power;
	zend_long power_half;
	zend_long rest;

	// Boolean if the number of places used matches the number of places possible
	int max_places = 0;

	// Simple case - long that does not need to be rounded
	if (places >= 0) {
 *result = tmp_value;
 return SUCCESS;
	}

	if (UNEXPECTED(-places > sizeof(powers) / sizeof(powers[0]) - 1)) {
 // Special case for rounding to the same number of places as max length possible
 // as this would overflow the power of 10
 if (places == -MAX_LENGTH_OF_LONG + 1) {
 max_places = 1;
 rest = tmp_value;
 tmp_value = 0;
 power_half = powers[-places - 1] * 5;
 } else {
 // Rounding more places will always be zero
 *result = 0;
 return SUCCESS;
 }
	} else {
 power = powers[-places];
 rest = tmp_value % power;
 power_half = power / 2;
 tmp_value = tmp_value / power;
	}

	if (value >= 0) {
 if ((mode == PHP_ROUND_HALF_UP && rest >= power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest > power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest > power_half || (rest == power_half && tmp_value % 2 == 1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest > power_half || (rest == power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would overflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value > ZEND_LONG_MAX - power)) {
 return FAILURE; // would overflow
 }
 tmp_value = tmp_value + power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	} else {
 if ((mode == PHP_ROUND_HALF_UP && rest <= -power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest < -power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest < -power_half || (rest == -power_half && tmp_value % 2 == -1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest < -power_half || (rest == -power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value < ZEND_LONG_MIN + power)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value - power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	}

	*result = tmp_value;
	return SUCCESS;
}
/* }}} */


/* {{{ Return the absolute value of the number */
PHP_FUNCTION(abs)
{
Expand DownExpand Up@@ -283,7 +385,7 @@ PHP_FUNCTION(ceil)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(ceil(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -302,7 +404,7 @@ PHP_FUNCTION(floor)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(floor(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -317,6 +419,7 @@ PHP_FUNCTION(round)
	int places = 0;
	zend_long precision = 0;
	zend_long mode = PHP_ROUND_HALF_UP;
	zend_long return_val_l;
@bukkabukkaOct 13, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use preferable some better name rather than something ending with just l (e.g. something like return_long_val or return_lval)

	ZEND_PARSE_PARAMETERS_START(1, 3)
 Z_PARAM_NUMBER(value)
Expand DownExpand Up@@ -346,10 +449,10 @@ PHP_FUNCTION(round)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
 /* Simple case - long that doesn't need to be rounded. */
 if (places >= 0) {
 RETURN_DOUBLE(zval_get_double(value));
 if (_php_math_round_long(Z_LVAL_P(value), places, (int)mode, &return_val_l) == SUCCESS) {
 RETURN_LONG(return_val_l);
 }

 ZEND_FALLTHROUGH;

 case IS_DOUBLE:
Expand Down

1 change: 1 addition & 0 deletions
ext/standard/php_math.h

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@
#define PHP_MATH_H

PHPAPI double _php_math_round(double value, int places, int mode);
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result);
PHPAPI zend_string *_php_math_number_format(double d, int dec, char dec_point, char thousand_sep);
PHPAPI zend_string *_php_math_number_format_ex(double d, int dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
PHPAPI zend_string *_php_math_number_format_long(zend_long num, zend_long dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
Expand Down

22 changes: 15 additions & 7 deletions
ext/standard/tests/math/ceil_basic.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -7,10 +7,14 @@ precision=14
echo "*** Testing ceil() : basic functionality ***\n";
$values = array(0,
 -0,
 0.0,
 -0.0,
 0.5,
 -0.5,
 1,
 -1,
 1.0,
 -1.0,
 1.5,
 -1.5,
 2.6,
Expand All@@ -35,25 +39,29 @@ for ($i = 0; $i < count($values); $i++) {
?>
--EXPECTF--
*** Testing ceil() : basic functionality ***
int(0)
int(0)
float(0)
float(0)
float(-0)
float(1)
float(-0)
int(1)
int(-1)
float(1)
float(-1)
float(2)
float(-1)
float(3)
float(-2)
float(31)
float(95)
int(31)
int(95)
float(11)
float(-10)
float(3950)
float(-3950)
float(39)
float(1)
float(0)
int(39)
int(1)
int(0)

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

26 changes: 13 additions & 13 deletions
ext/standard/tests/math/ceil_basiclong_64bit.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -27,32 +27,32 @@ foreach ($longVals as $longVal) {
?>
--EXPECT--
--- testing: 9223372036854775807 ---
float(9.223372036854776E+18)
int(9223372036854775807)
--- testing: -9223372036854775808 ---
float(-9.223372036854776E+18)
int(-9223372036854775808)
--- testing: 2147483647 ---
float(2147483647)
int(2147483647)
--- testing: -2147483648 ---
float(-2147483648)
int(-2147483648)
--- testing: 9223372034707292160 ---
float(9.223372034707292E+18)
int(9223372034707292160)
--- testing: -9223372034707292160 ---
float(-9.223372034707292E+18)
int(-9223372034707292160)
--- testing: 2147483648 ---
float(2147483648)
int(2147483648)
--- testing: -2147483649 ---
float(-2147483649)
int(-2147483649)
--- testing: 4294967294 ---
float(4294967294)
int(4294967294)
--- testing: 4294967295 ---
float(4294967295)
int(4294967295)
--- testing: 4294967293 ---
float(4294967293)
int(4294967293)
--- testing: 9223372036854775806 ---
float(9.223372036854776E+18)
int(9223372036854775806)
--- testing: 9.2233720368548E+18 ---
float(9.223372036854776E+18)
--- testing: -9223372036854775807 ---
float(-9.223372036854776E+18)
int(-9223372036854775807)
--- testing: -9.2233720368548E+18 ---
float(-9.223372036854776E+18)

16 changes: 8 additions & 8 deletions
ext/standard/tests/math/ceil_variation1.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -77,24 +77,24 @@ fclose($fp);
-- Iteration 1 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 2 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 3 --
float(1)
int(1)

-- Iteration 4 --
float(0)
int(0)

-- Iteration 5 --
float(1)
int(1)

-- Iteration 6 --
float(0)
int(0)

-- Iteration 7 --
ceil(): Argument #1 ($num) must be of type int|float, string given
Expand All@@ -120,12 +120,12 @@ ceil(): Argument #1 ($num) must be of type int|float, classA given
-- Iteration 14 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 15 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 16 --
ceil(): Argument #1 ($num) must be of type int|float, resource given
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
RFC: Integer rounding#12301

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

marc-mabe
wants to merge
3
commits into

from

 Closed


RFC: Integer rounding
#12301
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
db98d1d

ceil/floor/round keeps given int type if possible


marc-mabe Jun 14, 2023
2483a75

UNEXPECTED conditions


marc-mabe Sep 26, 2023
f9ae196

Update link to RFC


marc-mabe Sep 26, 2023

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


6 changes: 3 additions & 3 deletions
ext/standard/basic_functions.stub.php

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -3069,13 +3069,13 @@ function mail(string $to, string $subject, string $message, array|string $additi
function abs(int|float $num): int|float {}

/** @compile-time-eval */
function ceil(int|float $num): float {}
function ceil(int|float $num): int|float {}

/** @compile-time-eval */
function floor(int|float $num): float {}
function floor(int|float $num): int|float {}

Comment on lines

3071
 to 
3075

@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
Also, $num to be of type int doesn't make any sense, as the function is a no-op in this case.
@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wait... that's already a bug in the stubs.

This needs to be backported to 8.1.
@TimWollaTimWollaSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
flooring 2.5e300 should be legal and the result is only representable as float.
@marc-mabemarc-mabeSep 26, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This RFC proposes to keep the given type if possible.
  • float given -> float returned (guarantied)
  • int given -> int returned (except for int overflow on round with precision < 0)

/** @compile-time-eval */
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): float {}
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): int|float {}
Comment thread
TimWolla marked this conversation as resolved.


/** @compile-time-eval */
function sin(float $num): float {}
Expand Down

10 changes: 4 additions & 6 deletions
ext/standard/basic_functions_arginfo.h

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


115 changes: 109 additions & 6 deletions
ext/standard/math.c

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -164,7 +164,7 @@ static inline double php_round_helper(double value, int mode) {

/* {{{ _php_math_round */
/*
 * Rounds a number to a certain number of decimal places in a certain rounding
 * Rounds a floating point to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see http://wiki.php.net/rfc/rounding
 */
PHPAPI double _php_math_round(double value, int places, int mode) {
Expand DownExpand Up@@ -249,6 +249,108 @@ PHPAPI double _php_math_round(double value, int places, int mode) {
}
/* }}} */

/* {{{ _php_math_round_long */
/*
 * Rounds a zend_long to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see https://wiki.php.net/rfc/integer-rounding
 */
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result) {
@TimWollaTimWollaSep 29, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Frankly I find this implementation incomprehensible. I've specifically refactored the floating point implementation to leverage a switch statement with very simple logic to make the code easier to verify for correctness in #12220.
This pattern should likely also be applied here. It also doesn't help that the logic is effectively duplicated for the “above zero” and “below zero” cases.
@marc-mabemarc-mabeSep 30, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Tim,

This is a first working version actually started before #12220 and as such I was following the previous style.

But you are right this can and should be improved. If the RFC gets accepted I'll update the PR according.
	static const zend_long powers[] = {
 1, 10, 100, 1000, 10000,
 100000, 1000000, 10000000, 100000000, 1000000000,
#if SIZEOF_ZEND_LONG >= 8
 10000000000, 100000000000, 1000000000000, 10000000000000, 100000000000000,
 1000000000000000, 10000000000000000, 100000000000000000, 1000000000000000000
#elif SIZEOF_ZEND_LONG > 8
# error "Unknown SIZEOF_ZEND_LONG"
#endif
 };

	zend_long tmp_value = value;
	zend_long power;
	zend_long power_half;
	zend_long rest;

	// Boolean if the number of places used matches the number of places possible
	int max_places = 0;

	// Simple case - long that does not need to be rounded
	if (places >= 0) {
 *result = tmp_value;
 return SUCCESS;
	}

	if (UNEXPECTED(-places > sizeof(powers) / sizeof(powers[0]) - 1)) {
 // Special case for rounding to the same number of places as max length possible
 // as this would overflow the power of 10
 if (places == -MAX_LENGTH_OF_LONG + 1) {
 max_places = 1;
 rest = tmp_value;
 tmp_value = 0;
 power_half = powers[-places - 1] * 5;
 } else {
 // Rounding more places will always be zero
 *result = 0;
 return SUCCESS;
 }
	} else {
 power = powers[-places];
 rest = tmp_value % power;
 power_half = power / 2;
 tmp_value = tmp_value / power;
	}

	if (value >= 0) {
 if ((mode == PHP_ROUND_HALF_UP && rest >= power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest > power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest > power_half || (rest == power_half && tmp_value % 2 == 1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest > power_half || (rest == power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would overflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value > ZEND_LONG_MAX - power)) {
 return FAILURE; // would overflow
 }
 tmp_value = tmp_value + power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	} else {
 if ((mode == PHP_ROUND_HALF_UP && rest <= -power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest < -power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest < -power_half || (rest == -power_half && tmp_value % 2 == -1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest < -power_half || (rest == -power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value < ZEND_LONG_MIN + power)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value - power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	}

	*result = tmp_value;
	return SUCCESS;
}
/* }}} */


/* {{{ Return the absolute value of the number */
PHP_FUNCTION(abs)
{
Expand DownExpand Up@@ -283,7 +385,7 @@ PHP_FUNCTION(ceil)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(ceil(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -302,7 +404,7 @@ PHP_FUNCTION(floor)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(floor(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -317,6 +419,7 @@ PHP_FUNCTION(round)
	int places = 0;
	zend_long precision = 0;
	zend_long mode = PHP_ROUND_HALF_UP;
	zend_long return_val_l;
@bukkabukkaOct 13, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use preferable some better name rather than something ending with just l (e.g. something like return_long_val or return_lval)

	ZEND_PARSE_PARAMETERS_START(1, 3)
 Z_PARAM_NUMBER(value)
Expand DownExpand Up@@ -346,10 +449,10 @@ PHP_FUNCTION(round)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
 /* Simple case - long that doesn't need to be rounded. */
 if (places >= 0) {
 RETURN_DOUBLE(zval_get_double(value));
 if (_php_math_round_long(Z_LVAL_P(value), places, (int)mode, &return_val_l) == SUCCESS) {
 RETURN_LONG(return_val_l);
 }

 ZEND_FALLTHROUGH;

 case IS_DOUBLE:
Expand Down

1 change: 1 addition & 0 deletions
ext/standard/php_math.h

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@
#define PHP_MATH_H

PHPAPI double _php_math_round(double value, int places, int mode);
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result);
PHPAPI zend_string *_php_math_number_format(double d, int dec, char dec_point, char thousand_sep);
PHPAPI zend_string *_php_math_number_format_ex(double d, int dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
PHPAPI zend_string *_php_math_number_format_long(zend_long num, zend_long dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
Expand Down

22 changes: 15 additions & 7 deletions
ext/standard/tests/math/ceil_basic.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -7,10 +7,14 @@ precision=14
echo "*** Testing ceil() : basic functionality ***\n";
$values = array(0,
 -0,
 0.0,
 -0.0,
 0.5,
 -0.5,
 1,
 -1,
 1.0,
 -1.0,
 1.5,
 -1.5,
 2.6,
Expand All@@ -35,25 +39,29 @@ for ($i = 0; $i < count($values); $i++) {
?>
--EXPECTF--
*** Testing ceil() : basic functionality ***
int(0)
int(0)
float(0)
float(0)
float(-0)
float(1)
float(-0)
int(1)
int(-1)
float(1)
float(-1)
float(2)
float(-1)
float(3)
float(-2)
float(31)
float(95)
int(31)
int(95)
float(11)
float(-10)
float(3950)
float(-3950)
float(39)
float(1)
float(0)
int(39)
int(1)
int(0)

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

26 changes: 13 additions & 13 deletions
ext/standard/tests/math/ceil_basiclong_64bit.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -27,32 +27,32 @@ foreach ($longVals as $longVal) {
?>
--EXPECT--
--- testing: 9223372036854775807 ---
float(9.223372036854776E+18)
int(9223372036854775807)
--- testing: -9223372036854775808 ---
float(-9.223372036854776E+18)
int(-9223372036854775808)
--- testing: 2147483647 ---
float(2147483647)
int(2147483647)
--- testing: -2147483648 ---
float(-2147483648)
int(-2147483648)
--- testing: 9223372034707292160 ---
float(9.223372034707292E+18)
int(9223372034707292160)
--- testing: -9223372034707292160 ---
float(-9.223372034707292E+18)
int(-9223372034707292160)
--- testing: 2147483648 ---
float(2147483648)
int(2147483648)
--- testing: -2147483649 ---
float(-2147483649)
int(-2147483649)
--- testing: 4294967294 ---
float(4294967294)
int(4294967294)
--- testing: 4294967295 ---
float(4294967295)
int(4294967295)
--- testing: 4294967293 ---
float(4294967293)
int(4294967293)
--- testing: 9223372036854775806 ---
float(9.223372036854776E+18)
int(9223372036854775806)
--- testing: 9.2233720368548E+18 ---
float(9.223372036854776E+18)
--- testing: -9223372036854775807 ---
float(-9.223372036854776E+18)
int(-9223372036854775807)
--- testing: -9.2233720368548E+18 ---
float(-9.223372036854776E+18)

16 changes: 8 additions & 8 deletions
ext/standard/tests/math/ceil_variation1.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -77,24 +77,24 @@ fclose($fp);
-- Iteration 1 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 2 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 3 --
float(1)
int(1)

-- Iteration 4 --
float(0)
int(0)

-- Iteration 5 --
float(1)
int(1)

-- Iteration 6 --
float(0)
int(0)

-- Iteration 7 --
ceil(): Argument #1 ($num) must be of type int|float, string given
Expand All@@ -120,12 +120,12 @@ ceil(): Argument #1 ($num) must be of type int|float, classA given
-- Iteration 14 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 15 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 16 --
ceil(): Argument #1 ($num) must be of type int|float, resource given
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
RFC: Integer rounding#12301

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Closed

marc-mabe
wants to merge
3
commits into

from

 Closed


RFC: Integer rounding
#12301
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
db98d1d

ceil/floor/round keeps given int type if possible


marc-mabe Jun 14, 2023
2483a75

UNEXPECTED conditions


marc-mabe Sep 26, 2023
f9ae196

Update link to RFC


marc-mabe Sep 26, 2023

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


6 changes: 3 additions & 3 deletions
ext/standard/basic_functions.stub.php

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -3069,13 +3069,13 @@ function mail(string $to, string $subject, string $message, array|string $additi
function abs(int|float $num): int|float {}

/** @compile-time-eval */
function ceil(int|float $num): float {}
function ceil(int|float $num): int|float {}

/** @compile-time-eval */
function floor(int|float $num): float {}
function floor(int|float $num): int|float {}

Comment on lines

3071
 to 
3075

@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
Also, $num to be of type int doesn't make any sense, as the function is a no-op in this case.
@GirgiasGirgiasSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wait... that's already a bug in the stubs.

This needs to be backported to 8.1.
@TimWollaTimWollaSep 26, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the point to keep float return type just for 32bit builds?
flooring 2.5e300 should be legal and the result is only representable as float.
@marc-mabemarc-mabeSep 26, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This RFC proposes to keep the given type if possible.
  • float given -> float returned (guarantied)
  • int given -> int returned (except for int overflow on round with precision < 0)

/** @compile-time-eval */
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): float {}
function round(int|float $num, int $precision = 0, int $mode = PHP_ROUND_HALF_UP): int|float {}
Comment thread
TimWolla marked this conversation as resolved.


/** @compile-time-eval */
function sin(float $num): float {}
Expand Down

10 changes: 4 additions & 6 deletions
ext/standard/basic_functions_arginfo.h

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


115 changes: 109 additions & 6 deletions
ext/standard/math.c

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -164,7 +164,7 @@ static inline double php_round_helper(double value, int mode) {

/* {{{ _php_math_round */
/*
 * Rounds a number to a certain number of decimal places in a certain rounding
 * Rounds a floating point to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see http://wiki.php.net/rfc/rounding
 */
PHPAPI double _php_math_round(double value, int places, int mode) {
Expand DownExpand Up@@ -249,6 +249,108 @@ PHPAPI double _php_math_round(double value, int places, int mode) {
}
/* }}} */

/* {{{ _php_math_round_long */
/*
 * Rounds a zend_long to a certain number of decimal places in a certain rounding
 * mode. For the specifics of the algorithm, see https://wiki.php.net/rfc/integer-rounding
 */
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result) {
@TimWollaTimWollaSep 29, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Frankly I find this implementation incomprehensible. I've specifically refactored the floating point implementation to leverage a switch statement with very simple logic to make the code easier to verify for correctness in #12220.
This pattern should likely also be applied here. It also doesn't help that the logic is effectively duplicated for the “above zero” and “below zero” cases.
@marc-mabemarc-mabeSep 30, 2023

Copy link


Copy Markdown

ContributorAuthor
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Tim,

This is a first working version actually started before #12220 and as such I was following the previous style.

But you are right this can and should be improved. If the RFC gets accepted I'll update the PR according.
	static const zend_long powers[] = {
 1, 10, 100, 1000, 10000,
 100000, 1000000, 10000000, 100000000, 1000000000,
#if SIZEOF_ZEND_LONG >= 8
 10000000000, 100000000000, 1000000000000, 10000000000000, 100000000000000,
 1000000000000000, 10000000000000000, 100000000000000000, 1000000000000000000
#elif SIZEOF_ZEND_LONG > 8
# error "Unknown SIZEOF_ZEND_LONG"
#endif
 };

	zend_long tmp_value = value;
	zend_long power;
	zend_long power_half;
	zend_long rest;

	// Boolean if the number of places used matches the number of places possible
	int max_places = 0;

	// Simple case - long that does not need to be rounded
	if (places >= 0) {
 *result = tmp_value;
 return SUCCESS;
	}

	if (UNEXPECTED(-places > sizeof(powers) / sizeof(powers[0]) - 1)) {
 // Special case for rounding to the same number of places as max length possible
 // as this would overflow the power of 10
 if (places == -MAX_LENGTH_OF_LONG + 1) {
 max_places = 1;
 rest = tmp_value;
 tmp_value = 0;
 power_half = powers[-places - 1] * 5;
 } else {
 // Rounding more places will always be zero
 *result = 0;
 return SUCCESS;
 }
	} else {
 power = powers[-places];
 rest = tmp_value % power;
 power_half = power / 2;
 tmp_value = tmp_value / power;
	}

	if (value >= 0) {
 if ((mode == PHP_ROUND_HALF_UP && rest >= power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest > power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest > power_half || (rest == power_half && tmp_value % 2 == 1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest > power_half || (rest == power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would overflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value > ZEND_LONG_MAX - power)) {
 return FAILURE; // would overflow
 }
 tmp_value = tmp_value + power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	} else {
 if ((mode == PHP_ROUND_HALF_UP && rest <= -power_half)
 || (mode == PHP_ROUND_HALF_DOWN && rest < -power_half)
 || (mode == PHP_ROUND_HALF_EVEN && (rest < -power_half || (rest == -power_half && tmp_value % 2 == -1)))
 || (mode == PHP_ROUND_HALF_ODD && (rest < -power_half || (rest == -power_half && tmp_value % 2 == 0)))
 ) {
 if (UNEXPECTED(max_places)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value * power;

 if (UNEXPECTED(tmp_value < ZEND_LONG_MIN + power)) {
 return FAILURE; // would underflow
 }

 tmp_value = tmp_value - power;
 } else if (UNEXPECTED(max_places)) {
 tmp_value = 0;
 } else {
 tmp_value = tmp_value * power;
 }
	}

	*result = tmp_value;
	return SUCCESS;
}
/* }}} */


/* {{{ Return the absolute value of the number */
PHP_FUNCTION(abs)
{
Expand DownExpand Up@@ -283,7 +385,7 @@ PHP_FUNCTION(ceil)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(ceil(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -302,7 +404,7 @@ PHP_FUNCTION(floor)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
RETURN_DOUBLE(zval_get_double(value));
RETURN_ZVAL(value, 1, 0);
 case IS_DOUBLE:
 RETURN_DOUBLE(floor(Z_DVAL_P(value)));
 EMPTY_SWITCH_DEFAULT_CASE();
Expand All@@ -317,6 +419,7 @@ PHP_FUNCTION(round)
	int places = 0;
	zend_long precision = 0;
	zend_long mode = PHP_ROUND_HALF_UP;
	zend_long return_val_l;
@bukkabukkaOct 13, 2023

Copy link


Copy Markdown

Member
Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use preferable some better name rather than something ending with just l (e.g. something like return_long_val or return_lval)

	ZEND_PARSE_PARAMETERS_START(1, 3)
 Z_PARAM_NUMBER(value)
Expand DownExpand Up@@ -346,10 +449,10 @@ PHP_FUNCTION(round)

	switch (Z_TYPE_P(value)) {
 case IS_LONG:
 /* Simple case - long that doesn't need to be rounded. */
 if (places >= 0) {
 RETURN_DOUBLE(zval_get_double(value));
 if (_php_math_round_long(Z_LVAL_P(value), places, (int)mode, &return_val_l) == SUCCESS) {
 RETURN_LONG(return_val_l);
 }

 ZEND_FALLTHROUGH;

 case IS_DOUBLE:
Expand Down

1 change: 1 addition & 0 deletions
ext/standard/php_math.h

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -19,6 +19,7 @@
#define PHP_MATH_H

PHPAPI double _php_math_round(double value, int places, int mode);
PHPAPI zend_result _php_math_round_long(zend_long value, int places, int mode, zend_long *result);
PHPAPI zend_string *_php_math_number_format(double d, int dec, char dec_point, char thousand_sep);
PHPAPI zend_string *_php_math_number_format_ex(double d, int dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
PHPAPI zend_string *_php_math_number_format_long(zend_long num, zend_long dec, const char *dec_point, size_t dec_point_len, const char *thousand_sep, size_t thousand_sep_len);
Expand Down

22 changes: 15 additions & 7 deletions
ext/standard/tests/math/ceil_basic.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -7,10 +7,14 @@ precision=14
echo "*** Testing ceil() : basic functionality ***\n";
$values = array(0,
 -0,
 0.0,
 -0.0,
 0.5,
 -0.5,
 1,
 -1,
 1.0,
 -1.0,
 1.5,
 -1.5,
 2.6,
Expand All@@ -35,25 +39,29 @@ for ($i = 0; $i < count($values); $i++) {
?>
--EXPECTF--
*** Testing ceil() : basic functionality ***
int(0)
int(0)
float(0)
float(0)
float(-0)
float(1)
float(-0)
int(1)
int(-1)
float(1)
float(-1)
float(2)
float(-1)
float(3)
float(-2)
float(31)
float(95)
int(31)
int(95)
float(11)
float(-10)
float(3950)
float(-3950)
float(39)
float(1)
float(0)
int(39)
int(1)
int(0)

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

26 changes: 13 additions & 13 deletions
ext/standard/tests/math/ceil_basiclong_64bit.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -27,32 +27,32 @@ foreach ($longVals as $longVal) {
?>
--EXPECT--
--- testing: 9223372036854775807 ---
float(9.223372036854776E+18)
int(9223372036854775807)
--- testing: -9223372036854775808 ---
float(-9.223372036854776E+18)
int(-9223372036854775808)
--- testing: 2147483647 ---
float(2147483647)
int(2147483647)
--- testing: -2147483648 ---
float(-2147483648)
int(-2147483648)
--- testing: 9223372034707292160 ---
float(9.223372034707292E+18)
int(9223372034707292160)
--- testing: -9223372034707292160 ---
float(-9.223372034707292E+18)
int(-9223372034707292160)
--- testing: 2147483648 ---
float(2147483648)
int(2147483648)
--- testing: -2147483649 ---
float(-2147483649)
int(-2147483649)
--- testing: 4294967294 ---
float(4294967294)
int(4294967294)
--- testing: 4294967295 ---
float(4294967295)
int(4294967295)
--- testing: 4294967293 ---
float(4294967293)
int(4294967293)
--- testing: 9223372036854775806 ---
float(9.223372036854776E+18)
int(9223372036854775806)
--- testing: 9.2233720368548E+18 ---
float(9.223372036854776E+18)
--- testing: -9223372036854775807 ---
float(-9.223372036854776E+18)
int(-9223372036854775807)
--- testing: -9.2233720368548E+18 ---
float(-9.223372036854776E+18)

16 changes: 8 additions & 8 deletions
ext/standard/tests/math/ceil_variation1.phpt

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -77,24 +77,24 @@ fclose($fp);
-- Iteration 1 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 2 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 3 --
float(1)
int(1)

-- Iteration 4 --
float(0)
int(0)

-- Iteration 5 --
float(1)
int(1)

-- Iteration 6 --
float(0)
int(0)

-- Iteration 7 --
ceil(): Argument #1 ($num) must be of type int|float, string given
Expand All@@ -120,12 +120,12 @@ ceil(): Argument #1 ($num) must be of type int|float, classA given
-- Iteration 14 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 15 --

Deprecated: ceil(): Passing null to parameter #1 ($num) of type int|float is deprecated in %s on line %d
float(0)
int(0)

-- Iteration 16 --
ceil(): Argument #1 ($num) must be of type int|float, resource given
Loading