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 <limits>
24
25#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
26# pragma GCC system_header
27#endif
28
29_LIBCPP_PUSH_MACROS
30#include <__undef_macros>
31
32_LIBCPP_BEGIN_NAMESPACE_STD
33
34#if _LIBCPP_STD_VER >= 17
35
36template <typename _Result, typename _Source, bool _IsSigned = is_signed<_Source>::value>
37struct __ct_abs;
38
39template <typename _Result, typename _Source>
40struct __ct_abs<_Result, _Source, true> {
41 constexpr _LIBCPP_HIDE_FROM_ABI _Result operator()(_Source __t) const noexcept {
42 if (__t >= 0)
43 return __t;
44 if (__t == numeric_limits<_Source>::min())
45 return -static_cast<_Result>(__t);
46 return -__t;
47 }
48};
49
50template <typename _Result, typename _Source>
51struct __ct_abs<_Result, _Source, false> {
52 constexpr _LIBCPP_HIDE_FROM_ABI _Result operator()(_Source __t) const noexcept { return __t; }
53};
54
55template <class _Tp>
56constexpr _LIBCPP_HIDDEN _Tp __gcd(_Tp __a, _Tp __b) {
57 static_assert(!is_signed<_Tp>::value, "");
58
59 // Using Binary GCD algorithm https://en.wikipedia.org/wiki/Binary_GCD_algorithm, based on an implementation
60 // from https://lemire.me/blog/2024/04/13/greatest-common-divisor-the-extended-euclidean-algorithm-and-speed/
61 //
62 // If power of two divides both numbers, we can push it out.
63 // - gcd( 2^x * a, 2^x * b) = 2^x * gcd(a, b)
64 //
65 // If and only if exactly one number is even, we can divide that number by that power.
66 // - if a, b are odd, then gcd(2^x * a, b) = gcd(a, b)
67 //
68 // And standard gcd algorithm where instead of modulo, minus is used.
69
70 if (__a < __b) {
71 _Tp __tmp = __b;
72 __b = __a;
73 __a = __tmp;
74 }
75 if (__b == 0)
76 return __a;
77 __a %= __b; // Make both argument of the same size, and early result in the easy case.
78 if (__a == 0)
79 return __b;
80
81 _Tp __c = __a | __b;
82 int __shift = std::__countr_zero(__c);
83 __a >>= std::__countr_zero(__a);
84 do {
85 _Tp __t = __b >> std::__countr_zero(__b);
86 if (__a > __t) {
87 __b = __a - __t;
88 __a = __t;
89 } else {
90 __b = __t - __a;
91 }
92 } while (__b != 0);
93 return __a << __shift;
94}
95
96template <class _Tp, class _Up>
97constexpr _LIBCPP_HIDE_FROM_ABI common_type_t<_Tp, _Up> gcd(_Tp __m, _Up __n) {
98 static_assert(is_integral<_Tp>::value && is_integral<_Up>::value, "Arguments to gcd must be integer types");
99 static_assert(!is_same<__remove_cv_t<_Tp>, bool>::value, "First argument to gcd cannot be bool");
100 static_assert(!is_same<__remove_cv_t<_Up>, bool>::value, "Second argument to gcd cannot be bool");
101 using _Rp = common_type_t<_Tp, _Up>;
102 using _Wp = make_unsigned_t<_Rp>;
103 return static_cast<_Rp>(
104 std::__gcd(static_cast<_Wp>(__ct_abs<_Rp, _Tp>()(__m)), static_cast<_Wp>(__ct_abs<_Rp, _Up>()(__n))));
105}
106
107template <class _Tp, class _Up>
108constexpr _LIBCPP_HIDE_FROM_ABI common_type_t<_Tp, _Up> lcm(_Tp __m, _Up __n) {
109 static_assert(is_integral<_Tp>::value && is_integral<_Up>::value, "Arguments to lcm must be integer types");
110 static_assert(!is_same<__remove_cv_t<_Tp>, bool>::value, "First argument to lcm cannot be bool");
111 static_assert(!is_same<__remove_cv_t<_Up>, bool>::value, "Second argument to lcm cannot be bool");
112 if (__m == 0 || __n == 0)
113 return 0;
114
115 using _Rp = common_type_t<_Tp, _Up>;
116 _Rp __val1 = __ct_abs<_Rp, _Tp>()(__m) / std::gcd(__m, __n);
117 _Rp __val2 = __ct_abs<_Rp, _Up>()(__n);
118 _Rp __res;
119 [[maybe_unused]] bool __overflow = __builtin_mul_overflow(__val1, __val2, std::addressof(__res));
120 _LIBCPP_ASSERT_ARGUMENT_WITHIN_DOMAIN(!__overflow, "Overflow in lcm");
121 return __res;
122}
123
124#endif // _LIBCPP_STD_VER >= 17
125
126_LIBCPP_END_NAMESPACE_STD
127
128_LIBCPP_POP_MACROS
129
130#endif // _LIBCPP___NUMERIC_GCD_LCM_H
131