1// -*- C++ -*-
2//===----------------------------------------------------------------------===//
3//
4// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5// See https://llvm.org/LICENSE.txt for license information.
6// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7//
8//===----------------------------------------------------------------------===//
9
10#ifndef _LIBCPP___NUMERIC_GCD_LCM_H
11#define _LIBCPP___NUMERIC_GCD_LCM_H
12
13#include <__assert>
14#include <__bit/countr.h>
15#include <__config>
16#include <__memory/addressof.h>
17#include <__type_traits/common_type.h>
18#include <__type_traits/is_integral.h>
19#include <__type_traits/is_same.h>
20#include <__type_traits/is_signed.h>
21#include <__type_traits/make_unsigned.h>
22#include <__type_traits/remove_cv.h>
23#include <__utility/checked_int.h>
24#include <limits>
25
26#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
27# pragma GCC system_header
28#endif
29
30_LIBCPP_PUSH_MACROS
31#include <__undef_macros>
32
33_LIBCPP_BEGIN_NAMESPACE_STD
34
35#if _LIBCPP_STD_VER >= 17
36
37template <class _Result, class _Source>
38constexpr _LIBCPP_HIDE_FROM_ABI _Result __abs_in_type(_Source __t) noexcept {
39 if constexpr (is_signed_v<_Source>) {
40 if (__t >= 0)
41 return __t;
42 if (__t == numeric_limits<_Source>::min())
43 return -static_cast<_Result>(__t);
44 return -__t;
45 } else {
46 return __t;
47 }
48}
49
50template <class _Tp, class _Up>
51[[nodiscard]] constexpr _LIBCPP_HIDE_FROM_ABI common_type_t<_Tp, _Up> gcd(_Tp __m, _Up __n) {
52 static_assert(is_integral<_Tp>::value && is_integral<_Up>::value, "Arguments to gcd must be integer types");
53 static_assert(!is_same<__remove_cv_t<_Tp>, bool>::value, "First argument to gcd cannot be bool");
54 static_assert(!is_same<__remove_cv_t<_Up>, bool>::value, "Second argument to gcd cannot be bool");
55 using _Rp = common_type_t<_Tp, _Up>;
56 using _Wp = make_unsigned_t<_Rp>;
57
58 // Using Binary GCD algorithm https://en.wikipedia.org/wiki/Binary_GCD_algorithm, based on an implementation
59 // from https://lemire.me/blog/2024/04/13/greatest-common-divisor-the-extended-euclidean-algorithm-and-speed/
60 //
61 // If power of two divides both numbers, we can push it out.
62 // - gcd( 2^x * a, 2^x * b) = 2^x * gcd(a, b)
63 //
64 // If and only if exactly one number is even, we can divide that number by that power.
65 // - if a, b are odd, then gcd(2^x * a, b) = gcd(a, b)
66 //
67 // And standard gcd algorithm where instead of modulo, minus is used.
68
69 auto __a = static_cast<_Wp>(std::__abs_in_type<_Rp>(__m));
70 auto __b = static_cast<_Wp>(std::__abs_in_type<_Rp>(__n));
71
72 if (__a < __b) {
73 _Wp __tmp = __b;
74 __b = __a;
75 __a = __tmp;
76 }
77 if (__b == 0)
78 return static_cast<_Rp>(__a);
79 __a %= __b; // Make both argument of the same size, and early result in the easy case.
80 if (__a == 0)
81 return static_cast<_Rp>(__b);
82
83 _Wp __c = __a | __b;
84 int __shift = std::__countr_zero(__c);
85 __a >>= std::__countr_zero(__a);
86 do {
87 _Wp __t = __b >> std::__countr_zero(__b);
88 if (__a > __t) {
89 __b = __a - __t;
90 __a = __t;
91 } else {
92 __b = __t - __a;
93 }
94 } while (__b != 0);
95 return static_cast<_Rp>(__a << __shift);
96}
97
98template <class _Tp, class _Up>
99[[nodiscard]] constexpr _LIBCPP_HIDE_FROM_ABI common_type_t<_Tp, _Up> lcm(_Tp __m, _Up __n) {
100 static_assert(is_integral<_Tp>::value && is_integral<_Up>::value, "Arguments to lcm must be integer types");
101 static_assert(!is_same<__remove_cv_t<_Tp>, bool>::value, "First argument to lcm cannot be bool");
102 static_assert(!is_same<__remove_cv_t<_Up>, bool>::value, "Second argument to lcm cannot be bool");
103 if (__m == 0 || __n == 0)
104 return 0;
105
106 using _Rp = common_type_t<_Tp, _Up>;
107 _Rp __val1 = std::__abs_in_type<_Rp>(__m) / std::gcd(__m, __n);
108 _Rp __val2 = std::__abs_in_type<_Rp>(__n);
109 auto __res = __checked_int(__val1) * __val2;
110 _LIBCPP_ASSERT_ARGUMENT_WITHIN_DOMAIN(!__res.__overflowed(), "Overflow in lcm");
111 return __res.__value();
112}
113
114#endif // _LIBCPP_STD_VER >= 17
115
116_LIBCPP_END_NAMESPACE_STD
117
118_LIBCPP_POP_MACROS
119
120#endif // _LIBCPP___NUMERIC_GCD_LCM_H
121