Coverage Report

Created: 2026-05-16 06:52

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/gmp/mpn/gcd_subdiv_step.c
Line
Count
Source
1
/* gcd_subdiv_step.c.
2
3
   THE FUNCTIONS IN THIS FILE ARE INTERNAL WITH MUTABLE INTERFACES.  IT IS ONLY
4
   SAFE TO REACH THEM THROUGH DOCUMENTED INTERFACES.  IN FACT, IT IS ALMOST
5
   GUARANTEED THAT THEY'LL CHANGE OR DISAPPEAR IN A FUTURE GNU MP RELEASE.
6
7
Copyright 2003-2005, 2008, 2010, 2011 Free Software Foundation, Inc.
8
9
This file is part of the GNU MP Library.
10
11
The GNU MP Library is free software; you can redistribute it and/or modify
12
it under the terms of either:
13
14
  * the GNU Lesser General Public License as published by the Free
15
    Software Foundation; either version 3 of the License, or (at your
16
    option) any later version.
17
18
or
19
20
  * the GNU General Public License as published by the Free Software
21
    Foundation; either version 2 of the License, or (at your option) any
22
    later version.
23
24
or both in parallel, as here.
25
26
The GNU MP Library is distributed in the hope that it will be useful, but
27
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
28
or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
29
for more details.
30
31
You should have received copies of the GNU General Public License and the
32
GNU Lesser General Public License along with the GNU MP Library.  If not,
33
see https://www.gnu.org/licenses/.  */
34
35
#include <stdlib.h>   /* for NULL */
36
37
#include "gmp-impl.h"
38
#include "longlong.h"
39
40
/* Used when mpn_hgcd or mpn_hgcd2 has failed. Then either one of a or
41
   b is small, or the difference is small. Perform one subtraction
42
   followed by one division. The normal case is to compute the reduced
43
   a and b, and return the new size.
44
45
   If s == 0 (used for gcd and gcdext), returns zero if the gcd is
46
   found.
47
48
   If s > 0, don't reduce to size <= s, and return zero if no
49
   reduction is possible (if either a, b or |a-b| is of size <= s). */
50
51
/* The hook function is called as
52
53
     hook(ctx, gp, gn, qp, qn, d)
54
55
   in the following cases:
56
57
   + If A = B at the start, G is the gcd, Q is NULL, d = -1.
58
59
   + If one input is zero at the start, G is the gcd, Q is NULL,
60
     d = 0 if A = G and d = 1 if B = G.
61
62
   Otherwise, if d = 0 we have just subtracted a multiple of A from B,
63
   and if d = 1 we have subtracted a multiple of B from A.
64
65
   + If A = B after subtraction, G is the gcd, Q is NULL.
66
67
   + If we get a zero remainder after division, G is the gcd, Q is the
68
     quotient.
69
70
   + Otherwise, G is NULL, Q is the quotient (often 1).
71
72
 */
73
74
mp_size_t
75
mpn_gcd_subdiv_step (mp_ptr ap, mp_ptr bp, mp_size_t n, mp_size_t s,
76
         gcd_subdiv_step_hook *hook, void *ctx,
77
         mp_ptr tp)
78
9.43k
{
79
9.43k
  static const mp_limb_t one = CNST_LIMB(1);
80
9.43k
  mp_size_t an, bn, qn;
81
82
9.43k
  int swapped;
83
84
9.43k
  ASSERT (n > 0);
85
9.43k
  ASSERT (ap[n-1] > 0 || bp[n-1] > 0);
86
87
9.43k
  an = bn = n;
88
9.43k
  MPN_NORMALIZE (ap, an);
89
9.43k
  MPN_NORMALIZE (bp, bn);
90
91
9.43k
  swapped = 0;
92
93
  /* Arrange so that a < b, subtract b -= a, and maintain
94
     normalization. */
95
9.43k
  if (an == bn)
96
7.93k
    {
97
7.93k
      int c;
98
7.93k
      MPN_CMP (c, ap, bp, an);
99
7.93k
      if (UNLIKELY (c == 0))
100
187
  {
101
    /* For gcdext, return the smallest of the two cofactors, so
102
       pass d = -1. */
103
187
    if (s == 0)
104
187
      hook (ctx, ap, an, NULL, 0, -1);
105
187
    return 0;
106
187
  }
107
7.74k
      else if (c > 0)
108
3.80k
  {
109
3.80k
    MP_PTR_SWAP (ap, bp);
110
3.80k
    swapped ^= 1;
111
3.80k
  }
112
7.93k
    }
113
1.49k
  else
114
1.49k
    {
115
1.49k
      if (an > bn)
116
745
  {
117
745
    MPN_PTR_SWAP (ap, an, bp, bn);
118
745
    swapped ^= 1;
119
745
  }
120
1.49k
    }
121
9.24k
  if (an <= s)
122
0
    {
123
0
      if (s == 0)
124
0
  hook (ctx, bp, bn, NULL, 0, swapped ^ 1);
125
0
      return 0;
126
0
    }
127
128
9.24k
  ASSERT_NOCARRY (mpn_sub (bp, bp, bn, ap, an));
129
9.24k
  MPN_NORMALIZE (bp, bn);
130
9.24k
  ASSERT (bn > 0);
131
132
9.24k
  if (bn <= s)
133
0
    {
134
      /* Undo subtraction. */
135
0
      mp_limb_t cy = mpn_add (bp, ap, an, bp, bn);
136
0
      if (cy > 0)
137
0
  bp[an] = cy;
138
0
      return 0;
139
0
    }
140
141
  /* Arrange so that a < b */
142
9.24k
  if (an == bn)
143
1.20k
    {
144
1.20k
      int c;
145
1.20k
      MPN_CMP (c, ap, bp, an);
146
1.20k
      if (UNLIKELY (c == 0))
147
0
  {
148
0
    if (s > 0)
149
      /* Just record subtraction and return */
150
0
      hook (ctx, NULL, 0, &one, 1, swapped);
151
0
    else
152
      /* Found gcd. */
153
0
      hook (ctx, bp, bn, NULL, 0, swapped);
154
0
    return 0;
155
0
  }
156
157
1.20k
      hook (ctx, NULL, 0, &one, 1, swapped);
158
159
1.20k
      if (c > 0)
160
338
  {
161
338
    MP_PTR_SWAP (ap, bp);
162
338
    swapped ^= 1;
163
338
  }
164
1.20k
    }
165
8.04k
  else
166
8.04k
    {
167
8.04k
      hook (ctx, NULL, 0, &one, 1, swapped);
168
169
8.04k
      if (an > bn)
170
7.27k
  {
171
7.27k
    MPN_PTR_SWAP (ap, an, bp, bn);
172
7.27k
    swapped ^= 1;
173
7.27k
  }
174
8.04k
    }
175
176
9.24k
  mpn_tdiv_qr (tp, bp, 0, bp, bn, ap, an);
177
9.24k
  qn = bn - an + 1;
178
9.24k
  bn = an;
179
9.24k
  MPN_NORMALIZE (bp, bn);
180
181
9.24k
  if (UNLIKELY (bn <= s))
182
200
    {
183
200
      if (s == 0)
184
200
  {
185
200
    hook (ctx, ap, an, tp, qn, swapped);
186
200
    return 0;
187
200
  }
188
189
      /* Quotient is one too large, so decrement it and add back A. */
190
0
      if (bn > 0)
191
0
  {
192
0
    mp_limb_t cy = mpn_add (bp, ap, an, bp, bn);
193
0
    if (cy)
194
0
      bp[an++] = cy;
195
0
  }
196
0
      else
197
0
  MPN_COPY (bp, ap, an);
198
199
0
      MPN_DECR_U (tp, qn, 1);
200
0
    }
201
202
9.04k
  hook (ctx, NULL, 0, tp, qn, swapped);
203
9.04k
  return an;
204
9.24k
}