Deprecation: #103785 - Deprecate MathUtility::convertToPositiveInteger()

See forge#103785

Description

TYPO3 has the method MathUtility::convertToPositiveInteger() to ensure that an integer is always positive. However, the method is rather "heavy" as it calls MathUtility::forceIntegerInRange() internally and therefore misuses a clamp mechanism to convert the integer to a positive number.

Also, the method name doesn't reflect what the method actually does. Negative numbers are not converted to their positive counterpart, but are swapped with 0. Due to the naming issue and the fact that the method can be replaced by a simple max() call, the method is therefore deprecated.

Impact

Calling MathUtility::convertToPositiveInteger() will trigger a PHP deprecation warning.

Affected installations

All installations using MathUtility::convertToPositiveInteger().

Migration

To recover the original behavior of the deprecated method, its call can be replaced with max(0, $number). To actually convert negative numbers to their positive counterpart, call abs($number).