cast_to_int.php 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475
  1. <?php
  2. /**
  3. * Random_* Compatibility Library
  4. * for using the new PHP 7 random_* API in PHP 5 projects
  5. *
  6. * The MIT License (MIT)
  7. *
  8. * Copyright (c) 2015 - 2017 Paragon Initiative Enterprises
  9. *
  10. * Permission is hereby granted, free of charge, to any person obtaining a copy
  11. * of this software and associated documentation files (the "Software"), to deal
  12. * in the Software without restriction, including without limitation the rights
  13. * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  14. * copies of the Software, and to permit persons to whom the Software is
  15. * furnished to do so, subject to the following conditions:
  16. *
  17. * The above copyright notice and this permission notice shall be included in
  18. * all copies or substantial portions of the Software.
  19. *
  20. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  21. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  22. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  23. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  24. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  25. * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  26. * SOFTWARE.
  27. */
  28. if (!is_callable('RandomCompat_intval')) {
  29. /**
  30. * Cast to an integer if we can, safely.
  31. *
  32. * If you pass it a float in the range (~PHP_INT_MAX, PHP_INT_MAX)
  33. * (non-inclusive), it will sanely cast it to an int. If you it's equal to
  34. * ~PHP_INT_MAX or PHP_INT_MAX, we let it fail as not an integer. Floats
  35. * lose precision, so the <= and => operators might accidentally let a float
  36. * through.
  37. *
  38. * @param int|float $number The number we want to convert to an int
  39. * @param boolean $fail_open Set to true to not throw an exception
  40. *
  41. * @return float|int
  42. *
  43. * @throws TypeError
  44. */
  45. function RandomCompat_intval($number, $fail_open = false)
  46. {
  47. if (is_int($number) || is_float($number)) {
  48. $number += 0;
  49. } elseif (is_numeric($number)) {
  50. $number += 0;
  51. }
  52. if (
  53. is_float($number)
  54. &&
  55. $number > ~PHP_INT_MAX
  56. &&
  57. $number < PHP_INT_MAX
  58. ) {
  59. $number = (int) $number;
  60. }
  61. if (is_int($number)) {
  62. return (int) $number;
  63. } elseif (!$fail_open) {
  64. throw new TypeError(
  65. 'Expected an integer.'
  66. );
  67. }
  68. return $number;
  69. }
  70. }