blob: d182e7ce30e458328fec28f6e7f142610b0da2f3 [file] [log] [blame]
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001/* Long (arbitrary precision) integer object implementation */
2
Guido van Rossum23d6f0e1991-05-14 12:06:49 +00003/* XXX The functional organization of this file is terrible */
4
Guido van Rossumc0b618a1997-05-02 03:12:38 +00005#include "Python.h"
Guido van Rossumedcc38a1991-05-05 20:09:44 +00006#include "longintrepr.h"
Mark Dickinsonbd792642009-03-18 20:06:12 +00007#include "structseq.h"
Guido van Rossumc0b618a1997-05-02 03:12:38 +00008
Mark Dickinsonc6300392009-04-20 21:38:00 +00009#include <float.h>
Guido van Rossumeb1fafc1994-08-29 12:47:19 +000010#include <ctype.h>
Mark Dickinson5a74bf62009-02-15 11:04:38 +000011#include <stddef.h>
Guido van Rossumedcc38a1991-05-05 20:09:44 +000012
Guido van Rossumddefaf32007-01-14 03:31:43 +000013#ifndef NSMALLPOSINTS
14#define NSMALLPOSINTS 257
15#endif
16#ifndef NSMALLNEGINTS
17#define NSMALLNEGINTS 5
18#endif
Facundo Batista6e6f59b2008-07-24 18:57:11 +000019
Mark Dickinsone4416742009-02-15 15:14:57 +000020/* convert a PyLong of size 1, 0 or -1 to an sdigit */
21#define MEDIUM_VALUE(x) (Py_SIZE(x) < 0 ? -(sdigit)(x)->ob_digit[0] : \
22 (Py_SIZE(x) == 0 ? (sdigit)0 : \
23 (sdigit)(x)->ob_digit[0]))
Facundo Batista6e6f59b2008-07-24 18:57:11 +000024#define ABS(x) ((x) < 0 ? -(x) : (x))
25
Guido van Rossumddefaf32007-01-14 03:31:43 +000026#if NSMALLNEGINTS + NSMALLPOSINTS > 0
27/* Small integers are preallocated in this array so that they
28 can be shared.
29 The integers that are preallocated are those in the range
30 -NSMALLNEGINTS (inclusive) to NSMALLPOSINTS (not inclusive).
31*/
32static PyLongObject small_ints[NSMALLNEGINTS + NSMALLPOSINTS];
33#ifdef COUNT_ALLOCS
34int quick_int_allocs, quick_neg_int_allocs;
35#endif
36
Guido van Rossum7eaf8222007-06-18 17:58:50 +000037static PyObject *
Mark Dickinsone4416742009-02-15 15:14:57 +000038get_small_int(sdigit ival)
Guido van Rossumddefaf32007-01-14 03:31:43 +000039{
40 PyObject *v = (PyObject*)(small_ints + ival + NSMALLNEGINTS);
41 Py_INCREF(v);
42#ifdef COUNT_ALLOCS
43 if (ival >= 0)
44 quick_int_allocs++;
45 else
46 quick_neg_int_allocs++;
47#endif
48 return v;
49}
50#define CHECK_SMALL_INT(ival) \
51 do if (-NSMALLNEGINTS <= ival && ival < NSMALLPOSINTS) { \
Mark Dickinson0d4785b2009-02-15 17:27:41 +000052 return get_small_int((sdigit)ival); \
Guido van Rossumddefaf32007-01-14 03:31:43 +000053 } while(0)
54
Facundo Batista6e6f59b2008-07-24 18:57:11 +000055static PyLongObject *
56maybe_small_long(PyLongObject *v)
57{
58 if (v && ABS(Py_SIZE(v)) <= 1) {
Mark Dickinsone4416742009-02-15 15:14:57 +000059 sdigit ival = MEDIUM_VALUE(v);
Facundo Batista6e6f59b2008-07-24 18:57:11 +000060 if (-NSMALLNEGINTS <= ival && ival < NSMALLPOSINTS) {
61 Py_DECREF(v);
62 return (PyLongObject *)get_small_int(ival);
63 }
64 }
65 return v;
66}
Guido van Rossumddefaf32007-01-14 03:31:43 +000067#else
68#define CHECK_SMALL_INT(ival)
Facundo Batista6e6f59b2008-07-24 18:57:11 +000069#define maybe_small_long(val) (val)
Guido van Rossumddefaf32007-01-14 03:31:43 +000070#endif
71
Guido van Rossumddefaf32007-01-14 03:31:43 +000072/* If a freshly-allocated long is already shared, it must
73 be a small integer, so negating it must go to PyLong_FromLong */
74#define NEGATE(x) \
Christian Heimes90aa7642007-12-19 02:45:37 +000075 do if (Py_REFCNT(x) == 1) Py_SIZE(x) = -Py_SIZE(x); \
Christian Heimes217cfd12007-12-02 14:31:20 +000076 else { PyObject* tmp=PyLong_FromLong(-MEDIUM_VALUE(x)); \
Guido van Rossumddefaf32007-01-14 03:31:43 +000077 Py_DECREF(x); (x) = (PyLongObject*)tmp; } \
78 while(0)
Tim Peters5af4e6c2002-08-12 02:31:19 +000079/* For long multiplication, use the O(N**2) school algorithm unless
80 * both operands contain more than KARATSUBA_CUTOFF digits (this
81 * being an internal Python long digit, in base BASE).
82 */
Tim Peters0973b992004-08-29 22:16:50 +000083#define KARATSUBA_CUTOFF 70
84#define KARATSUBA_SQUARE_CUTOFF (2 * KARATSUBA_CUTOFF)
Tim Peters5af4e6c2002-08-12 02:31:19 +000085
Tim Peters47e52ee2004-08-30 02:44:38 +000086/* For exponentiation, use the binary left-to-right algorithm
87 * unless the exponent contains more than FIVEARY_CUTOFF digits.
88 * In that case, do 5 bits at a time. The potential drawback is that
89 * a table of 2**5 intermediate results is computed.
90 */
91#define FIVEARY_CUTOFF 8
92
Tim Peters5af4e6c2002-08-12 02:31:19 +000093#undef MIN
94#undef MAX
95#define MAX(x, y) ((x) < (y) ? (y) : (x))
96#define MIN(x, y) ((x) > (y) ? (y) : (x))
97
Guido van Rossumc0b618a1997-05-02 03:12:38 +000098#define SIGCHECK(PyTryBlock) \
Antoine Pitrou074e5ed2009-11-10 19:50:40 +000099 if (PyErr_CheckSignals()) PyTryBlock \
Guido van Rossum23d6f0e1991-05-14 12:06:49 +0000100
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000101/* Normalize (remove leading zeros from) a long int object.
102 Doesn't attempt to free the storage--in most cases, due to the nature
103 of the algorithms used, this could save at most be one word anyway. */
104
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000105static PyLongObject *
Tim Peters9f688bf2000-07-07 15:53:28 +0000106long_normalize(register PyLongObject *v)
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000107{
Christian Heimes90aa7642007-12-19 02:45:37 +0000108 Py_ssize_t j = ABS(Py_SIZE(v));
Martin v. Löwis18e16552006-02-15 17:27:45 +0000109 Py_ssize_t i = j;
Tim Peters5af4e6c2002-08-12 02:31:19 +0000110
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000111 while (i > 0 && v->ob_digit[i-1] == 0)
112 --i;
113 if (i != j)
Christian Heimes90aa7642007-12-19 02:45:37 +0000114 Py_SIZE(v) = (Py_SIZE(v) < 0) ? -(i) : i;
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000115 return v;
116}
117
118/* Allocate a new long int object with size digits.
119 Return NULL and set exception if we run out of memory. */
120
Mark Dickinson5a74bf62009-02-15 11:04:38 +0000121#define MAX_LONG_DIGITS \
122 ((PY_SSIZE_T_MAX - offsetof(PyLongObject, ob_digit))/sizeof(digit))
123
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000124PyLongObject *
Martin v. Löwis18e16552006-02-15 17:27:45 +0000125_PyLong_New(Py_ssize_t size)
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000126{
Guido van Rossumddefaf32007-01-14 03:31:43 +0000127 PyLongObject *result;
Mark Dickinson5a74bf62009-02-15 11:04:38 +0000128 /* Number of bytes needed is: offsetof(PyLongObject, ob_digit) +
129 sizeof(digit)*size. Previous incarnations of this code used
130 sizeof(PyVarObject) instead of the offsetof, but this risks being
131 incorrect in the presence of padding between the PyVarObject header
132 and the digits. */
Mark Dickinsone4416742009-02-15 15:14:57 +0000133 if (size > (Py_ssize_t)MAX_LONG_DIGITS) {
Mark Dickinson5a74bf62009-02-15 11:04:38 +0000134 PyErr_SetString(PyExc_OverflowError,
135 "too many digits in integer");
136 return NULL;
137 }
138 result = PyObject_MALLOC(offsetof(PyLongObject, ob_digit) +
Guido van Rossumddefaf32007-01-14 03:31:43 +0000139 size*sizeof(digit));
140 if (!result) {
Martin v. Löwis18e16552006-02-15 17:27:45 +0000141 PyErr_NoMemory();
142 return NULL;
143 }
Guido van Rossumddefaf32007-01-14 03:31:43 +0000144 return (PyLongObject*)PyObject_INIT_VAR(result, &PyLong_Type, size);
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000145}
146
Tim Peters64b5ce32001-09-10 20:52:51 +0000147PyObject *
148_PyLong_Copy(PyLongObject *src)
149{
150 PyLongObject *result;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000151 Py_ssize_t i;
Tim Peters64b5ce32001-09-10 20:52:51 +0000152
153 assert(src != NULL);
Christian Heimes90aa7642007-12-19 02:45:37 +0000154 i = Py_SIZE(src);
Tim Peters64b5ce32001-09-10 20:52:51 +0000155 if (i < 0)
156 i = -(i);
Guido van Rossumddefaf32007-01-14 03:31:43 +0000157 if (i < 2) {
Mark Dickinsone4416742009-02-15 15:14:57 +0000158 sdigit ival = src->ob_digit[0];
Christian Heimes90aa7642007-12-19 02:45:37 +0000159 if (Py_SIZE(src) < 0)
Guido van Rossumddefaf32007-01-14 03:31:43 +0000160 ival = -ival;
161 CHECK_SMALL_INT(ival);
162 }
Tim Peters64b5ce32001-09-10 20:52:51 +0000163 result = _PyLong_New(i);
164 if (result != NULL) {
Christian Heimes90aa7642007-12-19 02:45:37 +0000165 Py_SIZE(result) = Py_SIZE(src);
Tim Peters64b5ce32001-09-10 20:52:51 +0000166 while (--i >= 0)
167 result->ob_digit[i] = src->ob_digit[i];
168 }
169 return (PyObject *)result;
170}
171
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000172/* Create a new long int object from a C long int */
173
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000174PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +0000175PyLong_FromLong(long ival)
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000176{
Tim Petersce9de2f2001-06-14 04:56:19 +0000177 PyLongObject *v;
Mark Dickinsond4624c32009-01-24 15:02:35 +0000178 unsigned long abs_ival;
Tim Petersce9de2f2001-06-14 04:56:19 +0000179 unsigned long t; /* unsigned so >> doesn't propagate sign bit */
180 int ndigits = 0;
Guido van Rossumddefaf32007-01-14 03:31:43 +0000181 int sign = 1;
182
183 CHECK_SMALL_INT(ival);
Tim Petersce9de2f2001-06-14 04:56:19 +0000184
185 if (ival < 0) {
Mark Dickinsond4624c32009-01-24 15:02:35 +0000186 /* negate: can't write this as abs_ival = -ival since that
187 invokes undefined behaviour when ival is LONG_MIN */
188 abs_ival = 0U-(unsigned long)ival;
Guido van Rossumddefaf32007-01-14 03:31:43 +0000189 sign = -1;
Tim Petersce9de2f2001-06-14 04:56:19 +0000190 }
Christian Heimesdae2a892008-04-19 00:55:37 +0000191 else {
192 abs_ival = (unsigned long)ival;
193 }
Tim Petersce9de2f2001-06-14 04:56:19 +0000194
Mark Dickinsond4624c32009-01-24 15:02:35 +0000195 /* Fast path for single-digit ints */
196 if (!(abs_ival >> PyLong_SHIFT)) {
Guido van Rossumddefaf32007-01-14 03:31:43 +0000197 v = _PyLong_New(1);
198 if (v) {
Christian Heimes90aa7642007-12-19 02:45:37 +0000199 Py_SIZE(v) = sign;
Mark Dickinsond4624c32009-01-24 15:02:35 +0000200 v->ob_digit[0] = Py_SAFE_DOWNCAST(
201 abs_ival, unsigned long, digit);
Guido van Rossumddefaf32007-01-14 03:31:43 +0000202 }
203 return (PyObject*)v;
204 }
205
Mark Dickinson249b8982009-04-27 19:41:00 +0000206#if PyLong_SHIFT==15
Guido van Rossumddefaf32007-01-14 03:31:43 +0000207 /* 2 digits */
Mark Dickinsond4624c32009-01-24 15:02:35 +0000208 if (!(abs_ival >> 2*PyLong_SHIFT)) {
Guido van Rossumddefaf32007-01-14 03:31:43 +0000209 v = _PyLong_New(2);
210 if (v) {
Christian Heimes90aa7642007-12-19 02:45:37 +0000211 Py_SIZE(v) = 2*sign;
Mark Dickinsond4624c32009-01-24 15:02:35 +0000212 v->ob_digit[0] = Py_SAFE_DOWNCAST(
213 abs_ival & PyLong_MASK, unsigned long, digit);
214 v->ob_digit[1] = Py_SAFE_DOWNCAST(
215 abs_ival >> PyLong_SHIFT, unsigned long, digit);
Guido van Rossumddefaf32007-01-14 03:31:43 +0000216 }
217 return (PyObject*)v;
218 }
Mark Dickinsonbd792642009-03-18 20:06:12 +0000219#endif
Guido van Rossumddefaf32007-01-14 03:31:43 +0000220
221 /* Larger numbers: loop to determine number of digits */
Christian Heimesdae2a892008-04-19 00:55:37 +0000222 t = abs_ival;
Tim Petersce9de2f2001-06-14 04:56:19 +0000223 while (t) {
224 ++ndigits;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000225 t >>= PyLong_SHIFT;
Tim Petersce9de2f2001-06-14 04:56:19 +0000226 }
227 v = _PyLong_New(ndigits);
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000228 if (v != NULL) {
Tim Petersce9de2f2001-06-14 04:56:19 +0000229 digit *p = v->ob_digit;
Christian Heimes90aa7642007-12-19 02:45:37 +0000230 Py_SIZE(v) = ndigits*sign;
Christian Heimesdae2a892008-04-19 00:55:37 +0000231 t = abs_ival;
Tim Petersce9de2f2001-06-14 04:56:19 +0000232 while (t) {
Mark Dickinsond4624c32009-01-24 15:02:35 +0000233 *p++ = Py_SAFE_DOWNCAST(
234 t & PyLong_MASK, unsigned long, digit);
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000235 t >>= PyLong_SHIFT;
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000236 }
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000237 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000238 return (PyObject *)v;
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000239}
240
Guido van Rossum53756b11997-01-03 17:14:46 +0000241/* Create a new long int object from a C unsigned long int */
242
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000243PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +0000244PyLong_FromUnsignedLong(unsigned long ival)
Guido van Rossum53756b11997-01-03 17:14:46 +0000245{
Tim Petersce9de2f2001-06-14 04:56:19 +0000246 PyLongObject *v;
247 unsigned long t;
248 int ndigits = 0;
249
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000250 if (ival < PyLong_BASE)
Guido van Rossumddefaf32007-01-14 03:31:43 +0000251 return PyLong_FromLong(ival);
Tim Petersce9de2f2001-06-14 04:56:19 +0000252 /* Count the number of Python digits. */
253 t = (unsigned long)ival;
254 while (t) {
255 ++ndigits;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000256 t >>= PyLong_SHIFT;
Tim Petersce9de2f2001-06-14 04:56:19 +0000257 }
258 v = _PyLong_New(ndigits);
Guido van Rossum53756b11997-01-03 17:14:46 +0000259 if (v != NULL) {
Tim Petersce9de2f2001-06-14 04:56:19 +0000260 digit *p = v->ob_digit;
Christian Heimes90aa7642007-12-19 02:45:37 +0000261 Py_SIZE(v) = ndigits;
Tim Petersce9de2f2001-06-14 04:56:19 +0000262 while (ival) {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000263 *p++ = (digit)(ival & PyLong_MASK);
264 ival >>= PyLong_SHIFT;
Guido van Rossum53756b11997-01-03 17:14:46 +0000265 }
Guido van Rossum53756b11997-01-03 17:14:46 +0000266 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000267 return (PyObject *)v;
Guido van Rossum53756b11997-01-03 17:14:46 +0000268}
269
Guido van Rossum149e9ea1991-06-03 10:58:24 +0000270/* Create a new long int object from a C double */
271
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000272PyObject *
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000273PyLong_FromDouble(double dval)
Guido van Rossum149e9ea1991-06-03 10:58:24 +0000274{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000275 PyLongObject *v;
Guido van Rossum149e9ea1991-06-03 10:58:24 +0000276 double frac;
277 int i, ndig, expo, neg;
278 neg = 0;
Tim Peters39dce292000-08-15 03:34:48 +0000279 if (Py_IS_INFINITY(dval)) {
Guido van Rossum1a23c241999-09-27 17:11:52 +0000280 PyErr_SetString(PyExc_OverflowError,
Georg Brandl6aa2d1f2008-08-12 08:35:52 +0000281 "cannot convert float infinity to integer");
Guido van Rossum1a23c241999-09-27 17:11:52 +0000282 return NULL;
283 }
Christian Heimesa34706f2008-01-04 03:06:10 +0000284 if (Py_IS_NAN(dval)) {
Georg Brandl6aa2d1f2008-08-12 08:35:52 +0000285 PyErr_SetString(PyExc_ValueError,
286 "cannot convert float NaN to integer");
Christian Heimes386cd1e2008-01-15 02:01:20 +0000287 return NULL;
Christian Heimesa34706f2008-01-04 03:06:10 +0000288 }
Guido van Rossum149e9ea1991-06-03 10:58:24 +0000289 if (dval < 0.0) {
290 neg = 1;
291 dval = -dval;
292 }
293 frac = frexp(dval, &expo); /* dval = frac*2**expo; 0.0 <= frac < 1.0 */
294 if (expo <= 0)
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000295 return PyLong_FromLong(0L);
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000296 ndig = (expo-1) / PyLong_SHIFT + 1; /* Number of 'digits' in result */
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000297 v = _PyLong_New(ndig);
Guido van Rossum149e9ea1991-06-03 10:58:24 +0000298 if (v == NULL)
299 return NULL;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000300 frac = ldexp(frac, (expo-1) % PyLong_SHIFT + 1);
Guido van Rossum149e9ea1991-06-03 10:58:24 +0000301 for (i = ndig; --i >= 0; ) {
Mark Dickinson5a74bf62009-02-15 11:04:38 +0000302 digit bits = (digit)frac;
303 v->ob_digit[i] = bits;
Guido van Rossum149e9ea1991-06-03 10:58:24 +0000304 frac = frac - (double)bits;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000305 frac = ldexp(frac, PyLong_SHIFT);
Guido van Rossum149e9ea1991-06-03 10:58:24 +0000306 }
307 if (neg)
Christian Heimes90aa7642007-12-19 02:45:37 +0000308 Py_SIZE(v) = -(Py_SIZE(v));
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000309 return (PyObject *)v;
Guido van Rossum149e9ea1991-06-03 10:58:24 +0000310}
311
Thomas Wouters89f507f2006-12-13 04:49:30 +0000312/* Checking for overflow in PyLong_AsLong is a PITA since C doesn't define
313 * anything about what happens when a signed integer operation overflows,
314 * and some compilers think they're doing you a favor by being "clever"
315 * then. The bit pattern for the largest postive signed long is
316 * (unsigned long)LONG_MAX, and for the smallest negative signed long
317 * it is abs(LONG_MIN), which we could write -(unsigned long)LONG_MIN.
318 * However, some other compilers warn about applying unary minus to an
319 * unsigned operand. Hence the weird "0-".
320 */
321#define PY_ABS_LONG_MIN (0-(unsigned long)LONG_MIN)
322#define PY_ABS_SSIZE_T_MIN (0-(size_t)PY_SSIZE_T_MIN)
323
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000324/* Get a C long int from a long int object.
325 Returns -1 and sets an error condition if overflow occurs. */
326
327long
Martin v. Löwisd1a1d1e2007-12-04 22:10:37 +0000328PyLong_AsLongAndOverflow(PyObject *vv, int *overflow)
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000329{
Guido van Rossumf7531811998-05-26 14:33:37 +0000330 /* This version by Tim Peters */
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000331 register PyLongObject *v;
Guido van Rossumf7531811998-05-26 14:33:37 +0000332 unsigned long x, prev;
Georg Brandl61c31b02007-02-26 14:46:30 +0000333 long res;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000334 Py_ssize_t i;
335 int sign;
Guido van Rossumddefaf32007-01-14 03:31:43 +0000336 int do_decref = 0; /* if nb_int was called */
Guido van Rossumf7531811998-05-26 14:33:37 +0000337
Martin v. Löwisd1a1d1e2007-12-04 22:10:37 +0000338 *overflow = 0;
Guido van Rossumddefaf32007-01-14 03:31:43 +0000339 if (vv == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000340 PyErr_BadInternalCall();
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000341 return -1;
342 }
Guido van Rossumddefaf32007-01-14 03:31:43 +0000343
344 if (!PyLong_Check(vv)) {
345 PyNumberMethods *nb;
Mark Dickinson309aa2d2009-12-21 12:37:06 +0000346 nb = vv->ob_type->tp_as_number;
347 if (nb == NULL || nb->nb_int == NULL) {
348 PyErr_SetString(PyExc_TypeError,
349 "an integer is required");
Guido van Rossumddefaf32007-01-14 03:31:43 +0000350 return -1;
351 }
352 vv = (*nb->nb_int) (vv);
353 if (vv == NULL)
354 return -1;
355 do_decref = 1;
356 if (!PyLong_Check(vv)) {
357 Py_DECREF(vv);
358 PyErr_SetString(PyExc_TypeError,
359 "nb_int should return int object");
360 return -1;
361 }
362 }
363
Georg Brandl61c31b02007-02-26 14:46:30 +0000364 res = -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000365 v = (PyLongObject *)vv;
Christian Heimes90aa7642007-12-19 02:45:37 +0000366 i = Py_SIZE(v);
Guido van Rossumf7531811998-05-26 14:33:37 +0000367
Georg Brandl61c31b02007-02-26 14:46:30 +0000368 switch (i) {
369 case -1:
Mark Dickinson0d4785b2009-02-15 17:27:41 +0000370 res = -(sdigit)v->ob_digit[0];
Georg Brandl61c31b02007-02-26 14:46:30 +0000371 break;
372 case 0:
373 res = 0;
374 break;
375 case 1:
376 res = v->ob_digit[0];
377 break;
378 default:
379 sign = 1;
380 x = 0;
381 if (i < 0) {
382 sign = -1;
383 i = -(i);
384 }
385 while (--i >= 0) {
386 prev = x;
Mark Dickinson24f57852009-09-28 17:54:52 +0000387 x = (x << PyLong_SHIFT) | v->ob_digit[i];
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000388 if ((x >> PyLong_SHIFT) != prev) {
Mark Dickinson309aa2d2009-12-21 12:37:06 +0000389 *overflow = sign;
Georg Brandl61c31b02007-02-26 14:46:30 +0000390 goto exit;
391 }
392 }
Mark Dickinson309aa2d2009-12-21 12:37:06 +0000393 /* Haven't lost any bits, but casting to long requires extra
394 * care (see comment above).
395 */
Georg Brandl61c31b02007-02-26 14:46:30 +0000396 if (x <= (unsigned long)LONG_MAX) {
397 res = (long)x * sign;
398 }
399 else if (sign < 0 && x == PY_ABS_LONG_MIN) {
400 res = LONG_MIN;
401 }
402 else {
Mark Dickinson309aa2d2009-12-21 12:37:06 +0000403 *overflow = sign;
Martin v. Löwisd1a1d1e2007-12-04 22:10:37 +0000404 /* res is already set to -1 */
Mark Dickinson309aa2d2009-12-21 12:37:06 +0000405 }
Georg Brandl61c31b02007-02-26 14:46:30 +0000406 }
407 exit:
Guido van Rossumddefaf32007-01-14 03:31:43 +0000408 if (do_decref) {
409 Py_DECREF(vv);
410 }
Georg Brandl61c31b02007-02-26 14:46:30 +0000411 return res;
Guido van Rossumedcc38a1991-05-05 20:09:44 +0000412}
413
Martin v. Löwisd1a1d1e2007-12-04 22:10:37 +0000414long
415PyLong_AsLong(PyObject *obj)
416{
417 int overflow;
418 long result = PyLong_AsLongAndOverflow(obj, &overflow);
419 if (overflow) {
420 /* XXX: could be cute and give a different
421 message for overflow == -1 */
422 PyErr_SetString(PyExc_OverflowError,
423 "Python int too large to convert to C long");
424 }
425 return result;
426}
427
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000428/* Get a Py_ssize_t from a long int object.
429 Returns -1 and sets an error condition if overflow occurs. */
430
431Py_ssize_t
Guido van Rossumddefaf32007-01-14 03:31:43 +0000432PyLong_AsSsize_t(PyObject *vv) {
Martin v. Löwis18e16552006-02-15 17:27:45 +0000433 register PyLongObject *v;
434 size_t x, prev;
435 Py_ssize_t i;
436 int sign;
437
Mark Dickinsond59b4162010-03-13 11:34:40 +0000438 if (vv == NULL) {
Martin v. Löwis18e16552006-02-15 17:27:45 +0000439 PyErr_BadInternalCall();
440 return -1;
441 }
Mark Dickinsond59b4162010-03-13 11:34:40 +0000442 if (!PyLong_Check(vv)) {
443 PyErr_SetString(PyExc_TypeError, "an integer is required");
444 return -1;
445 }
446
Martin v. Löwis18e16552006-02-15 17:27:45 +0000447 v = (PyLongObject *)vv;
Christian Heimes90aa7642007-12-19 02:45:37 +0000448 i = Py_SIZE(v);
Guido van Rossumddefaf32007-01-14 03:31:43 +0000449 switch (i) {
Mark Dickinson0d4785b2009-02-15 17:27:41 +0000450 case -1: return -(sdigit)v->ob_digit[0];
Guido van Rossumddefaf32007-01-14 03:31:43 +0000451 case 0: return 0;
452 case 1: return v->ob_digit[0];
453 }
Martin v. Löwis18e16552006-02-15 17:27:45 +0000454 sign = 1;
455 x = 0;
456 if (i < 0) {
457 sign = -1;
458 i = -(i);
459 }
460 while (--i >= 0) {
461 prev = x;
Mark Dickinson24f57852009-09-28 17:54:52 +0000462 x = (x << PyLong_SHIFT) | v->ob_digit[i];
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000463 if ((x >> PyLong_SHIFT) != prev)
Martin v. Löwis18e16552006-02-15 17:27:45 +0000464 goto overflow;
465 }
Thomas Wouters89f507f2006-12-13 04:49:30 +0000466 /* Haven't lost any bits, but casting to a signed type requires
467 * extra care (see comment above).
Martin v. Löwis18e16552006-02-15 17:27:45 +0000468 */
Thomas Wouters89f507f2006-12-13 04:49:30 +0000469 if (x <= (size_t)PY_SSIZE_T_MAX) {
470 return (Py_ssize_t)x * sign;
471 }
472 else if (sign < 0 && x == PY_ABS_SSIZE_T_MIN) {
473 return PY_SSIZE_T_MIN;
474 }
475 /* else overflow */
Martin v. Löwis18e16552006-02-15 17:27:45 +0000476
477 overflow:
478 PyErr_SetString(PyExc_OverflowError,
Guido van Rossum523d4f92007-01-15 00:31:49 +0000479 "Python int too large to convert to C ssize_t");
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000480 return -1;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000481}
482
Guido van Rossumd8c80482002-08-13 00:24:58 +0000483/* Get a C unsigned long int from a long int object.
Guido van Rossum53756b11997-01-03 17:14:46 +0000484 Returns -1 and sets an error condition if overflow occurs. */
485
486unsigned long
Tim Peters9f688bf2000-07-07 15:53:28 +0000487PyLong_AsUnsignedLong(PyObject *vv)
Guido van Rossum53756b11997-01-03 17:14:46 +0000488{
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000489 register PyLongObject *v;
Guido van Rossum53756b11997-01-03 17:14:46 +0000490 unsigned long x, prev;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000491 Py_ssize_t i;
Tim Peters5af4e6c2002-08-12 02:31:19 +0000492
Mark Dickinsond59b4162010-03-13 11:34:40 +0000493 if (vv == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000494 PyErr_BadInternalCall();
Mark Dickinsond59b4162010-03-13 11:34:40 +0000495 return (unsigned long)-1;
Guido van Rossum53756b11997-01-03 17:14:46 +0000496 }
Mark Dickinsond59b4162010-03-13 11:34:40 +0000497 if (!PyLong_Check(vv)) {
498 PyErr_SetString(PyExc_TypeError, "an integer is required");
499 return (unsigned long)-1;
500 }
501
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000502 v = (PyLongObject *)vv;
Christian Heimes90aa7642007-12-19 02:45:37 +0000503 i = Py_SIZE(v);
Guido van Rossum53756b11997-01-03 17:14:46 +0000504 x = 0;
505 if (i < 0) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000506 PyErr_SetString(PyExc_OverflowError,
Guido van Rossumddefaf32007-01-14 03:31:43 +0000507 "can't convert negative value to unsigned int");
Guido van Rossum53756b11997-01-03 17:14:46 +0000508 return (unsigned long) -1;
509 }
Guido van Rossumddefaf32007-01-14 03:31:43 +0000510 switch (i) {
511 case 0: return 0;
512 case 1: return v->ob_digit[0];
513 }
Guido van Rossum53756b11997-01-03 17:14:46 +0000514 while (--i >= 0) {
515 prev = x;
Mark Dickinson24f57852009-09-28 17:54:52 +0000516 x = (x << PyLong_SHIFT) | v->ob_digit[i];
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000517 if ((x >> PyLong_SHIFT) != prev) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +0000518 PyErr_SetString(PyExc_OverflowError,
Guido van Rossum523d4f92007-01-15 00:31:49 +0000519 "python int too large to convert to C unsigned long");
Guido van Rossumddefaf32007-01-14 03:31:43 +0000520 return (unsigned long) -1;
521 }
522 }
523 return x;
524}
525
526/* Get a C unsigned long int from a long int object.
527 Returns -1 and sets an error condition if overflow occurs. */
528
529size_t
530PyLong_AsSize_t(PyObject *vv)
531{
532 register PyLongObject *v;
533 size_t x, prev;
534 Py_ssize_t i;
535
Mark Dickinsond59b4162010-03-13 11:34:40 +0000536 if (vv == NULL) {
Guido van Rossumddefaf32007-01-14 03:31:43 +0000537 PyErr_BadInternalCall();
Mark Dickinsond59b4162010-03-13 11:34:40 +0000538 return (size_t) -1;
Guido van Rossumddefaf32007-01-14 03:31:43 +0000539 }
Mark Dickinsond59b4162010-03-13 11:34:40 +0000540 if (!PyLong_Check(vv)) {
541 PyErr_SetString(PyExc_TypeError, "an integer is required");
542 return (size_t)-1;
543 }
544
Guido van Rossumddefaf32007-01-14 03:31:43 +0000545 v = (PyLongObject *)vv;
Christian Heimes90aa7642007-12-19 02:45:37 +0000546 i = Py_SIZE(v);
Guido van Rossumddefaf32007-01-14 03:31:43 +0000547 x = 0;
548 if (i < 0) {
549 PyErr_SetString(PyExc_OverflowError,
550 "can't convert negative value to size_t");
551 return (size_t) -1;
552 }
553 switch (i) {
554 case 0: return 0;
555 case 1: return v->ob_digit[0];
556 }
557 while (--i >= 0) {
558 prev = x;
Mark Dickinson24f57852009-09-28 17:54:52 +0000559 x = (x << PyLong_SHIFT) | v->ob_digit[i];
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000560 if ((x >> PyLong_SHIFT) != prev) {
Guido van Rossumddefaf32007-01-14 03:31:43 +0000561 PyErr_SetString(PyExc_OverflowError,
Guido van Rossum523d4f92007-01-15 00:31:49 +0000562 "Python int too large to convert to C size_t");
Guido van Rossum53756b11997-01-03 17:14:46 +0000563 return (unsigned long) -1;
564 }
565 }
566 return x;
567}
568
Thomas Hellera4ea6032003-04-17 18:55:45 +0000569/* Get a C unsigned long int from a long int object, ignoring the high bits.
570 Returns -1 and sets an error condition if an error occurs. */
571
Guido van Rossumddefaf32007-01-14 03:31:43 +0000572static unsigned long
573_PyLong_AsUnsignedLongMask(PyObject *vv)
Thomas Hellera4ea6032003-04-17 18:55:45 +0000574{
575 register PyLongObject *v;
576 unsigned long x;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000577 Py_ssize_t i;
578 int sign;
Thomas Hellera4ea6032003-04-17 18:55:45 +0000579
580 if (vv == NULL || !PyLong_Check(vv)) {
581 PyErr_BadInternalCall();
582 return (unsigned long) -1;
583 }
584 v = (PyLongObject *)vv;
Christian Heimes90aa7642007-12-19 02:45:37 +0000585 i = Py_SIZE(v);
Guido van Rossumddefaf32007-01-14 03:31:43 +0000586 switch (i) {
587 case 0: return 0;
588 case 1: return v->ob_digit[0];
589 }
Thomas Hellera4ea6032003-04-17 18:55:45 +0000590 sign = 1;
591 x = 0;
592 if (i < 0) {
593 sign = -1;
594 i = -i;
595 }
596 while (--i >= 0) {
Mark Dickinson24f57852009-09-28 17:54:52 +0000597 x = (x << PyLong_SHIFT) | v->ob_digit[i];
Thomas Hellera4ea6032003-04-17 18:55:45 +0000598 }
599 return x * sign;
600}
601
Guido van Rossumddefaf32007-01-14 03:31:43 +0000602unsigned long
603PyLong_AsUnsignedLongMask(register PyObject *op)
604{
605 PyNumberMethods *nb;
606 PyLongObject *lo;
607 unsigned long val;
608
609 if (op && PyLong_Check(op))
610 return _PyLong_AsUnsignedLongMask(op);
611
612 if (op == NULL || (nb = op->ob_type->tp_as_number) == NULL ||
613 nb->nb_int == NULL) {
614 PyErr_SetString(PyExc_TypeError, "an integer is required");
615 return (unsigned long)-1;
616 }
617
618 lo = (PyLongObject*) (*nb->nb_int) (op);
619 if (lo == NULL)
620 return (unsigned long)-1;
621 if (PyLong_Check(lo)) {
622 val = _PyLong_AsUnsignedLongMask((PyObject *)lo);
623 Py_DECREF(lo);
624 if (PyErr_Occurred())
625 return (unsigned long)-1;
626 return val;
627 }
628 else
629 {
630 Py_DECREF(lo);
631 PyErr_SetString(PyExc_TypeError,
632 "nb_int should return int object");
633 return (unsigned long)-1;
634 }
635}
636
Tim Peters5b8132f2003-01-31 15:52:05 +0000637int
638_PyLong_Sign(PyObject *vv)
639{
640 PyLongObject *v = (PyLongObject *)vv;
Tim Peters5b8132f2003-01-31 15:52:05 +0000641
642 assert(v != NULL);
643 assert(PyLong_Check(v));
Tim Peters5b8132f2003-01-31 15:52:05 +0000644
Christian Heimes90aa7642007-12-19 02:45:37 +0000645 return Py_SIZE(v) == 0 ? 0 : (Py_SIZE(v) < 0 ? -1 : 1);
Tim Peters5b8132f2003-01-31 15:52:05 +0000646}
647
Tim Petersbaefd9e2003-01-28 20:37:45 +0000648size_t
649_PyLong_NumBits(PyObject *vv)
650{
651 PyLongObject *v = (PyLongObject *)vv;
Tim Peters5b8132f2003-01-31 15:52:05 +0000652 size_t result = 0;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000653 Py_ssize_t ndigits;
Tim Petersbaefd9e2003-01-28 20:37:45 +0000654
655 assert(v != NULL);
656 assert(PyLong_Check(v));
Christian Heimes90aa7642007-12-19 02:45:37 +0000657 ndigits = ABS(Py_SIZE(v));
Tim Petersbaefd9e2003-01-28 20:37:45 +0000658 assert(ndigits == 0 || v->ob_digit[ndigits - 1] != 0);
659 if (ndigits > 0) {
Tim Petersbaefd9e2003-01-28 20:37:45 +0000660 digit msd = v->ob_digit[ndigits - 1];
661
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000662 result = (ndigits - 1) * PyLong_SHIFT;
663 if (result / PyLong_SHIFT != (size_t)(ndigits - 1))
Tim Petersbaefd9e2003-01-28 20:37:45 +0000664 goto Overflow;
665 do {
666 ++result;
667 if (result == 0)
668 goto Overflow;
669 msd >>= 1;
670 } while (msd);
671 }
672 return result;
673
674Overflow:
Guido van Rossumddefaf32007-01-14 03:31:43 +0000675 PyErr_SetString(PyExc_OverflowError, "int has too many bits "
Tim Petersbaefd9e2003-01-28 20:37:45 +0000676 "to express in a platform size_t");
677 return (size_t)-1;
678}
679
Tim Peters2a9b3672001-06-11 21:23:58 +0000680PyObject *
681_PyLong_FromByteArray(const unsigned char* bytes, size_t n,
682 int little_endian, int is_signed)
683{
684 const unsigned char* pstartbyte;/* LSB of bytes */
685 int incr; /* direction to move pstartbyte */
686 const unsigned char* pendbyte; /* MSB of bytes */
687 size_t numsignificantbytes; /* number of bytes that matter */
Mark Dickinson5a74bf62009-02-15 11:04:38 +0000688 Py_ssize_t ndigits; /* number of Python long digits */
Tim Peters2a9b3672001-06-11 21:23:58 +0000689 PyLongObject* v; /* result */
Mark Dickinson5a74bf62009-02-15 11:04:38 +0000690 Py_ssize_t idigit = 0; /* next free index in v->ob_digit */
Tim Peters2a9b3672001-06-11 21:23:58 +0000691
692 if (n == 0)
693 return PyLong_FromLong(0L);
694
695 if (little_endian) {
696 pstartbyte = bytes;
697 pendbyte = bytes + n - 1;
698 incr = 1;
699 }
700 else {
701 pstartbyte = bytes + n - 1;
702 pendbyte = bytes;
703 incr = -1;
704 }
705
706 if (is_signed)
707 is_signed = *pendbyte >= 0x80;
708
709 /* Compute numsignificantbytes. This consists of finding the most
710 significant byte. Leading 0 bytes are insignficant if the number
711 is positive, and leading 0xff bytes if negative. */
712 {
713 size_t i;
714 const unsigned char* p = pendbyte;
715 const int pincr = -incr; /* search MSB to LSB */
716 const unsigned char insignficant = is_signed ? 0xff : 0x00;
717
718 for (i = 0; i < n; ++i, p += pincr) {
719 if (*p != insignficant)
720 break;
721 }
722 numsignificantbytes = n - i;
723 /* 2's-comp is a bit tricky here, e.g. 0xff00 == -0x0100, so
724 actually has 2 significant bytes. OTOH, 0xff0001 ==
725 -0x00ffff, so we wouldn't *need* to bump it there; but we
726 do for 0xffff = -0x0001. To be safe without bothering to
727 check every case, bump it regardless. */
728 if (is_signed && numsignificantbytes < n)
729 ++numsignificantbytes;
730 }
731
732 /* How many Python long digits do we need? We have
Mark Dickinson5a74bf62009-02-15 11:04:38 +0000733 8*numsignificantbytes bits, and each Python long digit has
734 PyLong_SHIFT bits, so it's the ceiling of the quotient. */
735 /* catch overflow before it happens */
736 if (numsignificantbytes > (PY_SSIZE_T_MAX - PyLong_SHIFT) / 8) {
737 PyErr_SetString(PyExc_OverflowError,
738 "byte array too long to convert to int");
739 return NULL;
740 }
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000741 ndigits = (numsignificantbytes * 8 + PyLong_SHIFT - 1) / PyLong_SHIFT;
Mark Dickinson5a74bf62009-02-15 11:04:38 +0000742 v = _PyLong_New(ndigits);
Tim Peters2a9b3672001-06-11 21:23:58 +0000743 if (v == NULL)
744 return NULL;
745
746 /* Copy the bits over. The tricky parts are computing 2's-comp on
747 the fly for signed numbers, and dealing with the mismatch between
748 8-bit bytes and (probably) 15-bit Python digits.*/
749 {
750 size_t i;
Tim Petersf251d062001-06-13 21:09:15 +0000751 twodigits carry = 1; /* for 2's-comp calculation */
Tim Peters2a9b3672001-06-11 21:23:58 +0000752 twodigits accum = 0; /* sliding register */
753 unsigned int accumbits = 0; /* number of bits in accum */
754 const unsigned char* p = pstartbyte;
755
756 for (i = 0; i < numsignificantbytes; ++i, p += incr) {
Tim Peters8bc84b42001-06-12 19:17:03 +0000757 twodigits thisbyte = *p;
Tim Peters2a9b3672001-06-11 21:23:58 +0000758 /* Compute correction for 2's comp, if needed. */
759 if (is_signed) {
760 thisbyte = (0xff ^ thisbyte) + carry;
761 carry = thisbyte >> 8;
762 thisbyte &= 0xff;
763 }
764 /* Because we're going LSB to MSB, thisbyte is
765 more significant than what's already in accum,
766 so needs to be prepended to accum. */
Mark Dickinson17e55872009-01-24 15:56:57 +0000767 accum |= (twodigits)thisbyte << accumbits;
Tim Peters2a9b3672001-06-11 21:23:58 +0000768 accumbits += 8;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000769 if (accumbits >= PyLong_SHIFT) {
Tim Peters2a9b3672001-06-11 21:23:58 +0000770 /* There's enough to fill a Python digit. */
Mark Dickinson5a74bf62009-02-15 11:04:38 +0000771 assert(idigit < ndigits);
772 v->ob_digit[idigit] = (digit)(accum &
773 PyLong_MASK);
Tim Peters2a9b3672001-06-11 21:23:58 +0000774 ++idigit;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000775 accum >>= PyLong_SHIFT;
776 accumbits -= PyLong_SHIFT;
777 assert(accumbits < PyLong_SHIFT);
Tim Peters2a9b3672001-06-11 21:23:58 +0000778 }
779 }
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000780 assert(accumbits < PyLong_SHIFT);
Tim Peters2a9b3672001-06-11 21:23:58 +0000781 if (accumbits) {
Mark Dickinson5a74bf62009-02-15 11:04:38 +0000782 assert(idigit < ndigits);
Tim Peters2a9b3672001-06-11 21:23:58 +0000783 v->ob_digit[idigit] = (digit)accum;
784 ++idigit;
785 }
786 }
787
Christian Heimes90aa7642007-12-19 02:45:37 +0000788 Py_SIZE(v) = is_signed ? -idigit : idigit;
Tim Peters2a9b3672001-06-11 21:23:58 +0000789 return (PyObject *)long_normalize(v);
790}
791
792int
793_PyLong_AsByteArray(PyLongObject* v,
794 unsigned char* bytes, size_t n,
795 int little_endian, int is_signed)
796{
Mark Dickinson17e55872009-01-24 15:56:57 +0000797 Py_ssize_t i; /* index into v->ob_digit */
Martin v. Löwis18e16552006-02-15 17:27:45 +0000798 Py_ssize_t ndigits; /* |v->ob_size| */
Tim Peters2a9b3672001-06-11 21:23:58 +0000799 twodigits accum; /* sliding register */
800 unsigned int accumbits; /* # bits in accum */
801 int do_twos_comp; /* store 2's-comp? is_signed and v < 0 */
Mark Dickinson1e2d8702009-01-25 22:25:06 +0000802 digit carry; /* for computing 2's-comp */
Tim Peters2a9b3672001-06-11 21:23:58 +0000803 size_t j; /* # bytes filled */
804 unsigned char* p; /* pointer to next byte in bytes */
805 int pincr; /* direction to move p */
806
807 assert(v != NULL && PyLong_Check(v));
808
Christian Heimes90aa7642007-12-19 02:45:37 +0000809 if (Py_SIZE(v) < 0) {
810 ndigits = -(Py_SIZE(v));
Tim Peters2a9b3672001-06-11 21:23:58 +0000811 if (!is_signed) {
Mark Dickinson21776072009-02-10 16:13:25 +0000812 PyErr_SetString(PyExc_OverflowError,
Guido van Rossumddefaf32007-01-14 03:31:43 +0000813 "can't convert negative int to unsigned");
Tim Peters2a9b3672001-06-11 21:23:58 +0000814 return -1;
815 }
816 do_twos_comp = 1;
817 }
818 else {
Christian Heimes90aa7642007-12-19 02:45:37 +0000819 ndigits = Py_SIZE(v);
Tim Peters2a9b3672001-06-11 21:23:58 +0000820 do_twos_comp = 0;
821 }
822
823 if (little_endian) {
824 p = bytes;
825 pincr = 1;
826 }
827 else {
828 p = bytes + n - 1;
829 pincr = -1;
830 }
831
Tim Peters898cf852001-06-13 20:50:08 +0000832 /* Copy over all the Python digits.
833 It's crucial that every Python digit except for the MSD contribute
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000834 exactly PyLong_SHIFT bits to the total, so first assert that the long is
Tim Peters898cf852001-06-13 20:50:08 +0000835 normalized. */
836 assert(ndigits == 0 || v->ob_digit[ndigits - 1] != 0);
Tim Peters2a9b3672001-06-11 21:23:58 +0000837 j = 0;
838 accum = 0;
839 accumbits = 0;
840 carry = do_twos_comp ? 1 : 0;
841 for (i = 0; i < ndigits; ++i) {
Mark Dickinson17e55872009-01-24 15:56:57 +0000842 digit thisdigit = v->ob_digit[i];
Tim Peters2a9b3672001-06-11 21:23:58 +0000843 if (do_twos_comp) {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +0000844 thisdigit = (thisdigit ^ PyLong_MASK) + carry;
845 carry = thisdigit >> PyLong_SHIFT;
846 thisdigit &= PyLong_MASK;
Tim Peters2a9b3672001-06-11 21:23:58 +0000847 }
Tim Peters8bc84b42001-06-12 19:17:03 +0000848 /* Because we're going LSB to MSB, thisdigit is more
849 significant than what's already in accum, so needs to be
850 prepended to accum. */
Mark Dickinson17e55872009-01-24 15:56:57 +0000851 accum |= (twodigits)thisdigit << accumbits;
Tim Peters8bc84b42001-06-12 19:17:03 +0000852
Tim Petersede05092001-06-14 08:53:38 +0000853 /* The most-significant digit may be (probably is) at least
854 partly empty. */
Tim Peters8bc84b42001-06-12 19:17:03 +0000855 if (i == ndigits - 1) {
Tim Petersede05092001-06-14 08:53:38 +0000856 /* Count # of sign bits -- they needn't be stored,
857 * although for signed conversion we need later to
Mark Dickinson17e55872009-01-24 15:56:57 +0000858 * make sure at least one sign bit gets stored. */
859 digit s = do_twos_comp ? thisdigit ^ PyLong_MASK :
860 thisdigit;
861 while (s != 0) {
862 s >>= 1;
863 accumbits++;
Tim Peters7a3bfc32001-06-12 01:22:22 +0000864 }
Tim Peters7a3bfc32001-06-12 01:22:22 +0000865 }
Mark Dickinson17e55872009-01-24 15:56:57 +0000866 else
867 accumbits += PyLong_SHIFT;
Tim Peters8bc84b42001-06-12 19:17:03 +0000868
Tim Peters2a9b3672001-06-11 21:23:58 +0000869 /* Store as many bytes as possible. */
Tim Peters7a3bfc32001-06-12 01:22:22 +0000870 while (accumbits >= 8) {
Tim Peters2a9b3672001-06-11 21:23:58 +0000871 if (j >= n)
872 goto Overflow;
873 ++j;
874 *p = (unsigned char)(accum & 0xff);
875 p += pincr;
876 accumbits -= 8;
877 accum >>= 8;
Tim Peters7a3bfc32001-06-12 01:22:22 +0000878 }
Tim Peters2a9b3672001-06-11 21:23:58 +0000879 }
880
881 /* Store the straggler (if any). */
882 assert(accumbits < 8);
883 assert(carry == 0); /* else do_twos_comp and *every* digit was 0 */
Tim Peters7a3bfc32001-06-12 01:22:22 +0000884 if (accumbits > 0) {
Tim Peters2a9b3672001-06-11 21:23:58 +0000885 if (j >= n)
886 goto Overflow;
887 ++j;
888 if (do_twos_comp) {
889 /* Fill leading bits of the byte with sign bits
890 (appropriately pretending that the long had an
891 infinite supply of sign bits). */
892 accum |= (~(twodigits)0) << accumbits;
893 }
894 *p = (unsigned char)(accum & 0xff);
895 p += pincr;
896 }
Tim Peters05607ad2001-06-13 21:01:27 +0000897 else if (j == n && n > 0 && is_signed) {
898 /* The main loop filled the byte array exactly, so the code
899 just above didn't get to ensure there's a sign bit, and the
900 loop below wouldn't add one either. Make sure a sign bit
901 exists. */
Tim Peters2a9b3672001-06-11 21:23:58 +0000902 unsigned char msb = *(p - pincr);
Tim Peters05607ad2001-06-13 21:01:27 +0000903 int sign_bit_set = msb >= 0x80;
904 assert(accumbits == 0);
905 if (sign_bit_set == do_twos_comp)
906 return 0;
907 else
Tim Peters2a9b3672001-06-11 21:23:58 +0000908 goto Overflow;
909 }
Tim Peters05607ad2001-06-13 21:01:27 +0000910
911 /* Fill remaining bytes with copies of the sign bit. */
912 {
913 unsigned char signbyte = do_twos_comp ? 0xffU : 0U;
914 for ( ; j < n; ++j, p += pincr)
915 *p = signbyte;
916 }
917
Tim Peters2a9b3672001-06-11 21:23:58 +0000918 return 0;
919
920Overflow:
Guido van Rossumddefaf32007-01-14 03:31:43 +0000921 PyErr_SetString(PyExc_OverflowError, "int too big to convert");
Tim Peters2a9b3672001-06-11 21:23:58 +0000922 return -1;
Tim Peters5af4e6c2002-08-12 02:31:19 +0000923
Tim Peters2a9b3672001-06-11 21:23:58 +0000924}
925
Guido van Rossum78694d91998-09-18 14:14:13 +0000926/* Create a new long (or int) object from a C pointer */
927
928PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +0000929PyLong_FromVoidPtr(void *p)
Guido van Rossum78694d91998-09-18 14:14:13 +0000930{
Tim Peters70128a12001-06-16 08:48:40 +0000931#ifndef HAVE_LONG_LONG
932# error "PyLong_FromVoidPtr: sizeof(void*) > sizeof(long), but no long long"
933#endif
934#if SIZEOF_LONG_LONG < SIZEOF_VOID_P
Martin v. Löwisb9a0f912003-03-29 10:06:18 +0000935# error "PyLong_FromVoidPtr: sizeof(PY_LONG_LONG) < sizeof(void*)"
Tim Peters70128a12001-06-16 08:48:40 +0000936#endif
Guido van Rossumddefaf32007-01-14 03:31:43 +0000937 /* special-case null pointer */
938 if (!p)
Christian Heimes217cfd12007-12-02 14:31:20 +0000939 return PyLong_FromLong(0);
Guido van Rossumddefaf32007-01-14 03:31:43 +0000940 return PyLong_FromUnsignedLongLong((unsigned PY_LONG_LONG)(Py_uintptr_t)p);
Tim Peters70128a12001-06-16 08:48:40 +0000941
Guido van Rossum78694d91998-09-18 14:14:13 +0000942}
943
944/* Get a C pointer from a long object (or an int object in some cases) */
945
946void *
Tim Peters9f688bf2000-07-07 15:53:28 +0000947PyLong_AsVoidPtr(PyObject *vv)
Guido van Rossum78694d91998-09-18 14:14:13 +0000948{
949 /* This function will allow int or long objects. If vv is neither,
950 then the PyLong_AsLong*() functions will raise the exception:
951 PyExc_SystemError, "bad argument to internal function"
952 */
Tim Peters70128a12001-06-16 08:48:40 +0000953#if SIZEOF_VOID_P <= SIZEOF_LONG
Guido van Rossum78694d91998-09-18 14:14:13 +0000954 long x;
955
Guido van Rossumddefaf32007-01-14 03:31:43 +0000956 if (PyLong_Check(vv) && _PyLong_Sign(vv) < 0)
Guido van Rossum78694d91998-09-18 14:14:13 +0000957 x = PyLong_AsLong(vv);
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000958 else
959 x = PyLong_AsUnsignedLong(vv);
Guido van Rossum78694d91998-09-18 14:14:13 +0000960#else
Tim Peters70128a12001-06-16 08:48:40 +0000961
962#ifndef HAVE_LONG_LONG
963# error "PyLong_AsVoidPtr: sizeof(void*) > sizeof(long), but no long long"
964#endif
965#if SIZEOF_LONG_LONG < SIZEOF_VOID_P
Martin v. Löwisb9a0f912003-03-29 10:06:18 +0000966# error "PyLong_AsVoidPtr: sizeof(PY_LONG_LONG) < sizeof(void*)"
Tim Peters70128a12001-06-16 08:48:40 +0000967#endif
Martin v. Löwisb9a0f912003-03-29 10:06:18 +0000968 PY_LONG_LONG x;
Guido van Rossum78694d91998-09-18 14:14:13 +0000969
Guido van Rossumddefaf32007-01-14 03:31:43 +0000970 if (PyLong_Check(vv) && _PyLong_Sign(vv) < 0)
Guido van Rossum78694d91998-09-18 14:14:13 +0000971 x = PyLong_AsLongLong(vv);
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000972 else
973 x = PyLong_AsUnsignedLongLong(vv);
Tim Peters70128a12001-06-16 08:48:40 +0000974
975#endif /* SIZEOF_VOID_P <= SIZEOF_LONG */
Guido van Rossum78694d91998-09-18 14:14:13 +0000976
977 if (x == -1 && PyErr_Occurred())
978 return NULL;
979 return (void *)x;
980}
981
Guido van Rossum1a8791e1998-08-04 22:46:29 +0000982#ifdef HAVE_LONG_LONG
Tim Petersd1a7da62001-06-13 00:35:57 +0000983
Martin v. Löwisb9a0f912003-03-29 10:06:18 +0000984/* Initial PY_LONG_LONG support by Chris Herborth (chrish@qnx.com), later
Tim Petersd1a7da62001-06-13 00:35:57 +0000985 * rewritten to use the newer PyLong_{As,From}ByteArray API.
Guido van Rossum1a8791e1998-08-04 22:46:29 +0000986 */
987
Tim Peterscf37dfc2001-06-14 18:42:50 +0000988#define IS_LITTLE_ENDIAN (int)*(unsigned char*)&one
Mark Dickinson93f562c2010-01-30 10:30:15 +0000989#define PY_ABS_LLONG_MIN (0-(unsigned PY_LONG_LONG)PY_LLONG_MIN)
Tim Petersd1a7da62001-06-13 00:35:57 +0000990
Martin v. Löwisb9a0f912003-03-29 10:06:18 +0000991/* Create a new long int object from a C PY_LONG_LONG int. */
Guido van Rossum1a8791e1998-08-04 22:46:29 +0000992
993PyObject *
Martin v. Löwisb9a0f912003-03-29 10:06:18 +0000994PyLong_FromLongLong(PY_LONG_LONG ival)
Guido van Rossum1a8791e1998-08-04 22:46:29 +0000995{
Thomas Wouters477c8d52006-05-27 19:21:47 +0000996 PyLongObject *v;
Christian Heimesdae2a892008-04-19 00:55:37 +0000997 unsigned PY_LONG_LONG abs_ival;
Thomas Wouters477c8d52006-05-27 19:21:47 +0000998 unsigned PY_LONG_LONG t; /* unsigned so >> doesn't propagate sign bit */
999 int ndigits = 0;
1000 int negative = 0;
1001
Guido van Rossumddefaf32007-01-14 03:31:43 +00001002 CHECK_SMALL_INT(ival);
Thomas Wouters477c8d52006-05-27 19:21:47 +00001003 if (ival < 0) {
Christian Heimesdae2a892008-04-19 00:55:37 +00001004 /* avoid signed overflow on negation; see comments
1005 in PyLong_FromLong above. */
1006 abs_ival = (unsigned PY_LONG_LONG)(-1-ival) + 1;
Thomas Wouters477c8d52006-05-27 19:21:47 +00001007 negative = 1;
1008 }
Christian Heimesdae2a892008-04-19 00:55:37 +00001009 else {
1010 abs_ival = (unsigned PY_LONG_LONG)ival;
1011 }
Thomas Wouters477c8d52006-05-27 19:21:47 +00001012
1013 /* Count the number of Python digits.
1014 We used to pick 5 ("big enough for anything"), but that's a
1015 waste of time and space given that 5*15 = 75 bits are rarely
1016 needed. */
Christian Heimesdae2a892008-04-19 00:55:37 +00001017 t = abs_ival;
Thomas Wouters477c8d52006-05-27 19:21:47 +00001018 while (t) {
1019 ++ndigits;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001020 t >>= PyLong_SHIFT;
Thomas Wouters477c8d52006-05-27 19:21:47 +00001021 }
1022 v = _PyLong_New(ndigits);
1023 if (v != NULL) {
1024 digit *p = v->ob_digit;
Christian Heimes90aa7642007-12-19 02:45:37 +00001025 Py_SIZE(v) = negative ? -ndigits : ndigits;
Christian Heimesdae2a892008-04-19 00:55:37 +00001026 t = abs_ival;
Thomas Wouters477c8d52006-05-27 19:21:47 +00001027 while (t) {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001028 *p++ = (digit)(t & PyLong_MASK);
1029 t >>= PyLong_SHIFT;
Thomas Wouters477c8d52006-05-27 19:21:47 +00001030 }
1031 }
1032 return (PyObject *)v;
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001033}
1034
Martin v. Löwisb9a0f912003-03-29 10:06:18 +00001035/* Create a new long int object from a C unsigned PY_LONG_LONG int. */
Tim Petersd1a7da62001-06-13 00:35:57 +00001036
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001037PyObject *
Martin v. Löwisb9a0f912003-03-29 10:06:18 +00001038PyLong_FromUnsignedLongLong(unsigned PY_LONG_LONG ival)
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001039{
Thomas Wouters477c8d52006-05-27 19:21:47 +00001040 PyLongObject *v;
1041 unsigned PY_LONG_LONG t;
1042 int ndigits = 0;
1043
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001044 if (ival < PyLong_BASE)
Mark Dickinson50b2b6e2008-12-05 17:14:29 +00001045 return PyLong_FromLong((long)ival);
Thomas Wouters477c8d52006-05-27 19:21:47 +00001046 /* Count the number of Python digits. */
1047 t = (unsigned PY_LONG_LONG)ival;
1048 while (t) {
1049 ++ndigits;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001050 t >>= PyLong_SHIFT;
Thomas Wouters477c8d52006-05-27 19:21:47 +00001051 }
1052 v = _PyLong_New(ndigits);
1053 if (v != NULL) {
1054 digit *p = v->ob_digit;
Christian Heimes90aa7642007-12-19 02:45:37 +00001055 Py_SIZE(v) = ndigits;
Thomas Wouters477c8d52006-05-27 19:21:47 +00001056 while (ival) {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001057 *p++ = (digit)(ival & PyLong_MASK);
1058 ival >>= PyLong_SHIFT;
Thomas Wouters477c8d52006-05-27 19:21:47 +00001059 }
1060 }
1061 return (PyObject *)v;
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001062}
1063
Martin v. Löwis18e16552006-02-15 17:27:45 +00001064/* Create a new long int object from a C Py_ssize_t. */
1065
1066PyObject *
Guido van Rossumddefaf32007-01-14 03:31:43 +00001067PyLong_FromSsize_t(Py_ssize_t ival)
Martin v. Löwis18e16552006-02-15 17:27:45 +00001068{
Mark Dickinson7ab6be22008-04-15 21:42:42 +00001069 PyLongObject *v;
1070 size_t abs_ival;
1071 size_t t; /* unsigned so >> doesn't propagate sign bit */
1072 int ndigits = 0;
1073 int negative = 0;
1074
1075 CHECK_SMALL_INT(ival);
1076 if (ival < 0) {
1077 /* avoid signed overflow when ival = SIZE_T_MIN */
1078 abs_ival = (size_t)(-1-ival)+1;
1079 negative = 1;
1080 }
1081 else {
1082 abs_ival = (size_t)ival;
1083 }
1084
1085 /* Count the number of Python digits. */
1086 t = abs_ival;
1087 while (t) {
1088 ++ndigits;
1089 t >>= PyLong_SHIFT;
1090 }
1091 v = _PyLong_New(ndigits);
1092 if (v != NULL) {
1093 digit *p = v->ob_digit;
1094 Py_SIZE(v) = negative ? -ndigits : ndigits;
1095 t = abs_ival;
1096 while (t) {
1097 *p++ = (digit)(t & PyLong_MASK);
1098 t >>= PyLong_SHIFT;
1099 }
1100 }
1101 return (PyObject *)v;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001102}
1103
1104/* Create a new long int object from a C size_t. */
1105
1106PyObject *
Guido van Rossumddefaf32007-01-14 03:31:43 +00001107PyLong_FromSize_t(size_t ival)
Martin v. Löwis18e16552006-02-15 17:27:45 +00001108{
Mark Dickinson7ab6be22008-04-15 21:42:42 +00001109 PyLongObject *v;
1110 size_t t;
1111 int ndigits = 0;
1112
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001113 if (ival < PyLong_BASE)
Guido van Rossumddefaf32007-01-14 03:31:43 +00001114 return PyLong_FromLong(ival);
Mark Dickinson7ab6be22008-04-15 21:42:42 +00001115 /* Count the number of Python digits. */
1116 t = ival;
1117 while (t) {
1118 ++ndigits;
1119 t >>= PyLong_SHIFT;
1120 }
1121 v = _PyLong_New(ndigits);
1122 if (v != NULL) {
1123 digit *p = v->ob_digit;
1124 Py_SIZE(v) = ndigits;
1125 while (ival) {
1126 *p++ = (digit)(ival & PyLong_MASK);
1127 ival >>= PyLong_SHIFT;
1128 }
1129 }
1130 return (PyObject *)v;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001131}
1132
Martin v. Löwisb9a0f912003-03-29 10:06:18 +00001133/* Get a C PY_LONG_LONG int from a long int object.
Tim Petersd1a7da62001-06-13 00:35:57 +00001134 Return -1 and set an error if overflow occurs. */
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001135
Martin v. Löwisb9a0f912003-03-29 10:06:18 +00001136PY_LONG_LONG
Tim Peters9f688bf2000-07-07 15:53:28 +00001137PyLong_AsLongLong(PyObject *vv)
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001138{
Guido van Rossumddefaf32007-01-14 03:31:43 +00001139 PyLongObject *v;
Martin v. Löwisb9a0f912003-03-29 10:06:18 +00001140 PY_LONG_LONG bytes;
Tim Petersd1a7da62001-06-13 00:35:57 +00001141 int one = 1;
1142 int res;
1143
Tim Petersd38b1c72001-09-30 05:09:37 +00001144 if (vv == NULL) {
1145 PyErr_BadInternalCall();
1146 return -1;
1147 }
1148 if (!PyLong_Check(vv)) {
Martin v. Löwis6ce7ed22005-03-03 12:26:35 +00001149 PyNumberMethods *nb;
1150 PyObject *io;
Martin v. Löwis6ce7ed22005-03-03 12:26:35 +00001151 if ((nb = vv->ob_type->tp_as_number) == NULL ||
1152 nb->nb_int == NULL) {
1153 PyErr_SetString(PyExc_TypeError, "an integer is required");
1154 return -1;
1155 }
1156 io = (*nb->nb_int) (vv);
1157 if (io == NULL)
1158 return -1;
Martin v. Löwis6ce7ed22005-03-03 12:26:35 +00001159 if (PyLong_Check(io)) {
1160 bytes = PyLong_AsLongLong(io);
1161 Py_DECREF(io);
1162 return bytes;
1163 }
1164 Py_DECREF(io);
1165 PyErr_SetString(PyExc_TypeError, "integer conversion failed");
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001166 return -1;
1167 }
1168
Guido van Rossumddefaf32007-01-14 03:31:43 +00001169 v = (PyLongObject*)vv;
Christian Heimes90aa7642007-12-19 02:45:37 +00001170 switch(Py_SIZE(v)) {
Mark Dickinson0d4785b2009-02-15 17:27:41 +00001171 case -1: return -(sdigit)v->ob_digit[0];
Guido van Rossumddefaf32007-01-14 03:31:43 +00001172 case 0: return 0;
1173 case 1: return v->ob_digit[0];
1174 }
Tim Petersd1a7da62001-06-13 00:35:57 +00001175 res = _PyLong_AsByteArray(
1176 (PyLongObject *)vv, (unsigned char *)&bytes,
1177 SIZEOF_LONG_LONG, IS_LITTLE_ENDIAN, 1);
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001178
Martin v. Löwisb9a0f912003-03-29 10:06:18 +00001179 /* Plan 9 can't handle PY_LONG_LONG in ? : expressions */
Martin v. Löwisc8bb9eb2002-03-09 12:02:59 +00001180 if (res < 0)
Martin v. Löwisb9a0f912003-03-29 10:06:18 +00001181 return (PY_LONG_LONG)-1;
Martin v. Löwisc8bb9eb2002-03-09 12:02:59 +00001182 else
1183 return bytes;
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001184}
1185
Martin v. Löwisb9a0f912003-03-29 10:06:18 +00001186/* Get a C unsigned PY_LONG_LONG int from a long int object.
Tim Petersd1a7da62001-06-13 00:35:57 +00001187 Return -1 and set an error if overflow occurs. */
1188
Martin v. Löwisb9a0f912003-03-29 10:06:18 +00001189unsigned PY_LONG_LONG
Tim Peters9f688bf2000-07-07 15:53:28 +00001190PyLong_AsUnsignedLongLong(PyObject *vv)
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001191{
Guido van Rossumddefaf32007-01-14 03:31:43 +00001192 PyLongObject *v;
Martin v. Löwisb9a0f912003-03-29 10:06:18 +00001193 unsigned PY_LONG_LONG bytes;
Tim Petersd1a7da62001-06-13 00:35:57 +00001194 int one = 1;
1195 int res;
1196
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001197 if (vv == NULL || !PyLong_Check(vv)) {
1198 PyErr_BadInternalCall();
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001199 return (unsigned PY_LONG_LONG)-1;
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001200 }
1201
Guido van Rossumddefaf32007-01-14 03:31:43 +00001202 v = (PyLongObject*)vv;
Christian Heimes90aa7642007-12-19 02:45:37 +00001203 switch(Py_SIZE(v)) {
Guido van Rossumddefaf32007-01-14 03:31:43 +00001204 case 0: return 0;
1205 case 1: return v->ob_digit[0];
1206 }
1207
Tim Petersd1a7da62001-06-13 00:35:57 +00001208 res = _PyLong_AsByteArray(
1209 (PyLongObject *)vv, (unsigned char *)&bytes,
1210 SIZEOF_LONG_LONG, IS_LITTLE_ENDIAN, 0);
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001211
Martin v. Löwisb9a0f912003-03-29 10:06:18 +00001212 /* Plan 9 can't handle PY_LONG_LONG in ? : expressions */
Martin v. Löwisc8bb9eb2002-03-09 12:02:59 +00001213 if (res < 0)
Martin v. Löwisb9a0f912003-03-29 10:06:18 +00001214 return (unsigned PY_LONG_LONG)res;
Martin v. Löwisc8bb9eb2002-03-09 12:02:59 +00001215 else
1216 return bytes;
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001217}
Tim Petersd1a7da62001-06-13 00:35:57 +00001218
Thomas Hellera4ea6032003-04-17 18:55:45 +00001219/* Get a C unsigned long int from a long int object, ignoring the high bits.
1220 Returns -1 and sets an error condition if an error occurs. */
1221
Guido van Rossumddefaf32007-01-14 03:31:43 +00001222static unsigned PY_LONG_LONG
1223_PyLong_AsUnsignedLongLongMask(PyObject *vv)
Thomas Hellera4ea6032003-04-17 18:55:45 +00001224{
1225 register PyLongObject *v;
1226 unsigned PY_LONG_LONG x;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001227 Py_ssize_t i;
1228 int sign;
Thomas Hellera4ea6032003-04-17 18:55:45 +00001229
1230 if (vv == NULL || !PyLong_Check(vv)) {
1231 PyErr_BadInternalCall();
1232 return (unsigned long) -1;
1233 }
1234 v = (PyLongObject *)vv;
Christian Heimes90aa7642007-12-19 02:45:37 +00001235 switch(Py_SIZE(v)) {
Guido van Rossumddefaf32007-01-14 03:31:43 +00001236 case 0: return 0;
1237 case 1: return v->ob_digit[0];
1238 }
Christian Heimes90aa7642007-12-19 02:45:37 +00001239 i = Py_SIZE(v);
Thomas Hellera4ea6032003-04-17 18:55:45 +00001240 sign = 1;
1241 x = 0;
1242 if (i < 0) {
1243 sign = -1;
1244 i = -i;
1245 }
1246 while (--i >= 0) {
Mark Dickinson24f57852009-09-28 17:54:52 +00001247 x = (x << PyLong_SHIFT) | v->ob_digit[i];
Thomas Hellera4ea6032003-04-17 18:55:45 +00001248 }
1249 return x * sign;
1250}
Guido van Rossumddefaf32007-01-14 03:31:43 +00001251
1252unsigned PY_LONG_LONG
1253PyLong_AsUnsignedLongLongMask(register PyObject *op)
1254{
1255 PyNumberMethods *nb;
1256 PyLongObject *lo;
1257 unsigned PY_LONG_LONG val;
1258
1259 if (op && PyLong_Check(op))
1260 return _PyLong_AsUnsignedLongLongMask(op);
1261
1262 if (op == NULL || (nb = op->ob_type->tp_as_number) == NULL ||
1263 nb->nb_int == NULL) {
1264 PyErr_SetString(PyExc_TypeError, "an integer is required");
1265 return (unsigned PY_LONG_LONG)-1;
1266 }
1267
1268 lo = (PyLongObject*) (*nb->nb_int) (op);
1269 if (lo == NULL)
1270 return (unsigned PY_LONG_LONG)-1;
1271 if (PyLong_Check(lo)) {
1272 val = _PyLong_AsUnsignedLongLongMask((PyObject *)lo);
1273 Py_DECREF(lo);
1274 if (PyErr_Occurred())
1275 return (unsigned PY_LONG_LONG)-1;
1276 return val;
1277 }
1278 else
1279 {
1280 Py_DECREF(lo);
1281 PyErr_SetString(PyExc_TypeError,
1282 "nb_int should return int object");
1283 return (unsigned PY_LONG_LONG)-1;
1284 }
1285}
Tim Petersd1a7da62001-06-13 00:35:57 +00001286#undef IS_LITTLE_ENDIAN
1287
Mark Dickinson93f562c2010-01-30 10:30:15 +00001288/* Get a C long long int from a Python long or Python int object.
1289 On overflow, returns -1 and sets *overflow to 1 or -1 depending
1290 on the sign of the result. Otherwise *overflow is 0.
1291
1292 For other errors (e.g., type error), returns -1 and sets an error
1293 condition.
1294*/
1295
1296PY_LONG_LONG
1297PyLong_AsLongLongAndOverflow(PyObject *vv, int *overflow)
1298{
1299 /* This version by Tim Peters */
1300 register PyLongObject *v;
1301 unsigned PY_LONG_LONG x, prev;
1302 PY_LONG_LONG res;
1303 Py_ssize_t i;
1304 int sign;
1305 int do_decref = 0; /* if nb_int was called */
1306
1307 *overflow = 0;
1308 if (vv == NULL) {
1309 PyErr_BadInternalCall();
1310 return -1;
1311 }
1312
1313 if (!PyLong_Check(vv)) {
1314 PyNumberMethods *nb;
1315 nb = vv->ob_type->tp_as_number;
1316 if (nb == NULL || nb->nb_int == NULL) {
1317 PyErr_SetString(PyExc_TypeError,
1318 "an integer is required");
1319 return -1;
1320 }
1321 vv = (*nb->nb_int) (vv);
1322 if (vv == NULL)
1323 return -1;
1324 do_decref = 1;
1325 if (!PyLong_Check(vv)) {
1326 Py_DECREF(vv);
1327 PyErr_SetString(PyExc_TypeError,
1328 "nb_int should return int object");
1329 return -1;
1330 }
1331 }
1332
1333 res = -1;
1334 v = (PyLongObject *)vv;
1335 i = Py_SIZE(v);
1336
1337 switch (i) {
1338 case -1:
1339 res = -(sdigit)v->ob_digit[0];
1340 break;
1341 case 0:
1342 res = 0;
1343 break;
1344 case 1:
1345 res = v->ob_digit[0];
1346 break;
1347 default:
1348 sign = 1;
1349 x = 0;
1350 if (i < 0) {
1351 sign = -1;
1352 i = -(i);
1353 }
1354 while (--i >= 0) {
1355 prev = x;
1356 x = (x << PyLong_SHIFT) + v->ob_digit[i];
1357 if ((x >> PyLong_SHIFT) != prev) {
1358 *overflow = sign;
1359 goto exit;
1360 }
1361 }
1362 /* Haven't lost any bits, but casting to long requires extra
1363 * care (see comment above).
1364 */
1365 if (x <= (unsigned PY_LONG_LONG)PY_LLONG_MAX) {
1366 res = (PY_LONG_LONG)x * sign;
1367 }
1368 else if (sign < 0 && x == PY_ABS_LLONG_MIN) {
1369 res = PY_LLONG_MIN;
1370 }
1371 else {
1372 *overflow = sign;
1373 /* res is already set to -1 */
1374 }
1375 }
1376 exit:
1377 if (do_decref) {
1378 Py_DECREF(vv);
1379 }
1380 return res;
1381}
1382
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001383#endif /* HAVE_LONG_LONG */
1384
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00001385#define CHECK_BINOP(v,w) \
1386 if (!PyLong_Check(v) || !PyLong_Check(w)) { \
Neil Schemenauerba872e22001-01-04 01:46:03 +00001387 Py_INCREF(Py_NotImplemented); \
1388 return Py_NotImplemented; \
1389 }
1390
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00001391/* bits_in_digit(d) returns the unique integer k such that 2**(k-1) <= d <
1392 2**k if d is nonzero, else 0. */
1393
1394static const unsigned char BitLengthTable[32] = {
1395 0, 1, 2, 2, 3, 3, 3, 3, 4, 4, 4, 4, 4, 4, 4, 4,
1396 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5
1397};
1398
1399static int
1400bits_in_digit(digit d)
1401{
1402 int d_bits = 0;
1403 while (d >= 32) {
1404 d_bits += 6;
1405 d >>= 6;
1406 }
1407 d_bits += (int)BitLengthTable[d];
1408 return d_bits;
1409}
1410
Tim Peters877a2122002-08-12 05:09:36 +00001411/* x[0:m] and y[0:n] are digit vectors, LSD first, m >= n required. x[0:n]
1412 * is modified in place, by adding y to it. Carries are propagated as far as
1413 * x[m-1], and the remaining carry (0 or 1) is returned.
1414 */
1415static digit
Martin v. Löwis18e16552006-02-15 17:27:45 +00001416v_iadd(digit *x, Py_ssize_t m, digit *y, Py_ssize_t n)
Tim Peters877a2122002-08-12 05:09:36 +00001417{
Mark Dickinson17e55872009-01-24 15:56:57 +00001418 Py_ssize_t i;
Tim Peters877a2122002-08-12 05:09:36 +00001419 digit carry = 0;
1420
1421 assert(m >= n);
1422 for (i = 0; i < n; ++i) {
1423 carry += x[i] + y[i];
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001424 x[i] = carry & PyLong_MASK;
1425 carry >>= PyLong_SHIFT;
Tim Peters877a2122002-08-12 05:09:36 +00001426 assert((carry & 1) == carry);
1427 }
1428 for (; carry && i < m; ++i) {
1429 carry += x[i];
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001430 x[i] = carry & PyLong_MASK;
1431 carry >>= PyLong_SHIFT;
Tim Peters877a2122002-08-12 05:09:36 +00001432 assert((carry & 1) == carry);
1433 }
1434 return carry;
1435}
1436
1437/* x[0:m] and y[0:n] are digit vectors, LSD first, m >= n required. x[0:n]
1438 * is modified in place, by subtracting y from it. Borrows are propagated as
1439 * far as x[m-1], and the remaining borrow (0 or 1) is returned.
1440 */
1441static digit
Martin v. Löwis18e16552006-02-15 17:27:45 +00001442v_isub(digit *x, Py_ssize_t m, digit *y, Py_ssize_t n)
Tim Peters877a2122002-08-12 05:09:36 +00001443{
Mark Dickinson17e55872009-01-24 15:56:57 +00001444 Py_ssize_t i;
Tim Peters877a2122002-08-12 05:09:36 +00001445 digit borrow = 0;
1446
1447 assert(m >= n);
1448 for (i = 0; i < n; ++i) {
1449 borrow = x[i] - y[i] - borrow;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001450 x[i] = borrow & PyLong_MASK;
1451 borrow >>= PyLong_SHIFT;
Tim Peters877a2122002-08-12 05:09:36 +00001452 borrow &= 1; /* keep only 1 sign bit */
1453 }
1454 for (; borrow && i < m; ++i) {
1455 borrow = x[i] - borrow;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001456 x[i] = borrow & PyLong_MASK;
1457 borrow >>= PyLong_SHIFT;
Tim Peters877a2122002-08-12 05:09:36 +00001458 borrow &= 1;
1459 }
1460 return borrow;
1461}
Neil Schemenauerba872e22001-01-04 01:46:03 +00001462
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00001463/* Shift digit vector a[0:m] d bits left, with 0 <= d < PyLong_SHIFT. Put
1464 * result in z[0:m], and return the d bits shifted out of the top.
1465 */
1466static digit
1467v_lshift(digit *z, digit *a, Py_ssize_t m, int d)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001468{
Martin v. Löwis18e16552006-02-15 17:27:45 +00001469 Py_ssize_t i;
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00001470 digit carry = 0;
Tim Peters5af4e6c2002-08-12 02:31:19 +00001471
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00001472 assert(0 <= d && d < PyLong_SHIFT);
1473 for (i=0; i < m; i++) {
1474 twodigits acc = (twodigits)a[i] << d | carry;
1475 z[i] = (digit)acc & PyLong_MASK;
1476 carry = (digit)(acc >> PyLong_SHIFT);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001477 }
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00001478 return carry;
1479}
1480
1481/* Shift digit vector a[0:m] d bits right, with 0 <= d < PyLong_SHIFT. Put
1482 * result in z[0:m], and return the d bits shifted out of the bottom.
1483 */
1484static digit
1485v_rshift(digit *z, digit *a, Py_ssize_t m, int d)
1486{
1487 Py_ssize_t i;
1488 digit carry = 0;
1489 digit mask = ((digit)1 << d) - 1U;
1490
1491 assert(0 <= d && d < PyLong_SHIFT);
1492 for (i=m; i-- > 0;) {
1493 twodigits acc = (twodigits)carry << PyLong_SHIFT | a[i];
1494 carry = (digit)acc & mask;
1495 z[i] = (digit)(acc >> d);
1496 }
1497 return carry;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001498}
1499
Tim Peters212e6142001-07-14 12:23:19 +00001500/* Divide long pin, w/ size digits, by non-zero digit n, storing quotient
1501 in pout, and returning the remainder. pin and pout point at the LSD.
1502 It's OK for pin == pout on entry, which saves oodles of mallocs/frees in
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001503 _PyLong_Format, but that should be done with great care since longs are
Tim Peters212e6142001-07-14 12:23:19 +00001504 immutable. */
1505
1506static digit
Martin v. Löwis18e16552006-02-15 17:27:45 +00001507inplace_divrem1(digit *pout, digit *pin, Py_ssize_t size, digit n)
Tim Peters212e6142001-07-14 12:23:19 +00001508{
1509 twodigits rem = 0;
1510
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001511 assert(n > 0 && n <= PyLong_MASK);
Tim Peters212e6142001-07-14 12:23:19 +00001512 pin += size;
1513 pout += size;
1514 while (--size >= 0) {
1515 digit hi;
Mark Dickinson24f57852009-09-28 17:54:52 +00001516 rem = (rem << PyLong_SHIFT) | *--pin;
Tim Peters212e6142001-07-14 12:23:19 +00001517 *--pout = hi = (digit)(rem / n);
Mark Dickinson17e55872009-01-24 15:56:57 +00001518 rem -= (twodigits)hi * n;
Tim Peters212e6142001-07-14 12:23:19 +00001519 }
1520 return (digit)rem;
1521}
1522
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001523/* Divide a long integer by a digit, returning both the quotient
1524 (as function result) and the remainder (through *prem).
1525 The sign of a is ignored; n should not be zero. */
1526
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001527static PyLongObject *
Tim Peters212e6142001-07-14 12:23:19 +00001528divrem1(PyLongObject *a, digit n, digit *prem)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001529{
Christian Heimes90aa7642007-12-19 02:45:37 +00001530 const Py_ssize_t size = ABS(Py_SIZE(a));
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001531 PyLongObject *z;
Tim Peters5af4e6c2002-08-12 02:31:19 +00001532
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001533 assert(n > 0 && n <= PyLong_MASK);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001534 z = _PyLong_New(size);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001535 if (z == NULL)
1536 return NULL;
Tim Peters212e6142001-07-14 12:23:19 +00001537 *prem = inplace_divrem1(z->ob_digit, a->ob_digit, size, n);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001538 return long_normalize(z);
1539}
1540
Mark Dickinson0a1efd02009-09-16 21:23:34 +00001541/* Convert a long integer to a base 10 string. Returns a new non-shared
1542 string. (Return value is non-shared so that callers can modify the
1543 returned value if necessary.) */
1544
1545static PyObject *
1546long_to_decimal_string(PyObject *aa)
1547{
1548 PyLongObject *scratch, *a;
1549 PyObject *str;
1550 Py_ssize_t size, strlen, size_a, i, j;
1551 digit *pout, *pin, rem, tenpow;
1552 Py_UNICODE *p;
1553 int negative;
1554
1555 a = (PyLongObject *)aa;
1556 if (a == NULL || !PyLong_Check(a)) {
1557 PyErr_BadInternalCall();
1558 return NULL;
1559 }
1560 size_a = ABS(Py_SIZE(a));
1561 negative = Py_SIZE(a) < 0;
1562
1563 /* quick and dirty upper bound for the number of digits
1564 required to express a in base _PyLong_DECIMAL_BASE:
1565
1566 #digits = 1 + floor(log2(a) / log2(_PyLong_DECIMAL_BASE))
1567
1568 But log2(a) < size_a * PyLong_SHIFT, and
1569 log2(_PyLong_DECIMAL_BASE) = log2(10) * _PyLong_DECIMAL_SHIFT
1570 > 3 * _PyLong_DECIMAL_SHIFT
1571 */
1572 if (size_a > PY_SSIZE_T_MAX / PyLong_SHIFT) {
1573 PyErr_SetString(PyExc_OverflowError,
1574 "long is too large to format");
1575 return NULL;
1576 }
1577 /* the expression size_a * PyLong_SHIFT is now safe from overflow */
1578 size = 1 + size_a * PyLong_SHIFT / (3 * _PyLong_DECIMAL_SHIFT);
1579 scratch = _PyLong_New(size);
1580 if (scratch == NULL)
1581 return NULL;
1582
1583 /* convert array of base _PyLong_BASE digits in pin to an array of
1584 base _PyLong_DECIMAL_BASE digits in pout, following Knuth (TAOCP,
1585 Volume 2 (3rd edn), section 4.4, Method 1b). */
1586 pin = a->ob_digit;
1587 pout = scratch->ob_digit;
1588 size = 0;
1589 for (i = size_a; --i >= 0; ) {
1590 digit hi = pin[i];
1591 for (j = 0; j < size; j++) {
1592 twodigits z = (twodigits)pout[j] << PyLong_SHIFT | hi;
Mark Dickinson741984d2009-09-21 16:18:27 +00001593 hi = (digit)(z / _PyLong_DECIMAL_BASE);
1594 pout[j] = (digit)(z - (twodigits)hi *
1595 _PyLong_DECIMAL_BASE);
Mark Dickinson0a1efd02009-09-16 21:23:34 +00001596 }
1597 while (hi) {
1598 pout[size++] = hi % _PyLong_DECIMAL_BASE;
1599 hi /= _PyLong_DECIMAL_BASE;
1600 }
1601 /* check for keyboard interrupt */
1602 SIGCHECK({
1603 Py_DECREF(scratch);
1604 return NULL;
1605 })
1606 }
1607 /* pout should have at least one digit, so that the case when a = 0
1608 works correctly */
1609 if (size == 0)
1610 pout[size++] = 0;
1611
1612 /* calculate exact length of output string, and allocate */
1613 strlen = negative + 1 + (size - 1) * _PyLong_DECIMAL_SHIFT;
1614 tenpow = 10;
1615 rem = pout[size-1];
1616 while (rem >= tenpow) {
1617 tenpow *= 10;
1618 strlen++;
1619 }
1620 str = PyUnicode_FromUnicode(NULL, strlen);
1621 if (str == NULL) {
1622 Py_DECREF(scratch);
1623 return NULL;
1624 }
1625
1626 /* fill the string right-to-left */
1627 p = PyUnicode_AS_UNICODE(str) + strlen;
1628 *p = '\0';
1629 /* pout[0] through pout[size-2] contribute exactly
1630 _PyLong_DECIMAL_SHIFT digits each */
1631 for (i=0; i < size - 1; i++) {
1632 rem = pout[i];
1633 for (j = 0; j < _PyLong_DECIMAL_SHIFT; j++) {
1634 *--p = '0' + rem % 10;
1635 rem /= 10;
1636 }
1637 }
1638 /* pout[size-1]: always produce at least one decimal digit */
1639 rem = pout[i];
1640 do {
1641 *--p = '0' + rem % 10;
1642 rem /= 10;
1643 } while (rem != 0);
1644
1645 /* and sign */
1646 if (negative)
1647 *--p = '-';
1648
1649 /* check we've counted correctly */
1650 assert(p == PyUnicode_AS_UNICODE(str));
1651 Py_DECREF(scratch);
1652 return (PyObject *)str;
1653}
1654
Mark Dickinsoncd068122009-09-18 14:53:08 +00001655/* Convert a long int object to a string, using a given conversion base,
1656 which should be one of 2, 8, 10 or 16. Return a string object.
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001657 If base is 2, 8 or 16, add the proper prefix '0b', '0o' or '0x'. */
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001658
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001659PyObject *
1660_PyLong_Format(PyObject *aa, int base)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001661{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001662 register PyLongObject *a = (PyLongObject *)aa;
Walter Dörwald1ab83302007-05-18 17:15:44 +00001663 PyObject *str;
Mark Dickinson659c7b12009-09-13 12:06:08 +00001664 Py_ssize_t i, sz;
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001665 Py_ssize_t size_a;
Mark Dickinsoncd068122009-09-18 14:53:08 +00001666 Py_UNICODE *p, sign = '\0';
Mark Dickinson8accd6b2009-09-17 19:39:12 +00001667 int bits;
Guido van Rossume32e0141992-01-19 16:31:05 +00001668
Mark Dickinsoncd068122009-09-18 14:53:08 +00001669 assert(base == 2 || base == 8 || base == 10 || base == 16);
Mark Dickinson0a1efd02009-09-16 21:23:34 +00001670 if (base == 10)
1671 return long_to_decimal_string((PyObject *)a);
1672
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001673 if (a == NULL || !PyLong_Check(a)) {
1674 PyErr_BadInternalCall();
Guido van Rossume32e0141992-01-19 16:31:05 +00001675 return NULL;
1676 }
Christian Heimes90aa7642007-12-19 02:45:37 +00001677 size_a = ABS(Py_SIZE(a));
Tim Peters5af4e6c2002-08-12 02:31:19 +00001678
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001679 /* Compute a rough upper bound for the length of the string */
Mark Dickinsoncd068122009-09-18 14:53:08 +00001680 switch (base) {
1681 case 16:
1682 bits = 4;
1683 break;
1684 case 8:
1685 bits = 3;
1686 break;
1687 case 2:
1688 bits = 1;
1689 break;
1690 default:
1691 assert(0); /* shouldn't ever get here */
1692 bits = 0; /* to silence gcc warning */
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001693 }
Mark Dickinsoncd068122009-09-18 14:53:08 +00001694 /* compute length of output string: allow 2 characters for prefix and
1695 1 for possible '-' sign. */
1696 if (size_a > (PY_SSIZE_T_MAX - 3) / PyLong_SHIFT) {
Thomas Wouters89f507f2006-12-13 04:49:30 +00001697 PyErr_SetString(PyExc_OverflowError,
Guido van Rossumddefaf32007-01-14 03:31:43 +00001698 "int is too large to format");
Thomas Wouters89f507f2006-12-13 04:49:30 +00001699 return NULL;
1700 }
Mark Dickinsoncd068122009-09-18 14:53:08 +00001701 /* now size_a * PyLong_SHIFT + 3 <= PY_SSIZE_T_MAX, so the RHS below
1702 is safe from overflow */
1703 sz = 3 + (size_a * PyLong_SHIFT + (bits - 1)) / bits;
Mark Dickinson659c7b12009-09-13 12:06:08 +00001704 assert(sz >= 0);
Walter Dörwald1ab83302007-05-18 17:15:44 +00001705 str = PyUnicode_FromUnicode(NULL, sz);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001706 if (str == NULL)
1707 return NULL;
Walter Dörwald1ab83302007-05-18 17:15:44 +00001708 p = PyUnicode_AS_UNICODE(str) + sz;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001709 *p = '\0';
Mark Dickinson8accd6b2009-09-17 19:39:12 +00001710 if (Py_SIZE(a) < 0)
1711 sign = '-';
Tim Peters5af4e6c2002-08-12 02:31:19 +00001712
Christian Heimes90aa7642007-12-19 02:45:37 +00001713 if (Py_SIZE(a) == 0) {
Guido van Rossumbd3a5271998-08-11 15:04:47 +00001714 *--p = '0';
1715 }
Mark Dickinsoncd068122009-09-18 14:53:08 +00001716 else {
Mark Dickinson8accd6b2009-09-17 19:39:12 +00001717 /* JRH: special case for power-of-2 bases */
1718 twodigits accum = 0;
1719 int accumbits = 0; /* # of bits in accum */
Mark Dickinson8accd6b2009-09-17 19:39:12 +00001720 for (i = 0; i < size_a; ++i) {
1721 accum |= (twodigits)a->ob_digit[i] << accumbits;
1722 accumbits += PyLong_SHIFT;
Mark Dickinsoncd068122009-09-18 14:53:08 +00001723 assert(accumbits >= bits);
Mark Dickinson8accd6b2009-09-17 19:39:12 +00001724 do {
Mark Dickinson1f7e18c2009-09-24 18:31:17 +00001725 Py_UNICODE cdigit;
1726 cdigit = (Py_UNICODE)(accum & (base - 1));
Mark Dickinson8accd6b2009-09-17 19:39:12 +00001727 cdigit += (cdigit < 10) ? '0' : 'a'-10;
1728 assert(p > PyUnicode_AS_UNICODE(str));
1729 *--p = cdigit;
Mark Dickinsoncd068122009-09-18 14:53:08 +00001730 accumbits -= bits;
1731 accum >>= bits;
1732 } while (i < size_a-1 ? accumbits >= bits : accum > 0);
Mark Dickinson8accd6b2009-09-17 19:39:12 +00001733 }
1734 }
Mark Dickinson8accd6b2009-09-17 19:39:12 +00001735
Mark Dickinsoncd068122009-09-18 14:53:08 +00001736 if (base == 16)
Guido van Rossum3d3037d1991-10-24 14:55:57 +00001737 *--p = 'x';
Mark Dickinsoncd068122009-09-18 14:53:08 +00001738 else if (base == 8)
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001739 *--p = 'o';
Mark Dickinsoncd068122009-09-18 14:53:08 +00001740 else /* (base == 2) */
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001741 *--p = 'b';
Mark Dickinsoncd068122009-09-18 14:53:08 +00001742 *--p = '0';
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001743 if (sign)
1744 *--p = sign;
Walter Dörwald1ab83302007-05-18 17:15:44 +00001745 if (p != PyUnicode_AS_UNICODE(str)) {
1746 Py_UNICODE *q = PyUnicode_AS_UNICODE(str);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001747 assert(p > q);
1748 do {
1749 } while ((*q++ = *p++) != '\0');
Guido van Rossumc7ec9c91991-05-28 21:58:16 +00001750 q--;
Mark Dickinson659c7b12009-09-13 12:06:08 +00001751 if (PyUnicode_Resize(&str,(Py_ssize_t) (q -
1752 PyUnicode_AS_UNICODE(str)))) {
Walter Dörwald1ab83302007-05-18 17:15:44 +00001753 Py_DECREF(str);
1754 return NULL;
1755 }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001756 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001757 return (PyObject *)str;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001758}
1759
Thomas Wouters477c8d52006-05-27 19:21:47 +00001760/* Table of digit values for 8-bit string -> integer conversion.
1761 * '0' maps to 0, ..., '9' maps to 9.
1762 * 'a' and 'A' map to 10, ..., 'z' and 'Z' map to 35.
1763 * All other indices map to 37.
1764 * Note that when converting a base B string, a char c is a legitimate
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001765 * base B digit iff _PyLong_DigitValue[Py_CHARPyLong_MASK(c)] < B.
Thomas Wouters477c8d52006-05-27 19:21:47 +00001766 */
Raymond Hettinger35631532009-01-09 03:58:09 +00001767unsigned char _PyLong_DigitValue[256] = {
Thomas Wouters477c8d52006-05-27 19:21:47 +00001768 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37,
1769 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37,
1770 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37,
1771 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 37, 37, 37, 37, 37, 37,
1772 37, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24,
1773 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 37, 37, 37, 37, 37,
1774 37, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24,
1775 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 37, 37, 37, 37, 37,
1776 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37,
1777 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37,
1778 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37,
1779 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37,
1780 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37,
1781 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37,
1782 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37,
1783 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37, 37,
1784};
1785
1786/* *str points to the first digit in a string of base `base` digits. base
Tim Petersbf2674b2003-02-02 07:51:32 +00001787 * is a power of 2 (2, 4, 8, 16, or 32). *str is set to point to the first
1788 * non-digit (which may be *str!). A normalized long is returned.
1789 * The point to this routine is that it takes time linear in the number of
1790 * string characters.
1791 */
1792static PyLongObject *
1793long_from_binary_base(char **str, int base)
1794{
1795 char *p = *str;
1796 char *start = p;
1797 int bits_per_char;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001798 Py_ssize_t n;
Tim Petersbf2674b2003-02-02 07:51:32 +00001799 PyLongObject *z;
1800 twodigits accum;
1801 int bits_in_accum;
1802 digit *pdigit;
1803
1804 assert(base >= 2 && base <= 32 && (base & (base - 1)) == 0);
1805 n = base;
1806 for (bits_per_char = -1; n; ++bits_per_char)
1807 n >>= 1;
1808 /* n <- total # of bits needed, while setting p to end-of-string */
Christian Heimesbbe741d2008-03-28 10:53:29 +00001809 while (_PyLong_DigitValue[Py_CHARMASK(*p)] < base)
Tim Petersbf2674b2003-02-02 07:51:32 +00001810 ++p;
Tim Petersbf2674b2003-02-02 07:51:32 +00001811 *str = p;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001812 /* n <- # of Python digits needed, = ceiling(n/PyLong_SHIFT). */
1813 n = (p - start) * bits_per_char + PyLong_SHIFT - 1;
Thomas Wouters89f507f2006-12-13 04:49:30 +00001814 if (n / bits_per_char < p - start) {
Tim Peters1a3b19a2003-02-02 17:33:53 +00001815 PyErr_SetString(PyExc_ValueError,
Guido van Rossumddefaf32007-01-14 03:31:43 +00001816 "int string too large to convert");
Tim Peters1a3b19a2003-02-02 17:33:53 +00001817 return NULL;
1818 }
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001819 n = n / PyLong_SHIFT;
Tim Petersbf2674b2003-02-02 07:51:32 +00001820 z = _PyLong_New(n);
1821 if (z == NULL)
1822 return NULL;
1823 /* Read string from right, and fill in long from left; i.e.,
1824 * from least to most significant in both.
1825 */
1826 accum = 0;
1827 bits_in_accum = 0;
1828 pdigit = z->ob_digit;
1829 while (--p >= start) {
Raymond Hettinger35631532009-01-09 03:58:09 +00001830 int k = (int)_PyLong_DigitValue[Py_CHARMASK(*p)];
Tim Petersc7bc0b92003-05-05 20:39:43 +00001831 assert(k >= 0 && k < base);
Mark Dickinson17e55872009-01-24 15:56:57 +00001832 accum |= (twodigits)k << bits_in_accum;
Tim Petersbf2674b2003-02-02 07:51:32 +00001833 bits_in_accum += bits_per_char;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001834 if (bits_in_accum >= PyLong_SHIFT) {
1835 *pdigit++ = (digit)(accum & PyLong_MASK);
Mark Dickinson17e55872009-01-24 15:56:57 +00001836 assert(pdigit - z->ob_digit <= n);
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001837 accum >>= PyLong_SHIFT;
1838 bits_in_accum -= PyLong_SHIFT;
1839 assert(bits_in_accum < PyLong_SHIFT);
Tim Petersbf2674b2003-02-02 07:51:32 +00001840 }
1841 }
1842 if (bits_in_accum) {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00001843 assert(bits_in_accum <= PyLong_SHIFT);
Tim Petersbf2674b2003-02-02 07:51:32 +00001844 *pdigit++ = (digit)accum;
Mark Dickinson17e55872009-01-24 15:56:57 +00001845 assert(pdigit - z->ob_digit <= n);
Tim Petersbf2674b2003-02-02 07:51:32 +00001846 }
1847 while (pdigit - z->ob_digit < n)
1848 *pdigit++ = 0;
1849 return long_normalize(z);
1850}
1851
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001852PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00001853PyLong_FromString(char *str, char **pend, int base)
Guido van Rossumeb1fafc1994-08-29 12:47:19 +00001854{
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001855 int sign = 1, error_if_nonzero = 0;
Guido van Rossum9e896b32000-04-05 20:11:21 +00001856 char *start, *orig_str = str;
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001857 PyLongObject *z = NULL;
Guido van Rossum25236212007-08-22 23:28:23 +00001858 PyObject *strobj;
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001859 Py_ssize_t slen;
Tim Peters5af4e6c2002-08-12 02:31:19 +00001860
Guido van Rossum472c04f1996-12-05 21:57:21 +00001861 if ((base != 0 && base < 2) || base > 36) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00001862 PyErr_SetString(PyExc_ValueError,
Guido van Rossumddefaf32007-01-14 03:31:43 +00001863 "int() arg 2 must be >= 2 and <= 36");
Guido van Rossumeb1fafc1994-08-29 12:47:19 +00001864 return NULL;
1865 }
Guido van Rossum9fa2c111995-02-10 17:00:37 +00001866 while (*str != '\0' && isspace(Py_CHARMASK(*str)))
Guido van Rossumeb1fafc1994-08-29 12:47:19 +00001867 str++;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001868 if (*str == '+')
1869 ++str;
1870 else if (*str == '-') {
1871 ++str;
1872 sign = -1;
1873 }
1874 if (base == 0) {
1875 if (str[0] != '0')
1876 base = 10;
1877 else if (str[1] == 'x' || str[1] == 'X')
1878 base = 16;
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001879 else if (str[1] == 'o' || str[1] == 'O')
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001880 base = 8;
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001881 else if (str[1] == 'b' || str[1] == 'B')
1882 base = 2;
1883 else {
1884 /* "old" (C-style) octal literal, now invalid.
1885 it might still be zero though */
1886 error_if_nonzero = 1;
1887 base = 10;
1888 }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001889 }
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001890 if (str[0] == '0' &&
1891 ((base == 16 && (str[1] == 'x' || str[1] == 'X')) ||
1892 (base == 8 && (str[1] == 'o' || str[1] == 'O')) ||
1893 (base == 2 && (str[1] == 'b' || str[1] == 'B'))))
Guido van Rossumedcc38a1991-05-05 20:09:44 +00001894 str += 2;
Thomas Wouters477c8d52006-05-27 19:21:47 +00001895
Guido van Rossume6762971998-06-22 03:54:46 +00001896 start = str;
Tim Petersbf2674b2003-02-02 07:51:32 +00001897 if ((base & (base - 1)) == 0)
1898 z = long_from_binary_base(&str, base);
1899 else {
Thomas Wouters477c8d52006-05-27 19:21:47 +00001900/***
1901Binary bases can be converted in time linear in the number of digits, because
1902Python's representation base is binary. Other bases (including decimal!) use
1903the simple quadratic-time algorithm below, complicated by some speed tricks.
Tim Peters5af4e6c2002-08-12 02:31:19 +00001904
Thomas Wouters477c8d52006-05-27 19:21:47 +00001905First some math: the largest integer that can be expressed in N base-B digits
1906is B**N-1. Consequently, if we have an N-digit input in base B, the worst-
1907case number of Python digits needed to hold it is the smallest integer n s.t.
1908
1909 BASE**n-1 >= B**N-1 [or, adding 1 to both sides]
1910 BASE**n >= B**N [taking logs to base BASE]
1911 n >= log(B**N)/log(BASE) = N * log(B)/log(BASE)
1912
1913The static array log_base_BASE[base] == log(base)/log(BASE) so we can compute
1914this quickly. A Python long with that much space is reserved near the start,
1915and the result is computed into it.
1916
1917The input string is actually treated as being in base base**i (i.e., i digits
1918are processed at a time), where two more static arrays hold:
1919
1920 convwidth_base[base] = the largest integer i such that base**i <= BASE
1921 convmultmax_base[base] = base ** convwidth_base[base]
1922
1923The first of these is the largest i such that i consecutive input digits
1924must fit in a single Python digit. The second is effectively the input
1925base we're really using.
1926
1927Viewing the input as a sequence <c0, c1, ..., c_n-1> of digits in base
1928convmultmax_base[base], the result is "simply"
1929
1930 (((c0*B + c1)*B + c2)*B + c3)*B + ... ))) + c_n-1
1931
1932where B = convmultmax_base[base].
Thomas Wouters4d70c3d2006-06-08 14:42:34 +00001933
1934Error analysis: as above, the number of Python digits `n` needed is worst-
1935case
1936
1937 n >= N * log(B)/log(BASE)
1938
1939where `N` is the number of input digits in base `B`. This is computed via
1940
1941 size_z = (Py_ssize_t)((scan - str) * log_base_BASE[base]) + 1;
1942
1943below. Two numeric concerns are how much space this can waste, and whether
1944the computed result can be too small. To be concrete, assume BASE = 2**15,
1945which is the default (and it's unlikely anyone changes that).
1946
1947Waste isn't a problem: provided the first input digit isn't 0, the difference
1948between the worst-case input with N digits and the smallest input with N
1949digits is about a factor of B, but B is small compared to BASE so at most
1950one allocated Python digit can remain unused on that count. If
1951N*log(B)/log(BASE) is mathematically an exact integer, then truncating that
1952and adding 1 returns a result 1 larger than necessary. However, that can't
1953happen: whenever B is a power of 2, long_from_binary_base() is called
1954instead, and it's impossible for B**i to be an integer power of 2**15 when
1955B is not a power of 2 (i.e., it's impossible for N*log(B)/log(BASE) to be
1956an exact integer when B is not a power of 2, since B**i has a prime factor
1957other than 2 in that case, but (2**15)**j's only prime factor is 2).
1958
1959The computed result can be too small if the true value of N*log(B)/log(BASE)
1960is a little bit larger than an exact integer, but due to roundoff errors (in
1961computing log(B), log(BASE), their quotient, and/or multiplying that by N)
1962yields a numeric result a little less than that integer. Unfortunately, "how
1963close can a transcendental function get to an integer over some range?"
1964questions are generally theoretically intractable. Computer analysis via
1965continued fractions is practical: expand log(B)/log(BASE) via continued
1966fractions, giving a sequence i/j of "the best" rational approximations. Then
1967j*log(B)/log(BASE) is approximately equal to (the integer) i. This shows that
1968we can get very close to being in trouble, but very rarely. For example,
196976573 is a denominator in one of the continued-fraction approximations to
1970log(10)/log(2**15), and indeed:
1971
1972 >>> log(10)/log(2**15)*76573
1973 16958.000000654003
1974
1975is very close to an integer. If we were working with IEEE single-precision,
1976rounding errors could kill us. Finding worst cases in IEEE double-precision
1977requires better-than-double-precision log() functions, and Tim didn't bother.
1978Instead the code checks to see whether the allocated space is enough as each
1979new Python digit is added, and copies the whole thing to a larger long if not.
1980This should happen extremely rarely, and in fact I don't have a test case
1981that triggers it(!). Instead the code was tested by artificially allocating
1982just 1 digit at the start, so that the copying code was exercised for every
1983digit beyond the first.
Thomas Wouters477c8d52006-05-27 19:21:47 +00001984***/
1985 register twodigits c; /* current input character */
1986 Py_ssize_t size_z;
1987 int i;
1988 int convwidth;
1989 twodigits convmultmax, convmult;
1990 digit *pz, *pzstop;
1991 char* scan;
1992
1993 static double log_base_BASE[37] = {0.0e0,};
1994 static int convwidth_base[37] = {0,};
1995 static twodigits convmultmax_base[37] = {0,};
1996
1997 if (log_base_BASE[base] == 0.0) {
1998 twodigits convmax = base;
1999 int i = 1;
2000
2001 log_base_BASE[base] = log((double)base) /
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002002 log((double)PyLong_BASE);
Thomas Wouters477c8d52006-05-27 19:21:47 +00002003 for (;;) {
2004 twodigits next = convmax * base;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002005 if (next > PyLong_BASE)
Thomas Wouters477c8d52006-05-27 19:21:47 +00002006 break;
2007 convmax = next;
2008 ++i;
2009 }
2010 convmultmax_base[base] = convmax;
2011 assert(i > 0);
2012 convwidth_base[base] = i;
2013 }
2014
2015 /* Find length of the string of numeric characters. */
2016 scan = str;
Christian Heimesbbe741d2008-03-28 10:53:29 +00002017 while (_PyLong_DigitValue[Py_CHARMASK(*scan)] < base)
Thomas Wouters477c8d52006-05-27 19:21:47 +00002018 ++scan;
2019
2020 /* Create a long object that can contain the largest possible
2021 * integer with this base and length. Note that there's no
2022 * need to initialize z->ob_digit -- no slot is read up before
2023 * being stored into.
2024 */
2025 size_z = (Py_ssize_t)((scan - str) * log_base_BASE[base]) + 1;
Thomas Wouters4d70c3d2006-06-08 14:42:34 +00002026 /* Uncomment next line to test exceedingly rare copy code */
2027 /* size_z = 1; */
Thomas Wouters477c8d52006-05-27 19:21:47 +00002028 assert(size_z > 0);
2029 z = _PyLong_New(size_z);
2030 if (z == NULL)
2031 return NULL;
Christian Heimes90aa7642007-12-19 02:45:37 +00002032 Py_SIZE(z) = 0;
Thomas Wouters477c8d52006-05-27 19:21:47 +00002033
2034 /* `convwidth` consecutive input digits are treated as a single
2035 * digit in base `convmultmax`.
2036 */
2037 convwidth = convwidth_base[base];
2038 convmultmax = convmultmax_base[base];
2039
2040 /* Work ;-) */
2041 while (str < scan) {
2042 /* grab up to convwidth digits from the input string */
Christian Heimesbbe741d2008-03-28 10:53:29 +00002043 c = (digit)_PyLong_DigitValue[Py_CHARMASK(*str++)];
Thomas Wouters477c8d52006-05-27 19:21:47 +00002044 for (i = 1; i < convwidth && str != scan; ++i, ++str) {
2045 c = (twodigits)(c * base +
Raymond Hettinger35631532009-01-09 03:58:09 +00002046 (int)_PyLong_DigitValue[Py_CHARMASK(*str)]);
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002047 assert(c < PyLong_BASE);
Thomas Wouters477c8d52006-05-27 19:21:47 +00002048 }
2049
2050 convmult = convmultmax;
2051 /* Calculate the shift only if we couldn't get
2052 * convwidth digits.
2053 */
2054 if (i != convwidth) {
2055 convmult = base;
2056 for ( ; i > 1; --i)
2057 convmult *= base;
2058 }
2059
2060 /* Multiply z by convmult, and add c. */
2061 pz = z->ob_digit;
Christian Heimes90aa7642007-12-19 02:45:37 +00002062 pzstop = pz + Py_SIZE(z);
Thomas Wouters477c8d52006-05-27 19:21:47 +00002063 for (; pz < pzstop; ++pz) {
2064 c += (twodigits)*pz * convmult;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002065 *pz = (digit)(c & PyLong_MASK);
2066 c >>= PyLong_SHIFT;
Thomas Wouters477c8d52006-05-27 19:21:47 +00002067 }
2068 /* carry off the current end? */
2069 if (c) {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002070 assert(c < PyLong_BASE);
Christian Heimes90aa7642007-12-19 02:45:37 +00002071 if (Py_SIZE(z) < size_z) {
Thomas Wouters4d70c3d2006-06-08 14:42:34 +00002072 *pz = (digit)c;
Christian Heimes90aa7642007-12-19 02:45:37 +00002073 ++Py_SIZE(z);
Thomas Wouters4d70c3d2006-06-08 14:42:34 +00002074 }
2075 else {
2076 PyLongObject *tmp;
2077 /* Extremely rare. Get more space. */
Christian Heimes90aa7642007-12-19 02:45:37 +00002078 assert(Py_SIZE(z) == size_z);
Thomas Wouters4d70c3d2006-06-08 14:42:34 +00002079 tmp = _PyLong_New(size_z + 1);
2080 if (tmp == NULL) {
2081 Py_DECREF(z);
2082 return NULL;
2083 }
2084 memcpy(tmp->ob_digit,
2085 z->ob_digit,
2086 sizeof(digit) * size_z);
2087 Py_DECREF(z);
2088 z = tmp;
2089 z->ob_digit[size_z] = (digit)c;
2090 ++size_z;
2091 }
Thomas Wouters477c8d52006-05-27 19:21:47 +00002092 }
Tim Petersbf2674b2003-02-02 07:51:32 +00002093 }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002094 }
Guido van Rossumac6a37a1998-08-04 15:04:06 +00002095 if (z == NULL)
2096 return NULL;
Guido van Rossumcd16bf62007-06-13 18:07:49 +00002097 if (error_if_nonzero) {
2098 /* reset the base to 0, else the exception message
2099 doesn't make too much sense */
2100 base = 0;
Christian Heimes90aa7642007-12-19 02:45:37 +00002101 if (Py_SIZE(z) != 0)
Guido van Rossumcd16bf62007-06-13 18:07:49 +00002102 goto onError;
2103 /* there might still be other problems, therefore base
2104 remains zero here for the same reason */
2105 }
Guido van Rossum9e896b32000-04-05 20:11:21 +00002106 if (str == start)
2107 goto onError;
Thomas Wouters477c8d52006-05-27 19:21:47 +00002108 if (sign < 0)
Christian Heimes90aa7642007-12-19 02:45:37 +00002109 Py_SIZE(z) = -(Py_SIZE(z));
Guido van Rossum9e896b32000-04-05 20:11:21 +00002110 while (*str && isspace(Py_CHARMASK(*str)))
2111 str++;
2112 if (*str != '\0')
2113 goto onError;
Guido van Rossumeb1fafc1994-08-29 12:47:19 +00002114 if (pend)
2115 *pend = str;
Martin v. Löwis029656f2008-06-30 04:06:08 +00002116 long_normalize(z);
Facundo Batista6e6f59b2008-07-24 18:57:11 +00002117 return (PyObject *) maybe_small_long(z);
Guido van Rossum9e896b32000-04-05 20:11:21 +00002118
2119 onError:
Guido van Rossum9e896b32000-04-05 20:11:21 +00002120 Py_XDECREF(z);
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00002121 slen = strlen(orig_str) < 200 ? strlen(orig_str) : 200;
Guido van Rossum25236212007-08-22 23:28:23 +00002122 strobj = PyUnicode_FromStringAndSize(orig_str, slen);
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00002123 if (strobj == NULL)
2124 return NULL;
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00002125 PyErr_Format(PyExc_ValueError,
Guido van Rossum25236212007-08-22 23:28:23 +00002126 "invalid literal for int() with base %d: %R",
2127 base, strobj);
2128 Py_DECREF(strobj);
Guido van Rossum9e896b32000-04-05 20:11:21 +00002129 return NULL;
2130}
2131
2132PyObject *
Martin v. Löwis18e16552006-02-15 17:27:45 +00002133PyLong_FromUnicode(Py_UNICODE *u, Py_ssize_t length, int base)
Guido van Rossum9e896b32000-04-05 20:11:21 +00002134{
Walter Dörwald07e14762002-11-06 16:15:14 +00002135 PyObject *result;
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00002136 char *buffer = (char *)PyMem_MALLOC(length+1);
Guido van Rossum9e896b32000-04-05 20:11:21 +00002137
Walter Dörwald07e14762002-11-06 16:15:14 +00002138 if (buffer == NULL)
2139 return NULL;
2140
2141 if (PyUnicode_EncodeDecimal(u, length, buffer, NULL)) {
2142 PyMem_FREE(buffer);
Guido van Rossum9e896b32000-04-05 20:11:21 +00002143 return NULL;
2144 }
Walter Dörwald07e14762002-11-06 16:15:14 +00002145 result = PyLong_FromString(buffer, NULL, base);
2146 PyMem_FREE(buffer);
2147 return result;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002148}
2149
Tim Peters9f688bf2000-07-07 15:53:28 +00002150/* forward */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002151static PyLongObject *x_divrem
Tim Peters9f688bf2000-07-07 15:53:28 +00002152 (PyLongObject *, PyLongObject *, PyLongObject **);
Guido van Rossumb43daf72007-08-01 18:08:08 +00002153static PyObject *long_long(PyObject *v);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002154
2155/* Long division with remainder, top-level routine */
2156
Guido van Rossume32e0141992-01-19 16:31:05 +00002157static int
Tim Peters9f688bf2000-07-07 15:53:28 +00002158long_divrem(PyLongObject *a, PyLongObject *b,
2159 PyLongObject **pdiv, PyLongObject **prem)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002160{
Christian Heimes90aa7642007-12-19 02:45:37 +00002161 Py_ssize_t size_a = ABS(Py_SIZE(a)), size_b = ABS(Py_SIZE(b));
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002162 PyLongObject *z;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002163
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002164 if (size_b == 0) {
Guido van Rossumbd3a5271998-08-11 15:04:47 +00002165 PyErr_SetString(PyExc_ZeroDivisionError,
Guido van Rossumddefaf32007-01-14 03:31:43 +00002166 "integer division or modulo by zero");
Guido van Rossume32e0141992-01-19 16:31:05 +00002167 return -1;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002168 }
2169 if (size_a < size_b ||
Guido van Rossum472c04f1996-12-05 21:57:21 +00002170 (size_a == size_b &&
2171 a->ob_digit[size_a-1] < b->ob_digit[size_b-1])) {
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002172 /* |a| < |b|. */
Guido van Rossumddefaf32007-01-14 03:31:43 +00002173 *pdiv = (PyLongObject*)PyLong_FromLong(0);
Guido van Rossumd8faa362007-04-27 19:54:29 +00002174 if (*pdiv == NULL)
2175 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002176 Py_INCREF(a);
2177 *prem = (PyLongObject *) a;
Guido van Rossume32e0141992-01-19 16:31:05 +00002178 return 0;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002179 }
2180 if (size_b == 1) {
2181 digit rem = 0;
2182 z = divrem1(a, b->ob_digit[0], &rem);
Guido van Rossume32e0141992-01-19 16:31:05 +00002183 if (z == NULL)
2184 return -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002185 *prem = (PyLongObject *) PyLong_FromLong((long)rem);
Guido van Rossumd8faa362007-04-27 19:54:29 +00002186 if (*prem == NULL) {
2187 Py_DECREF(z);
2188 return -1;
2189 }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002190 }
Guido van Rossume32e0141992-01-19 16:31:05 +00002191 else {
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002192 z = x_divrem(a, b, prem);
Guido van Rossume32e0141992-01-19 16:31:05 +00002193 if (z == NULL)
2194 return -1;
2195 }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002196 /* Set the signs.
2197 The quotient z has the sign of a*b;
2198 the remainder r has the sign of a,
2199 so a = b*z + r. */
Christian Heimes90aa7642007-12-19 02:45:37 +00002200 if ((Py_SIZE(a) < 0) != (Py_SIZE(b) < 0))
Guido van Rossumddefaf32007-01-14 03:31:43 +00002201 NEGATE(z);
Christian Heimes90aa7642007-12-19 02:45:37 +00002202 if (Py_SIZE(a) < 0 && Py_SIZE(*prem) != 0)
Guido van Rossumddefaf32007-01-14 03:31:43 +00002203 NEGATE(*prem);
Facundo Batista6e6f59b2008-07-24 18:57:11 +00002204 *pdiv = maybe_small_long(z);
Guido van Rossume32e0141992-01-19 16:31:05 +00002205 return 0;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002206}
2207
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002208/* Unsigned long division with remainder -- the algorithm. The arguments v1
2209 and w1 should satisfy 2 <= ABS(Py_SIZE(w1)) <= ABS(Py_SIZE(v1)). */
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002210
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002211static PyLongObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00002212x_divrem(PyLongObject *v1, PyLongObject *w1, PyLongObject **prem)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002213{
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002214 PyLongObject *v, *w, *a;
2215 Py_ssize_t i, k, size_v, size_w;
2216 int d;
2217 digit wm1, wm2, carry, q, r, vtop, *v0, *vk, *w0, *ak;
2218 twodigits vv;
2219 sdigit zhi;
2220 stwodigits z;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002221
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002222 /* We follow Knuth [The Art of Computer Programming, Vol. 2 (3rd
2223 edn.), section 4.3.1, Algorithm D], except that we don't explicitly
2224 handle the special case when the initial estimate q for a quotient
2225 digit is >= PyLong_BASE: the max value for q is PyLong_BASE+1, and
2226 that won't overflow a digit. */
2227
2228 /* allocate space; w will also be used to hold the final remainder */
2229 size_v = ABS(Py_SIZE(v1));
2230 size_w = ABS(Py_SIZE(w1));
2231 assert(size_v >= size_w && size_w >= 2); /* Assert checks by div() */
2232 v = _PyLong_New(size_v+1);
2233 if (v == NULL) {
2234 *prem = NULL;
2235 return NULL;
2236 }
2237 w = _PyLong_New(size_w);
2238 if (w == NULL) {
2239 Py_DECREF(v);
2240 *prem = NULL;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002241 return NULL;
2242 }
Tim Peters5af4e6c2002-08-12 02:31:19 +00002243
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002244 /* normalize: shift w1 left so that its top digit is >= PyLong_BASE/2.
2245 shift v1 left by the same amount. Results go into w and v. */
2246 d = PyLong_SHIFT - bits_in_digit(w1->ob_digit[size_w-1]);
2247 carry = v_lshift(w->ob_digit, w1->ob_digit, size_w, d);
2248 assert(carry == 0);
2249 carry = v_lshift(v->ob_digit, v1->ob_digit, size_v, d);
2250 if (carry != 0 || v->ob_digit[size_v-1] >= w->ob_digit[size_w-1]) {
2251 v->ob_digit[size_v] = carry;
2252 size_v++;
2253 }
Tim Peters5af4e6c2002-08-12 02:31:19 +00002254
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002255 /* Now v->ob_digit[size_v-1] < w->ob_digit[size_w-1], so quotient has
2256 at most (and usually exactly) k = size_v - size_w digits. */
Thomas Wouters477c8d52006-05-27 19:21:47 +00002257 k = size_v - size_w;
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002258 assert(k >= 0);
2259 a = _PyLong_New(k);
2260 if (a == NULL) {
2261 Py_DECREF(w);
2262 Py_DECREF(v);
2263 *prem = NULL;
2264 return NULL;
2265 }
2266 v0 = v->ob_digit;
2267 w0 = w->ob_digit;
2268 wm1 = w0[size_w-1];
2269 wm2 = w0[size_w-2];
2270 for (vk = v0+k, ak = a->ob_digit + k; vk-- > v0;) {
2271 /* inner loop: divide vk[0:size_w+1] by w0[0:size_w], giving
2272 single-digit quotient q, remainder in vk[0:size_w]. */
Tim Peters5af4e6c2002-08-12 02:31:19 +00002273
Guido van Rossumeb1fafc1994-08-29 12:47:19 +00002274 SIGCHECK({
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002275 Py_DECREF(a);
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002276 Py_DECREF(w);
2277 Py_DECREF(v);
2278 *prem = NULL;
2279 return NULL;
Guido van Rossum23d6f0e1991-05-14 12:06:49 +00002280 })
Tim Peters5af4e6c2002-08-12 02:31:19 +00002281
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002282 /* estimate quotient digit q; may overestimate by 1 (rare) */
2283 vtop = vk[size_w];
2284 assert(vtop <= wm1);
2285 vv = ((twodigits)vtop << PyLong_SHIFT) | vk[size_w-1];
2286 q = (digit)(vv / wm1);
2287 r = (digit)(vv - (twodigits)wm1 * q); /* r = vv % wm1 */
2288 while ((twodigits)wm2 * q > (((twodigits)r << PyLong_SHIFT)
2289 | vk[size_w-2])) {
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002290 --q;
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002291 r += wm1;
2292 if (r >= PyLong_BASE)
2293 break;
2294 }
2295 assert(q <= PyLong_BASE);
Tim Peters5af4e6c2002-08-12 02:31:19 +00002296
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002297 /* subtract q*w0[0:size_w] from vk[0:size_w+1] */
2298 zhi = 0;
2299 for (i = 0; i < size_w; ++i) {
2300 /* invariants: -PyLong_BASE <= -q <= zhi <= 0;
2301 -PyLong_BASE * q <= z < PyLong_BASE */
2302 z = (sdigit)vk[i] + zhi -
2303 (stwodigits)q * (stwodigits)w0[i];
2304 vk[i] = (digit)z & PyLong_MASK;
2305 zhi = (sdigit)Py_ARITHMETIC_RIGHT_SHIFT(stwodigits,
2306 z, PyLong_SHIFT);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002307 }
Tim Peters5af4e6c2002-08-12 02:31:19 +00002308
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002309 /* add w back if q was too large (this branch taken rarely) */
2310 assert((sdigit)vtop + zhi == -1 || (sdigit)vtop + zhi == 0);
2311 if ((sdigit)vtop + zhi < 0) {
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002312 carry = 0;
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002313 for (i = 0; i < size_w; ++i) {
2314 carry += vk[i] + w0[i];
2315 vk[i] = carry & PyLong_MASK;
2316 carry >>= PyLong_SHIFT;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002317 }
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002318 --q;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002319 }
Tim Peters5af4e6c2002-08-12 02:31:19 +00002320
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002321 /* store quotient digit */
2322 assert(q < PyLong_BASE);
2323 *--ak = q;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002324 }
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002325
2326 /* unshift remainder; we reuse w to store the result */
2327 carry = v_rshift(w0, v0, size_w, d);
2328 assert(carry==0);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002329 Py_DECREF(v);
Mark Dickinson17e4fdd2009-03-23 18:44:57 +00002330
2331 *prem = long_normalize(w);
2332 return long_normalize(a);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002333}
2334
Mark Dickinson6ecd9e52010-01-02 15:33:56 +00002335/* For a nonzero PyLong a, express a in the form x * 2**e, with 0.5 <=
2336 abs(x) < 1.0 and e >= 0; return x and put e in *e. Here x is
2337 rounded to DBL_MANT_DIG significant bits using round-half-to-even.
2338 If a == 0, return 0.0 and set *e = 0. If the resulting exponent
2339 e is larger than PY_SSIZE_T_MAX, raise OverflowError and return
2340 -1.0. */
2341
2342/* attempt to define 2.0**DBL_MANT_DIG as a compile-time constant */
2343#if DBL_MANT_DIG == 53
2344#define EXP2_DBL_MANT_DIG 9007199254740992.0
2345#else
2346#define EXP2_DBL_MANT_DIG (ldexp(1.0, DBL_MANT_DIG))
2347#endif
2348
2349double
2350_PyLong_Frexp(PyLongObject *a, Py_ssize_t *e)
2351{
2352 Py_ssize_t a_size, a_bits, shift_digits, shift_bits, x_size;
2353 /* See below for why x_digits is always large enough. */
2354 digit rem, x_digits[2 + (DBL_MANT_DIG + 1) / PyLong_SHIFT];
2355 double dx;
2356 /* Correction term for round-half-to-even rounding. For a digit x,
2357 "x + half_even_correction[x & 7]" gives x rounded to the nearest
2358 multiple of 4, rounding ties to a multiple of 8. */
2359 static const int half_even_correction[8] = {0, -1, -2, 1, 0, -1, 2, 1};
2360
2361 a_size = ABS(Py_SIZE(a));
2362 if (a_size == 0) {
2363 /* Special case for 0: significand 0.0, exponent 0. */
2364 *e = 0;
2365 return 0.0;
2366 }
2367 a_bits = bits_in_digit(a->ob_digit[a_size-1]);
2368 /* The following is an overflow-free version of the check
2369 "if ((a_size - 1) * PyLong_SHIFT + a_bits > PY_SSIZE_T_MAX) ..." */
2370 if (a_size >= (PY_SSIZE_T_MAX - 1) / PyLong_SHIFT + 1 &&
2371 (a_size > (PY_SSIZE_T_MAX - 1) / PyLong_SHIFT + 1 ||
2372 a_bits > (PY_SSIZE_T_MAX - 1) % PyLong_SHIFT + 1))
2373 goto overflow;
2374 a_bits = (a_size - 1) * PyLong_SHIFT + a_bits;
2375
2376 /* Shift the first DBL_MANT_DIG + 2 bits of a into x_digits[0:x_size]
2377 (shifting left if a_bits <= DBL_MANT_DIG + 2).
2378
2379 Number of digits needed for result: write // for floor division.
2380 Then if shifting left, we end up using
2381
2382 1 + a_size + (DBL_MANT_DIG + 2 - a_bits) // PyLong_SHIFT
2383
2384 digits. If shifting right, we use
2385
2386 a_size - (a_bits - DBL_MANT_DIG - 2) // PyLong_SHIFT
2387
2388 digits. Using a_size = 1 + (a_bits - 1) // PyLong_SHIFT along with
2389 the inequalities
2390
2391 m // PyLong_SHIFT + n // PyLong_SHIFT <= (m + n) // PyLong_SHIFT
2392 m // PyLong_SHIFT - n // PyLong_SHIFT <=
2393 1 + (m - n - 1) // PyLong_SHIFT,
2394
2395 valid for any integers m and n, we find that x_size satisfies
2396
2397 x_size <= 2 + (DBL_MANT_DIG + 1) // PyLong_SHIFT
2398
2399 in both cases.
2400 */
2401 if (a_bits <= DBL_MANT_DIG + 2) {
2402 shift_digits = (DBL_MANT_DIG + 2 - a_bits) / PyLong_SHIFT;
2403 shift_bits = (DBL_MANT_DIG + 2 - a_bits) % PyLong_SHIFT;
2404 x_size = 0;
2405 while (x_size < shift_digits)
2406 x_digits[x_size++] = 0;
2407 rem = v_lshift(x_digits + x_size, a->ob_digit, a_size,
2408 shift_bits);
2409 x_size += a_size;
2410 x_digits[x_size++] = rem;
2411 }
2412 else {
2413 shift_digits = (a_bits - DBL_MANT_DIG - 2) / PyLong_SHIFT;
2414 shift_bits = (a_bits - DBL_MANT_DIG - 2) % PyLong_SHIFT;
2415 rem = v_rshift(x_digits, a->ob_digit + shift_digits,
2416 a_size - shift_digits, shift_bits);
2417 x_size = a_size - shift_digits;
2418 /* For correct rounding below, we need the least significant
2419 bit of x to be 'sticky' for this shift: if any of the bits
2420 shifted out was nonzero, we set the least significant bit
2421 of x. */
2422 if (rem)
2423 x_digits[0] |= 1;
2424 else
2425 while (shift_digits > 0)
2426 if (a->ob_digit[--shift_digits]) {
2427 x_digits[0] |= 1;
2428 break;
2429 }
2430 }
2431 assert(1 <= x_size && x_size <= sizeof(x_digits)/sizeof(digit));
2432
2433 /* Round, and convert to double. */
2434 x_digits[0] += half_even_correction[x_digits[0] & 7];
2435 dx = x_digits[--x_size];
2436 while (x_size > 0)
2437 dx = dx * PyLong_BASE + x_digits[--x_size];
2438
2439 /* Rescale; make correction if result is 1.0. */
2440 dx /= 4.0 * EXP2_DBL_MANT_DIG;
2441 if (dx == 1.0) {
2442 if (a_bits == PY_SSIZE_T_MAX)
2443 goto overflow;
2444 dx = 0.5;
2445 a_bits += 1;
2446 }
2447
2448 *e = a_bits;
2449 return Py_SIZE(a) < 0 ? -dx : dx;
2450
2451 overflow:
2452 /* exponent > PY_SSIZE_T_MAX */
2453 PyErr_SetString(PyExc_OverflowError,
2454 "huge integer: number of bits overflows a Py_ssize_t");
2455 *e = 0;
2456 return -1.0;
2457}
2458
2459/* Get a C double from a long int object. Rounds to the nearest double,
2460 using the round-half-to-even rule in the case of a tie. */
2461
2462double
2463PyLong_AsDouble(PyObject *v)
2464{
2465 Py_ssize_t exponent;
2466 double x;
2467
2468 if (v == NULL || !PyLong_Check(v)) {
2469 PyErr_BadInternalCall();
2470 return -1.0;
2471 }
2472 x = _PyLong_Frexp((PyLongObject *)v, &exponent);
2473 if ((x == -1.0 && PyErr_Occurred()) || exponent > DBL_MAX_EXP) {
2474 PyErr_SetString(PyExc_OverflowError,
2475 "long int too large to convert to float");
2476 return -1.0;
2477 }
2478 return ldexp(x, exponent);
2479}
2480
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002481/* Methods */
2482
2483static void
Tim Peters9f688bf2000-07-07 15:53:28 +00002484long_dealloc(PyObject *v)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002485{
Christian Heimes90aa7642007-12-19 02:45:37 +00002486 Py_TYPE(v)->tp_free(v);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002487}
2488
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002489static int
Tim Peters9f688bf2000-07-07 15:53:28 +00002490long_compare(PyLongObject *a, PyLongObject *b)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002491{
Martin v. Löwis18e16552006-02-15 17:27:45 +00002492 Py_ssize_t sign;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002493
Christian Heimes90aa7642007-12-19 02:45:37 +00002494 if (Py_SIZE(a) != Py_SIZE(b)) {
2495 if (ABS(Py_SIZE(a)) == 0 && ABS(Py_SIZE(b)) == 0)
Guido van Rossumc6913e71991-11-19 20:26:46 +00002496 sign = 0;
2497 else
Christian Heimes90aa7642007-12-19 02:45:37 +00002498 sign = Py_SIZE(a) - Py_SIZE(b);
Guido van Rossumc6913e71991-11-19 20:26:46 +00002499 }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002500 else {
Christian Heimes90aa7642007-12-19 02:45:37 +00002501 Py_ssize_t i = ABS(Py_SIZE(a));
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002502 while (--i >= 0 && a->ob_digit[i] == b->ob_digit[i])
2503 ;
2504 if (i < 0)
2505 sign = 0;
Guido van Rossum0b0db8e1993-01-21 16:07:51 +00002506 else {
Mark Dickinsone4416742009-02-15 15:14:57 +00002507 sign = (sdigit)a->ob_digit[i] - (sdigit)b->ob_digit[i];
Christian Heimes90aa7642007-12-19 02:45:37 +00002508 if (Py_SIZE(a) < 0)
Guido van Rossum0b0db8e1993-01-21 16:07:51 +00002509 sign = -sign;
2510 }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002511 }
Guido van Rossumc6913e71991-11-19 20:26:46 +00002512 return sign < 0 ? -1 : sign > 0 ? 1 : 0;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002513}
2514
Antoine Pitrou51f3ef92008-12-20 13:14:23 +00002515#define TEST_COND(cond) \
2516 ((cond) ? Py_True : Py_False)
2517
Guido van Rossum47b9ff62006-08-24 00:41:19 +00002518static PyObject *
2519long_richcompare(PyObject *self, PyObject *other, int op)
2520{
Antoine Pitrou51f3ef92008-12-20 13:14:23 +00002521 int result;
2522 PyObject *v;
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002523 CHECK_BINOP(self, other);
Antoine Pitrou51f3ef92008-12-20 13:14:23 +00002524 if (self == other)
2525 result = 0;
2526 else
2527 result = long_compare((PyLongObject*)self, (PyLongObject*)other);
2528 /* Convert the return value to a Boolean */
2529 switch (op) {
2530 case Py_EQ:
2531 v = TEST_COND(result == 0);
2532 break;
2533 case Py_NE:
2534 v = TEST_COND(result != 0);
2535 break;
2536 case Py_LE:
2537 v = TEST_COND(result <= 0);
2538 break;
2539 case Py_GE:
2540 v = TEST_COND(result >= 0);
2541 break;
2542 case Py_LT:
2543 v = TEST_COND(result == -1);
2544 break;
2545 case Py_GT:
2546 v = TEST_COND(result == 1);
2547 break;
2548 default:
2549 PyErr_BadArgument();
2550 return NULL;
2551 }
2552 Py_INCREF(v);
2553 return v;
Guido van Rossum47b9ff62006-08-24 00:41:19 +00002554}
2555
Guido van Rossum9bfef441993-03-29 10:43:31 +00002556static long
Tim Peters9f688bf2000-07-07 15:53:28 +00002557long_hash(PyLongObject *v)
Guido van Rossum9bfef441993-03-29 10:43:31 +00002558{
Mark Dickinsona5cafdf2009-01-26 21:56:07 +00002559 unsigned long x;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002560 Py_ssize_t i;
2561 int sign;
Guido van Rossum9bfef441993-03-29 10:43:31 +00002562
2563 /* This is designed so that Python ints and longs with the
2564 same value hash to the same value, otherwise comparisons
2565 of mapping keys will turn out weird */
Christian Heimes90aa7642007-12-19 02:45:37 +00002566 i = Py_SIZE(v);
Guido van Rossumddefaf32007-01-14 03:31:43 +00002567 switch(i) {
Mark Dickinson0d4785b2009-02-15 17:27:41 +00002568 case -1: return v->ob_digit[0]==1 ? -2 : -(sdigit)v->ob_digit[0];
Guido van Rossumddefaf32007-01-14 03:31:43 +00002569 case 0: return 0;
2570 case 1: return v->ob_digit[0];
2571 }
Guido van Rossum9bfef441993-03-29 10:43:31 +00002572 sign = 1;
2573 x = 0;
2574 if (i < 0) {
2575 sign = -1;
2576 i = -(i);
2577 }
Mark Dickinsona5cafdf2009-01-26 21:56:07 +00002578 /* The following loop produces a C unsigned long x such that x is
2579 congruent to the absolute value of v modulo ULONG_MAX. The
Thomas Woutersce272b62007-09-19 21:19:28 +00002580 resulting x is nonzero if and only if v is. */
Guido van Rossum9bfef441993-03-29 10:43:31 +00002581 while (--i >= 0) {
Neal Norwitzd5a65a72003-02-23 23:11:41 +00002582 /* Force a native long #-bits (32 or 64) circular shift */
Mark Dickinson5a74bf62009-02-15 11:04:38 +00002583 x = (x >> (8*SIZEOF_LONG-PyLong_SHIFT)) | (x << PyLong_SHIFT);
Guido van Rossum9bfef441993-03-29 10:43:31 +00002584 x += v->ob_digit[i];
Mark Dickinsona5cafdf2009-01-26 21:56:07 +00002585 /* If the addition above overflowed we compensate by
2586 incrementing. This preserves the value modulo
2587 ULONG_MAX. */
2588 if (x < v->ob_digit[i])
Thomas Woutersce272b62007-09-19 21:19:28 +00002589 x++;
Guido van Rossum9bfef441993-03-29 10:43:31 +00002590 }
2591 x = x * sign;
Mark Dickinson5a74bf62009-02-15 11:04:38 +00002592 if (x == (unsigned long)-1)
2593 x = (unsigned long)-2;
2594 return (long)x;
Guido van Rossum9bfef441993-03-29 10:43:31 +00002595}
2596
2597
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002598/* Add the absolute values of two long integers. */
2599
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002600static PyLongObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00002601x_add(PyLongObject *a, PyLongObject *b)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002602{
Christian Heimes90aa7642007-12-19 02:45:37 +00002603 Py_ssize_t size_a = ABS(Py_SIZE(a)), size_b = ABS(Py_SIZE(b));
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002604 PyLongObject *z;
Mark Dickinson17e55872009-01-24 15:56:57 +00002605 Py_ssize_t i;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002606 digit carry = 0;
Tim Peters69c2de32001-09-11 22:31:33 +00002607
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002608 /* Ensure a is the larger of the two: */
2609 if (size_a < size_b) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002610 { PyLongObject *temp = a; a = b; b = temp; }
Martin v. Löwis18e16552006-02-15 17:27:45 +00002611 { Py_ssize_t size_temp = size_a;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002612 size_a = size_b;
2613 size_b = size_temp; }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002614 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002615 z = _PyLong_New(size_a+1);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002616 if (z == NULL)
2617 return NULL;
2618 for (i = 0; i < size_b; ++i) {
2619 carry += a->ob_digit[i] + b->ob_digit[i];
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002620 z->ob_digit[i] = carry & PyLong_MASK;
2621 carry >>= PyLong_SHIFT;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002622 }
2623 for (; i < size_a; ++i) {
2624 carry += a->ob_digit[i];
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002625 z->ob_digit[i] = carry & PyLong_MASK;
2626 carry >>= PyLong_SHIFT;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002627 }
2628 z->ob_digit[i] = carry;
2629 return long_normalize(z);
2630}
2631
2632/* Subtract the absolute values of two integers. */
2633
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002634static PyLongObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00002635x_sub(PyLongObject *a, PyLongObject *b)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002636{
Christian Heimes90aa7642007-12-19 02:45:37 +00002637 Py_ssize_t size_a = ABS(Py_SIZE(a)), size_b = ABS(Py_SIZE(b));
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002638 PyLongObject *z;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002639 Py_ssize_t i;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002640 int sign = 1;
2641 digit borrow = 0;
Tim Peters69c2de32001-09-11 22:31:33 +00002642
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002643 /* Ensure a is the larger of the two: */
2644 if (size_a < size_b) {
2645 sign = -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002646 { PyLongObject *temp = a; a = b; b = temp; }
Martin v. Löwis18e16552006-02-15 17:27:45 +00002647 { Py_ssize_t size_temp = size_a;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002648 size_a = size_b;
2649 size_b = size_temp; }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002650 }
2651 else if (size_a == size_b) {
2652 /* Find highest digit where a and b differ: */
2653 i = size_a;
2654 while (--i >= 0 && a->ob_digit[i] == b->ob_digit[i])
2655 ;
2656 if (i < 0)
Facundo Batista6e6f59b2008-07-24 18:57:11 +00002657 return (PyLongObject *)PyLong_FromLong(0);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002658 if (a->ob_digit[i] < b->ob_digit[i]) {
2659 sign = -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002660 { PyLongObject *temp = a; a = b; b = temp; }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002661 }
2662 size_a = size_b = i+1;
2663 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002664 z = _PyLong_New(size_a);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002665 if (z == NULL)
2666 return NULL;
2667 for (i = 0; i < size_b; ++i) {
2668 /* The following assumes unsigned arithmetic
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002669 works module 2**N for some N>PyLong_SHIFT. */
Guido van Rossumeb1fafc1994-08-29 12:47:19 +00002670 borrow = a->ob_digit[i] - b->ob_digit[i] - borrow;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002671 z->ob_digit[i] = borrow & PyLong_MASK;
2672 borrow >>= PyLong_SHIFT;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002673 borrow &= 1; /* Keep only one sign bit */
2674 }
2675 for (; i < size_a; ++i) {
2676 borrow = a->ob_digit[i] - borrow;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002677 z->ob_digit[i] = borrow & PyLong_MASK;
2678 borrow >>= PyLong_SHIFT;
Tim Peters43f04a32000-07-08 02:26:47 +00002679 borrow &= 1; /* Keep only one sign bit */
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002680 }
2681 assert(borrow == 0);
Guido van Rossumc6913e71991-11-19 20:26:46 +00002682 if (sign < 0)
Guido van Rossumddefaf32007-01-14 03:31:43 +00002683 NEGATE(z);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002684 return long_normalize(z);
2685}
2686
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002687static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002688long_add(PyLongObject *a, PyLongObject *b)
Guido van Rossum4c260ff1992-01-14 18:36:43 +00002689{
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002690 PyLongObject *z;
Tim Peters69c2de32001-09-11 22:31:33 +00002691
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002692 CHECK_BINOP(a, b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00002693
Christian Heimes90aa7642007-12-19 02:45:37 +00002694 if (ABS(Py_SIZE(a)) <= 1 && ABS(Py_SIZE(b)) <= 1) {
Christian Heimes217cfd12007-12-02 14:31:20 +00002695 PyObject *result = PyLong_FromLong(MEDIUM_VALUE(a) +
Martin v. Löwis14b6d922007-02-06 21:05:30 +00002696 MEDIUM_VALUE(b));
Martin v. Löwis14b6d922007-02-06 21:05:30 +00002697 return result;
2698 }
Christian Heimes90aa7642007-12-19 02:45:37 +00002699 if (Py_SIZE(a) < 0) {
2700 if (Py_SIZE(b) < 0) {
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002701 z = x_add(a, b);
Christian Heimes90aa7642007-12-19 02:45:37 +00002702 if (z != NULL && Py_SIZE(z) != 0)
2703 Py_SIZE(z) = -(Py_SIZE(z));
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002704 }
2705 else
2706 z = x_sub(b, a);
2707 }
2708 else {
Christian Heimes90aa7642007-12-19 02:45:37 +00002709 if (Py_SIZE(b) < 0)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002710 z = x_sub(a, b);
2711 else
2712 z = x_add(a, b);
2713 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002714 return (PyObject *)z;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002715}
2716
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002717static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002718long_sub(PyLongObject *a, PyLongObject *b)
Guido van Rossum4c260ff1992-01-14 18:36:43 +00002719{
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002720 PyLongObject *z;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002721
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002722 CHECK_BINOP(a, b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00002723
Christian Heimes90aa7642007-12-19 02:45:37 +00002724 if (ABS(Py_SIZE(a)) <= 1 && ABS(Py_SIZE(b)) <= 1) {
Martin v. Löwis14b6d922007-02-06 21:05:30 +00002725 PyObject* r;
2726 r = PyLong_FromLong(MEDIUM_VALUE(a)-MEDIUM_VALUE(b));
Martin v. Löwis14b6d922007-02-06 21:05:30 +00002727 return r;
2728 }
Christian Heimes90aa7642007-12-19 02:45:37 +00002729 if (Py_SIZE(a) < 0) {
2730 if (Py_SIZE(b) < 0)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002731 z = x_sub(a, b);
2732 else
2733 z = x_add(a, b);
Christian Heimes90aa7642007-12-19 02:45:37 +00002734 if (z != NULL && Py_SIZE(z) != 0)
2735 Py_SIZE(z) = -(Py_SIZE(z));
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002736 }
2737 else {
Christian Heimes90aa7642007-12-19 02:45:37 +00002738 if (Py_SIZE(b) < 0)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002739 z = x_add(a, b);
2740 else
2741 z = x_sub(a, b);
2742 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002743 return (PyObject *)z;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002744}
2745
Tim Peters5af4e6c2002-08-12 02:31:19 +00002746/* Grade school multiplication, ignoring the signs.
2747 * Returns the absolute value of the product, or NULL if error.
2748 */
2749static PyLongObject *
2750x_mul(PyLongObject *a, PyLongObject *b)
Neil Schemenauerba872e22001-01-04 01:46:03 +00002751{
Tim Peters5af4e6c2002-08-12 02:31:19 +00002752 PyLongObject *z;
Christian Heimes90aa7642007-12-19 02:45:37 +00002753 Py_ssize_t size_a = ABS(Py_SIZE(a));
2754 Py_ssize_t size_b = ABS(Py_SIZE(b));
Martin v. Löwis18e16552006-02-15 17:27:45 +00002755 Py_ssize_t i;
Neil Schemenauerba872e22001-01-04 01:46:03 +00002756
Tim Peters5af4e6c2002-08-12 02:31:19 +00002757 z = _PyLong_New(size_a + size_b);
2758 if (z == NULL)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002759 return NULL;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002760
Christian Heimes90aa7642007-12-19 02:45:37 +00002761 memset(z->ob_digit, 0, Py_SIZE(z) * sizeof(digit));
Tim Peters0973b992004-08-29 22:16:50 +00002762 if (a == b) {
2763 /* Efficient squaring per HAC, Algorithm 14.16:
2764 * http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf
2765 * Gives slightly less than a 2x speedup when a == b,
2766 * via exploiting that each entry in the multiplication
2767 * pyramid appears twice (except for the size_a squares).
2768 */
2769 for (i = 0; i < size_a; ++i) {
2770 twodigits carry;
2771 twodigits f = a->ob_digit[i];
2772 digit *pz = z->ob_digit + (i << 1);
2773 digit *pa = a->ob_digit + i + 1;
2774 digit *paend = a->ob_digit + size_a;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002775
Tim Peters0973b992004-08-29 22:16:50 +00002776 SIGCHECK({
2777 Py_DECREF(z);
2778 return NULL;
2779 })
2780
2781 carry = *pz + f * f;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002782 *pz++ = (digit)(carry & PyLong_MASK);
2783 carry >>= PyLong_SHIFT;
2784 assert(carry <= PyLong_MASK);
Tim Peters0973b992004-08-29 22:16:50 +00002785
2786 /* Now f is added in twice in each column of the
2787 * pyramid it appears. Same as adding f<<1 once.
2788 */
2789 f <<= 1;
2790 while (pa < paend) {
2791 carry += *pz + *pa++ * f;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002792 *pz++ = (digit)(carry & PyLong_MASK);
2793 carry >>= PyLong_SHIFT;
2794 assert(carry <= (PyLong_MASK << 1));
Tim Peters0973b992004-08-29 22:16:50 +00002795 }
2796 if (carry) {
2797 carry += *pz;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002798 *pz++ = (digit)(carry & PyLong_MASK);
2799 carry >>= PyLong_SHIFT;
Tim Peters0973b992004-08-29 22:16:50 +00002800 }
2801 if (carry)
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002802 *pz += (digit)(carry & PyLong_MASK);
2803 assert((carry >> PyLong_SHIFT) == 0);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002804 }
Tim Peters0973b992004-08-29 22:16:50 +00002805 }
2806 else { /* a is not the same as b -- gradeschool long mult */
2807 for (i = 0; i < size_a; ++i) {
2808 twodigits carry = 0;
2809 twodigits f = a->ob_digit[i];
2810 digit *pz = z->ob_digit + i;
2811 digit *pb = b->ob_digit;
2812 digit *pbend = b->ob_digit + size_b;
2813
2814 SIGCHECK({
2815 Py_DECREF(z);
2816 return NULL;
2817 })
2818
2819 while (pb < pbend) {
2820 carry += *pz + *pb++ * f;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002821 *pz++ = (digit)(carry & PyLong_MASK);
2822 carry >>= PyLong_SHIFT;
2823 assert(carry <= PyLong_MASK);
Tim Peters0973b992004-08-29 22:16:50 +00002824 }
2825 if (carry)
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002826 *pz += (digit)(carry & PyLong_MASK);
2827 assert((carry >> PyLong_SHIFT) == 0);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002828 }
2829 }
Tim Peters44121a62002-08-12 06:17:58 +00002830 return long_normalize(z);
Tim Peters5af4e6c2002-08-12 02:31:19 +00002831}
2832
2833/* A helper for Karatsuba multiplication (k_mul).
2834 Takes a long "n" and an integer "size" representing the place to
2835 split, and sets low and high such that abs(n) == (high << size) + low,
2836 viewing the shift as being by digits. The sign bit is ignored, and
2837 the return values are >= 0.
2838 Returns 0 on success, -1 on failure.
2839*/
2840static int
Martin v. Löwis18e16552006-02-15 17:27:45 +00002841kmul_split(PyLongObject *n, Py_ssize_t size, PyLongObject **high, PyLongObject **low)
Tim Peters5af4e6c2002-08-12 02:31:19 +00002842{
2843 PyLongObject *hi, *lo;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002844 Py_ssize_t size_lo, size_hi;
Christian Heimes90aa7642007-12-19 02:45:37 +00002845 const Py_ssize_t size_n = ABS(Py_SIZE(n));
Tim Peters5af4e6c2002-08-12 02:31:19 +00002846
2847 size_lo = MIN(size_n, size);
2848 size_hi = size_n - size_lo;
2849
2850 if ((hi = _PyLong_New(size_hi)) == NULL)
2851 return -1;
2852 if ((lo = _PyLong_New(size_lo)) == NULL) {
2853 Py_DECREF(hi);
2854 return -1;
2855 }
2856
2857 memcpy(lo->ob_digit, n->ob_digit, size_lo * sizeof(digit));
2858 memcpy(hi->ob_digit, n->ob_digit + size_lo, size_hi * sizeof(digit));
2859
2860 *high = long_normalize(hi);
2861 *low = long_normalize(lo);
2862 return 0;
2863}
2864
Tim Peters60004642002-08-12 22:01:34 +00002865static PyLongObject *k_lopsided_mul(PyLongObject *a, PyLongObject *b);
2866
Tim Peters5af4e6c2002-08-12 02:31:19 +00002867/* Karatsuba multiplication. Ignores the input signs, and returns the
2868 * absolute value of the product (or NULL if error).
2869 * See Knuth Vol. 2 Chapter 4.3.3 (Pp. 294-295).
2870 */
2871static PyLongObject *
2872k_mul(PyLongObject *a, PyLongObject *b)
2873{
Christian Heimes90aa7642007-12-19 02:45:37 +00002874 Py_ssize_t asize = ABS(Py_SIZE(a));
2875 Py_ssize_t bsize = ABS(Py_SIZE(b));
Tim Peters5af4e6c2002-08-12 02:31:19 +00002876 PyLongObject *ah = NULL;
2877 PyLongObject *al = NULL;
2878 PyLongObject *bh = NULL;
2879 PyLongObject *bl = NULL;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002880 PyLongObject *ret = NULL;
Tim Peters738eda72002-08-12 15:08:20 +00002881 PyLongObject *t1, *t2, *t3;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002882 Py_ssize_t shift; /* the number of digits we split off */
2883 Py_ssize_t i;
Tim Peters738eda72002-08-12 15:08:20 +00002884
Tim Peters5af4e6c2002-08-12 02:31:19 +00002885 /* (ah*X+al)(bh*X+bl) = ah*bh*X*X + (ah*bl + al*bh)*X + al*bl
2886 * Let k = (ah+al)*(bh+bl) = ah*bl + al*bh + ah*bh + al*bl
2887 * Then the original product is
Tim Peters18c15b92002-08-12 02:43:58 +00002888 * ah*bh*X*X + (k - ah*bh - al*bl)*X + al*bl
Tim Peters5af4e6c2002-08-12 02:31:19 +00002889 * By picking X to be a power of 2, "*X" is just shifting, and it's
2890 * been reduced to 3 multiplies on numbers half the size.
2891 */
2892
Tim Petersfc07e562002-08-12 02:54:10 +00002893 /* We want to split based on the larger number; fiddle so that b
Tim Peters5af4e6c2002-08-12 02:31:19 +00002894 * is largest.
2895 */
Tim Peters738eda72002-08-12 15:08:20 +00002896 if (asize > bsize) {
Tim Peters5af4e6c2002-08-12 02:31:19 +00002897 t1 = a;
2898 a = b;
2899 b = t1;
Tim Peters738eda72002-08-12 15:08:20 +00002900
2901 i = asize;
2902 asize = bsize;
2903 bsize = i;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002904 }
2905
2906 /* Use gradeschool math when either number is too small. */
Tim Peters0973b992004-08-29 22:16:50 +00002907 i = a == b ? KARATSUBA_SQUARE_CUTOFF : KARATSUBA_CUTOFF;
2908 if (asize <= i) {
Tim Peters738eda72002-08-12 15:08:20 +00002909 if (asize == 0)
Facundo Batista6e6f59b2008-07-24 18:57:11 +00002910 return (PyLongObject *)PyLong_FromLong(0);
Tim Peters44121a62002-08-12 06:17:58 +00002911 else
2912 return x_mul(a, b);
2913 }
Tim Peters5af4e6c2002-08-12 02:31:19 +00002914
Tim Peters60004642002-08-12 22:01:34 +00002915 /* If a is small compared to b, splitting on b gives a degenerate
2916 * case with ah==0, and Karatsuba may be (even much) less efficient
2917 * than "grade school" then. However, we can still win, by viewing
2918 * b as a string of "big digits", each of width a->ob_size. That
2919 * leads to a sequence of balanced calls to k_mul.
2920 */
2921 if (2 * asize <= bsize)
2922 return k_lopsided_mul(a, b);
2923
Tim Petersd6974a52002-08-13 20:37:51 +00002924 /* Split a & b into hi & lo pieces. */
Tim Peters738eda72002-08-12 15:08:20 +00002925 shift = bsize >> 1;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002926 if (kmul_split(a, shift, &ah, &al) < 0) goto fail;
Christian Heimes90aa7642007-12-19 02:45:37 +00002927 assert(Py_SIZE(ah) > 0); /* the split isn't degenerate */
Tim Petersd6974a52002-08-13 20:37:51 +00002928
Tim Peters0973b992004-08-29 22:16:50 +00002929 if (a == b) {
2930 bh = ah;
2931 bl = al;
2932 Py_INCREF(bh);
2933 Py_INCREF(bl);
2934 }
2935 else if (kmul_split(b, shift, &bh, &bl) < 0) goto fail;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002936
Tim Petersd64c1de2002-08-12 17:36:03 +00002937 /* The plan:
2938 * 1. Allocate result space (asize + bsize digits: that's always
2939 * enough).
2940 * 2. Compute ah*bh, and copy into result at 2*shift.
2941 * 3. Compute al*bl, and copy into result at 0. Note that this
2942 * can't overlap with #2.
2943 * 4. Subtract al*bl from the result, starting at shift. This may
2944 * underflow (borrow out of the high digit), but we don't care:
2945 * we're effectively doing unsigned arithmetic mod
2946 * BASE**(sizea + sizeb), and so long as the *final* result fits,
2947 * borrows and carries out of the high digit can be ignored.
2948 * 5. Subtract ah*bh from the result, starting at shift.
2949 * 6. Compute (ah+al)*(bh+bl), and add it into the result starting
2950 * at shift.
2951 */
2952
2953 /* 1. Allocate result space. */
Tim Peters70b041b2002-08-12 19:38:01 +00002954 ret = _PyLong_New(asize + bsize);
Tim Peters5af4e6c2002-08-12 02:31:19 +00002955 if (ret == NULL) goto fail;
2956#ifdef Py_DEBUG
2957 /* Fill with trash, to catch reference to uninitialized digits. */
Christian Heimes90aa7642007-12-19 02:45:37 +00002958 memset(ret->ob_digit, 0xDF, Py_SIZE(ret) * sizeof(digit));
Tim Peters5af4e6c2002-08-12 02:31:19 +00002959#endif
Tim Peters44121a62002-08-12 06:17:58 +00002960
Tim Petersd64c1de2002-08-12 17:36:03 +00002961 /* 2. t1 <- ah*bh, and copy into high digits of result. */
Tim Peters738eda72002-08-12 15:08:20 +00002962 if ((t1 = k_mul(ah, bh)) == NULL) goto fail;
Christian Heimes90aa7642007-12-19 02:45:37 +00002963 assert(Py_SIZE(t1) >= 0);
2964 assert(2*shift + Py_SIZE(t1) <= Py_SIZE(ret));
Tim Peters738eda72002-08-12 15:08:20 +00002965 memcpy(ret->ob_digit + 2*shift, t1->ob_digit,
Christian Heimes90aa7642007-12-19 02:45:37 +00002966 Py_SIZE(t1) * sizeof(digit));
Tim Peters738eda72002-08-12 15:08:20 +00002967
2968 /* Zero-out the digits higher than the ah*bh copy. */
Christian Heimes90aa7642007-12-19 02:45:37 +00002969 i = Py_SIZE(ret) - 2*shift - Py_SIZE(t1);
Tim Peters44121a62002-08-12 06:17:58 +00002970 if (i)
Christian Heimes90aa7642007-12-19 02:45:37 +00002971 memset(ret->ob_digit + 2*shift + Py_SIZE(t1), 0,
Tim Peters44121a62002-08-12 06:17:58 +00002972 i * sizeof(digit));
Tim Peters5af4e6c2002-08-12 02:31:19 +00002973
Tim Petersd64c1de2002-08-12 17:36:03 +00002974 /* 3. t2 <- al*bl, and copy into the low digits. */
Tim Peters738eda72002-08-12 15:08:20 +00002975 if ((t2 = k_mul(al, bl)) == NULL) {
2976 Py_DECREF(t1);
2977 goto fail;
2978 }
Christian Heimes90aa7642007-12-19 02:45:37 +00002979 assert(Py_SIZE(t2) >= 0);
2980 assert(Py_SIZE(t2) <= 2*shift); /* no overlap with high digits */
2981 memcpy(ret->ob_digit, t2->ob_digit, Py_SIZE(t2) * sizeof(digit));
Tim Peters5af4e6c2002-08-12 02:31:19 +00002982
2983 /* Zero out remaining digits. */
Christian Heimes90aa7642007-12-19 02:45:37 +00002984 i = 2*shift - Py_SIZE(t2); /* number of uninitialized digits */
Tim Peters5af4e6c2002-08-12 02:31:19 +00002985 if (i)
Christian Heimes90aa7642007-12-19 02:45:37 +00002986 memset(ret->ob_digit + Py_SIZE(t2), 0, i * sizeof(digit));
Tim Peters5af4e6c2002-08-12 02:31:19 +00002987
Tim Petersd64c1de2002-08-12 17:36:03 +00002988 /* 4 & 5. Subtract ah*bh (t1) and al*bl (t2). We do al*bl first
2989 * because it's fresher in cache.
2990 */
Christian Heimes90aa7642007-12-19 02:45:37 +00002991 i = Py_SIZE(ret) - shift; /* # digits after shift */
2992 (void)v_isub(ret->ob_digit + shift, i, t2->ob_digit, Py_SIZE(t2));
Tim Peters738eda72002-08-12 15:08:20 +00002993 Py_DECREF(t2);
2994
Christian Heimes90aa7642007-12-19 02:45:37 +00002995 (void)v_isub(ret->ob_digit + shift, i, t1->ob_digit, Py_SIZE(t1));
Tim Peters738eda72002-08-12 15:08:20 +00002996 Py_DECREF(t1);
2997
Tim Petersd64c1de2002-08-12 17:36:03 +00002998 /* 6. t3 <- (ah+al)(bh+bl), and add into result. */
Tim Peters5af4e6c2002-08-12 02:31:19 +00002999 if ((t1 = x_add(ah, al)) == NULL) goto fail;
3000 Py_DECREF(ah);
3001 Py_DECREF(al);
3002 ah = al = NULL;
3003
Tim Peters0973b992004-08-29 22:16:50 +00003004 if (a == b) {
3005 t2 = t1;
3006 Py_INCREF(t2);
3007 }
3008 else if ((t2 = x_add(bh, bl)) == NULL) {
Tim Peters5af4e6c2002-08-12 02:31:19 +00003009 Py_DECREF(t1);
3010 goto fail;
3011 }
3012 Py_DECREF(bh);
3013 Py_DECREF(bl);
3014 bh = bl = NULL;
3015
Tim Peters738eda72002-08-12 15:08:20 +00003016 t3 = k_mul(t1, t2);
Tim Peters5af4e6c2002-08-12 02:31:19 +00003017 Py_DECREF(t1);
3018 Py_DECREF(t2);
Tim Peters738eda72002-08-12 15:08:20 +00003019 if (t3 == NULL) goto fail;
Christian Heimes90aa7642007-12-19 02:45:37 +00003020 assert(Py_SIZE(t3) >= 0);
Tim Peters5af4e6c2002-08-12 02:31:19 +00003021
Tim Petersd6974a52002-08-13 20:37:51 +00003022 /* Add t3. It's not obvious why we can't run out of room here.
3023 * See the (*) comment after this function.
Tim Petersd8b21732002-08-12 19:30:26 +00003024 */
Christian Heimes90aa7642007-12-19 02:45:37 +00003025 (void)v_iadd(ret->ob_digit + shift, i, t3->ob_digit, Py_SIZE(t3));
Tim Peters738eda72002-08-12 15:08:20 +00003026 Py_DECREF(t3);
Tim Peters5af4e6c2002-08-12 02:31:19 +00003027
Tim Peters5af4e6c2002-08-12 02:31:19 +00003028 return long_normalize(ret);
3029
3030 fail:
3031 Py_XDECREF(ret);
3032 Py_XDECREF(ah);
3033 Py_XDECREF(al);
3034 Py_XDECREF(bh);
3035 Py_XDECREF(bl);
Tim Peters5af4e6c2002-08-12 02:31:19 +00003036 return NULL;
3037}
3038
Tim Petersd6974a52002-08-13 20:37:51 +00003039/* (*) Why adding t3 can't "run out of room" above.
3040
Tim Petersab86c2b2002-08-15 20:06:00 +00003041Let f(x) mean the floor of x and c(x) mean the ceiling of x. Some facts
3042to start with:
Tim Petersd6974a52002-08-13 20:37:51 +00003043
Tim Petersab86c2b2002-08-15 20:06:00 +000030441. For any integer i, i = c(i/2) + f(i/2). In particular,
3045 bsize = c(bsize/2) + f(bsize/2).
30462. shift = f(bsize/2)
30473. asize <= bsize
30484. Since we call k_lopsided_mul if asize*2 <= bsize, asize*2 > bsize in this
3049 routine, so asize > bsize/2 >= f(bsize/2) in this routine.
Tim Petersd6974a52002-08-13 20:37:51 +00003050
Tim Petersab86c2b2002-08-15 20:06:00 +00003051We allocated asize + bsize result digits, and add t3 into them at an offset
3052of shift. This leaves asize+bsize-shift allocated digit positions for t3
3053to fit into, = (by #1 and #2) asize + f(bsize/2) + c(bsize/2) - f(bsize/2) =
3054asize + c(bsize/2) available digit positions.
Tim Petersd6974a52002-08-13 20:37:51 +00003055
Tim Petersab86c2b2002-08-15 20:06:00 +00003056bh has c(bsize/2) digits, and bl at most f(size/2) digits. So bh+hl has
3057at most c(bsize/2) digits + 1 bit.
Tim Petersd6974a52002-08-13 20:37:51 +00003058
Tim Petersab86c2b2002-08-15 20:06:00 +00003059If asize == bsize, ah has c(bsize/2) digits, else ah has at most f(bsize/2)
3060digits, and al has at most f(bsize/2) digits in any case. So ah+al has at
3061most (asize == bsize ? c(bsize/2) : f(bsize/2)) digits + 1 bit.
Tim Petersd6974a52002-08-13 20:37:51 +00003062
Tim Petersab86c2b2002-08-15 20:06:00 +00003063The product (ah+al)*(bh+bl) therefore has at most
Tim Petersd6974a52002-08-13 20:37:51 +00003064
Tim Petersab86c2b2002-08-15 20:06:00 +00003065 c(bsize/2) + (asize == bsize ? c(bsize/2) : f(bsize/2)) digits + 2 bits
Tim Petersd6974a52002-08-13 20:37:51 +00003066
Tim Petersab86c2b2002-08-15 20:06:00 +00003067and we have asize + c(bsize/2) available digit positions. We need to show
3068this is always enough. An instance of c(bsize/2) cancels out in both, so
3069the question reduces to whether asize digits is enough to hold
3070(asize == bsize ? c(bsize/2) : f(bsize/2)) digits + 2 bits. If asize < bsize,
3071then we're asking whether asize digits >= f(bsize/2) digits + 2 bits. By #4,
3072asize is at least f(bsize/2)+1 digits, so this in turn reduces to whether 1
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003073digit is enough to hold 2 bits. This is so since PyLong_SHIFT=15 >= 2. If
Tim Petersab86c2b2002-08-15 20:06:00 +00003074asize == bsize, then we're asking whether bsize digits is enough to hold
Tim Peterse417de02002-08-15 20:10:45 +00003075c(bsize/2) digits + 2 bits, or equivalently (by #1) whether f(bsize/2) digits
3076is enough to hold 2 bits. This is so if bsize >= 2, which holds because
3077bsize >= KARATSUBA_CUTOFF >= 2.
Tim Peters8e966ee2002-08-14 16:36:23 +00003078
Tim Peters48d52c02002-08-14 17:07:32 +00003079Note that since there's always enough room for (ah+al)*(bh+bl), and that's
3080clearly >= each of ah*bh and al*bl, there's always enough room to subtract
3081ah*bh and al*bl too.
Tim Petersd6974a52002-08-13 20:37:51 +00003082*/
3083
Tim Peters60004642002-08-12 22:01:34 +00003084/* b has at least twice the digits of a, and a is big enough that Karatsuba
3085 * would pay off *if* the inputs had balanced sizes. View b as a sequence
3086 * of slices, each with a->ob_size digits, and multiply the slices by a,
3087 * one at a time. This gives k_mul balanced inputs to work with, and is
3088 * also cache-friendly (we compute one double-width slice of the result
3089 * at a time, then move on, never bactracking except for the helpful
3090 * single-width slice overlap between successive partial sums).
3091 */
3092static PyLongObject *
3093k_lopsided_mul(PyLongObject *a, PyLongObject *b)
3094{
Christian Heimes90aa7642007-12-19 02:45:37 +00003095 const Py_ssize_t asize = ABS(Py_SIZE(a));
3096 Py_ssize_t bsize = ABS(Py_SIZE(b));
Martin v. Löwis18e16552006-02-15 17:27:45 +00003097 Py_ssize_t nbdone; /* # of b digits already multiplied */
Tim Peters60004642002-08-12 22:01:34 +00003098 PyLongObject *ret;
3099 PyLongObject *bslice = NULL;
3100
3101 assert(asize > KARATSUBA_CUTOFF);
3102 assert(2 * asize <= bsize);
3103
3104 /* Allocate result space, and zero it out. */
3105 ret = _PyLong_New(asize + bsize);
3106 if (ret == NULL)
3107 return NULL;
Christian Heimes90aa7642007-12-19 02:45:37 +00003108 memset(ret->ob_digit, 0, Py_SIZE(ret) * sizeof(digit));
Tim Peters60004642002-08-12 22:01:34 +00003109
3110 /* Successive slices of b are copied into bslice. */
Tim Peters12034032002-08-12 22:10:00 +00003111 bslice = _PyLong_New(asize);
Tim Peters60004642002-08-12 22:01:34 +00003112 if (bslice == NULL)
3113 goto fail;
3114
3115 nbdone = 0;
3116 while (bsize > 0) {
3117 PyLongObject *product;
Martin v. Löwis18e16552006-02-15 17:27:45 +00003118 const Py_ssize_t nbtouse = MIN(bsize, asize);
Tim Peters60004642002-08-12 22:01:34 +00003119
3120 /* Multiply the next slice of b by a. */
3121 memcpy(bslice->ob_digit, b->ob_digit + nbdone,
3122 nbtouse * sizeof(digit));
Christian Heimes90aa7642007-12-19 02:45:37 +00003123 Py_SIZE(bslice) = nbtouse;
Tim Peters60004642002-08-12 22:01:34 +00003124 product = k_mul(a, bslice);
3125 if (product == NULL)
3126 goto fail;
3127
3128 /* Add into result. */
Christian Heimes90aa7642007-12-19 02:45:37 +00003129 (void)v_iadd(ret->ob_digit + nbdone, Py_SIZE(ret) - nbdone,
3130 product->ob_digit, Py_SIZE(product));
Tim Peters60004642002-08-12 22:01:34 +00003131 Py_DECREF(product);
3132
3133 bsize -= nbtouse;
3134 nbdone += nbtouse;
3135 }
3136
3137 Py_DECREF(bslice);
3138 return long_normalize(ret);
3139
3140 fail:
3141 Py_DECREF(ret);
3142 Py_XDECREF(bslice);
3143 return NULL;
3144}
Tim Peters5af4e6c2002-08-12 02:31:19 +00003145
3146static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003147long_mul(PyLongObject *a, PyLongObject *b)
Tim Peters5af4e6c2002-08-12 02:31:19 +00003148{
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003149 PyLongObject *z;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003150
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003151 CHECK_BINOP(a, b);
Tim Peters5af4e6c2002-08-12 02:31:19 +00003152
Mark Dickinsonbd792642009-03-18 20:06:12 +00003153 /* fast path for single-digit multiplication */
Christian Heimes90aa7642007-12-19 02:45:37 +00003154 if (ABS(Py_SIZE(a)) <= 1 && ABS(Py_SIZE(b)) <= 1) {
Mark Dickinsonbd792642009-03-18 20:06:12 +00003155 stwodigits v = (stwodigits)(MEDIUM_VALUE(a)) * MEDIUM_VALUE(b);
3156#ifdef HAVE_LONG_LONG
3157 return PyLong_FromLongLong((PY_LONG_LONG)v);
3158#else
3159 /* if we don't have long long then we're almost certainly
3160 using 15-bit digits, so v will fit in a long. In the
3161 unlikely event that we're using 30-bit digits on a platform
3162 without long long, a large v will just cause us to fall
3163 through to the general multiplication code below. */
3164 if (v >= LONG_MIN && v <= LONG_MAX)
3165 return PyLong_FromLong((long)v);
3166#endif
Martin v. Löwis14b6d922007-02-06 21:05:30 +00003167 }
Guido van Rossumddefaf32007-01-14 03:31:43 +00003168
Tim Petersd64c1de2002-08-12 17:36:03 +00003169 z = k_mul(a, b);
Tim Peters9973d742002-08-15 19:41:06 +00003170 /* Negate if exactly one of the inputs is negative. */
Christian Heimes90aa7642007-12-19 02:45:37 +00003171 if (((Py_SIZE(a) ^ Py_SIZE(b)) < 0) && z)
Guido van Rossumddefaf32007-01-14 03:31:43 +00003172 NEGATE(z);
Tim Peters9973d742002-08-15 19:41:06 +00003173 return (PyObject *)z;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003174}
3175
Guido van Rossume32e0141992-01-19 16:31:05 +00003176/* The / and % operators are now defined in terms of divmod().
3177 The expression a mod b has the value a - b*floor(a/b).
3178 The long_divrem function gives the remainder after division of
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003179 |a| by |b|, with the sign of a. This is also expressed
3180 as a - b*trunc(a/b), if trunc truncates towards zero.
3181 Some examples:
3182 a b a rem b a mod b
3183 13 10 3 3
3184 -13 10 -3 7
3185 13 -10 3 -7
3186 -13 -10 -3 -3
3187 So, to get from rem to mod, we have to add b if a and b
Guido van Rossum23d6f0e1991-05-14 12:06:49 +00003188 have different signs. We then subtract one from the 'div'
3189 part of the outcome to keep the invariant intact. */
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003190
Tim Peters47e52ee2004-08-30 02:44:38 +00003191/* Compute
3192 * *pdiv, *pmod = divmod(v, w)
3193 * NULL can be passed for pdiv or pmod, in which case that part of
3194 * the result is simply thrown away. The caller owns a reference to
3195 * each of these it requests (does not pass NULL for).
3196 */
Guido van Rossume32e0141992-01-19 16:31:05 +00003197static int
Tim Peters5af4e6c2002-08-12 02:31:19 +00003198l_divmod(PyLongObject *v, PyLongObject *w,
Tim Peters9f688bf2000-07-07 15:53:28 +00003199 PyLongObject **pdiv, PyLongObject **pmod)
Guido van Rossume32e0141992-01-19 16:31:05 +00003200{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003201 PyLongObject *div, *mod;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003202
Guido van Rossume32e0141992-01-19 16:31:05 +00003203 if (long_divrem(v, w, &div, &mod) < 0)
3204 return -1;
Christian Heimes90aa7642007-12-19 02:45:37 +00003205 if ((Py_SIZE(mod) < 0 && Py_SIZE(w) > 0) ||
3206 (Py_SIZE(mod) > 0 && Py_SIZE(w) < 0)) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003207 PyLongObject *temp;
3208 PyLongObject *one;
3209 temp = (PyLongObject *) long_add(mod, w);
3210 Py_DECREF(mod);
Guido van Rossume32e0141992-01-19 16:31:05 +00003211 mod = temp;
3212 if (mod == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003213 Py_DECREF(div);
Guido van Rossume32e0141992-01-19 16:31:05 +00003214 return -1;
3215 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003216 one = (PyLongObject *) PyLong_FromLong(1L);
Guido van Rossume32e0141992-01-19 16:31:05 +00003217 if (one == NULL ||
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003218 (temp = (PyLongObject *) long_sub(div, one)) == NULL) {
3219 Py_DECREF(mod);
3220 Py_DECREF(div);
3221 Py_XDECREF(one);
Guido van Rossume32e0141992-01-19 16:31:05 +00003222 return -1;
3223 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003224 Py_DECREF(one);
3225 Py_DECREF(div);
Guido van Rossume32e0141992-01-19 16:31:05 +00003226 div = temp;
3227 }
Tim Peters47e52ee2004-08-30 02:44:38 +00003228 if (pdiv != NULL)
3229 *pdiv = div;
3230 else
3231 Py_DECREF(div);
3232
3233 if (pmod != NULL)
3234 *pmod = mod;
3235 else
3236 Py_DECREF(mod);
3237
Guido van Rossume32e0141992-01-19 16:31:05 +00003238 return 0;
3239}
3240
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003241static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003242long_div(PyObject *a, PyObject *b)
Guido van Rossume32e0141992-01-19 16:31:05 +00003243{
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003244 PyLongObject *div;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003245
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003246 CHECK_BINOP(a, b);
3247 if (l_divmod((PyLongObject*)a, (PyLongObject*)b, &div, NULL) < 0)
Tim Peters47e52ee2004-08-30 02:44:38 +00003248 div = NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003249 return (PyObject *)div;
Guido van Rossume32e0141992-01-19 16:31:05 +00003250}
3251
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003252/* PyLong/PyLong -> float, with correctly rounded result. */
3253
3254#define MANT_DIG_DIGITS (DBL_MANT_DIG / PyLong_SHIFT)
3255#define MANT_DIG_BITS (DBL_MANT_DIG % PyLong_SHIFT)
3256
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003257static PyObject *
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003258long_true_divide(PyObject *v, PyObject *w)
Tim Peters20dab9f2001-09-04 05:31:47 +00003259{
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003260 PyLongObject *a, *b, *x;
3261 Py_ssize_t a_size, b_size, shift, extra_bits, diff, x_size, x_bits;
3262 digit mask, low;
3263 int inexact, negate, a_is_small, b_is_small;
3264 double dx, result;
Tim Peterse2a60002001-09-04 06:17:36 +00003265
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003266 CHECK_BINOP(v, w);
3267 a = (PyLongObject *)v;
3268 b = (PyLongObject *)w;
Tim Peterse2a60002001-09-04 06:17:36 +00003269
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003270 /*
3271 Method in a nutshell:
3272
3273 0. reduce to case a, b > 0; filter out obvious underflow/overflow
3274 1. choose a suitable integer 'shift'
3275 2. use integer arithmetic to compute x = floor(2**-shift*a/b)
3276 3. adjust x for correct rounding
3277 4. convert x to a double dx with the same value
3278 5. return ldexp(dx, shift).
3279
3280 In more detail:
3281
3282 0. For any a, a/0 raises ZeroDivisionError; for nonzero b, 0/b
3283 returns either 0.0 or -0.0, depending on the sign of b. For a and
3284 b both nonzero, ignore signs of a and b, and add the sign back in
3285 at the end. Now write a_bits and b_bits for the bit lengths of a
3286 and b respectively (that is, a_bits = 1 + floor(log_2(a)); likewise
3287 for b). Then
3288
3289 2**(a_bits - b_bits - 1) < a/b < 2**(a_bits - b_bits + 1).
3290
3291 So if a_bits - b_bits > DBL_MAX_EXP then a/b > 2**DBL_MAX_EXP and
3292 so overflows. Similarly, if a_bits - b_bits < DBL_MIN_EXP -
3293 DBL_MANT_DIG - 1 then a/b underflows to 0. With these cases out of
3294 the way, we can assume that
3295
3296 DBL_MIN_EXP - DBL_MANT_DIG - 1 <= a_bits - b_bits <= DBL_MAX_EXP.
3297
3298 1. The integer 'shift' is chosen so that x has the right number of
3299 bits for a double, plus two or three extra bits that will be used
3300 in the rounding decisions. Writing a_bits and b_bits for the
3301 number of significant bits in a and b respectively, a
3302 straightforward formula for shift is:
3303
3304 shift = a_bits - b_bits - DBL_MANT_DIG - 2
3305
3306 This is fine in the usual case, but if a/b is smaller than the
3307 smallest normal float then it can lead to double rounding on an
3308 IEEE 754 platform, giving incorrectly rounded results. So we
3309 adjust the formula slightly. The actual formula used is:
3310
3311 shift = MAX(a_bits - b_bits, DBL_MIN_EXP) - DBL_MANT_DIG - 2
3312
3313 2. The quantity x is computed by first shifting a (left -shift bits
3314 if shift <= 0, right shift bits if shift > 0) and then dividing by
3315 b. For both the shift and the division, we keep track of whether
3316 the result is inexact, in a flag 'inexact'; this information is
3317 needed at the rounding stage.
3318
3319 With the choice of shift above, together with our assumption that
3320 a_bits - b_bits >= DBL_MIN_EXP - DBL_MANT_DIG - 1, it follows
3321 that x >= 1.
3322
3323 3. Now x * 2**shift <= a/b < (x+1) * 2**shift. We want to replace
3324 this with an exactly representable float of the form
3325
3326 round(x/2**extra_bits) * 2**(extra_bits+shift).
3327
3328 For float representability, we need x/2**extra_bits <
3329 2**DBL_MANT_DIG and extra_bits + shift >= DBL_MIN_EXP -
3330 DBL_MANT_DIG. This translates to the condition:
3331
3332 extra_bits >= MAX(x_bits, DBL_MIN_EXP - shift) - DBL_MANT_DIG
3333
3334 To round, we just modify the bottom digit of x in-place; this can
3335 end up giving a digit with value > PyLONG_MASK, but that's not a
3336 problem since digits can hold values up to 2*PyLONG_MASK+1.
3337
3338 With the original choices for shift above, extra_bits will always
3339 be 2 or 3. Then rounding under the round-half-to-even rule, we
3340 round up iff the most significant of the extra bits is 1, and
3341 either: (a) the computation of x in step 2 had an inexact result,
3342 or (b) at least one other of the extra bits is 1, or (c) the least
3343 significant bit of x (above those to be rounded) is 1.
3344
3345 4. Conversion to a double is straightforward; all floating-point
3346 operations involved in the conversion are exact, so there's no
3347 danger of rounding errors.
3348
3349 5. Use ldexp(x, shift) to compute x*2**shift, the final result.
3350 The result will always be exactly representable as a double, except
3351 in the case that it overflows. To avoid dependence on the exact
3352 behaviour of ldexp on overflow, we check for overflow before
3353 applying ldexp. The result of ldexp is adjusted for sign before
3354 returning.
3355 */
3356
3357 /* Reduce to case where a and b are both positive. */
3358 a_size = ABS(Py_SIZE(a));
3359 b_size = ABS(Py_SIZE(b));
3360 negate = (Py_SIZE(a) < 0) ^ (Py_SIZE(b) < 0);
3361 if (b_size == 0) {
Tim Peterse2a60002001-09-04 06:17:36 +00003362 PyErr_SetString(PyExc_ZeroDivisionError,
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003363 "division by zero");
3364 goto error;
3365 }
3366 if (a_size == 0)
3367 goto underflow_or_zero;
3368
3369 /* Fast path for a and b small (exactly representable in a double).
3370 Relies on floating-point division being correctly rounded; results
3371 may be subject to double rounding on x86 machines that operate with
3372 the x87 FPU set to 64-bit precision. */
3373 a_is_small = a_size <= MANT_DIG_DIGITS ||
3374 (a_size == MANT_DIG_DIGITS+1 &&
3375 a->ob_digit[MANT_DIG_DIGITS] >> MANT_DIG_BITS == 0);
3376 b_is_small = b_size <= MANT_DIG_DIGITS ||
3377 (b_size == MANT_DIG_DIGITS+1 &&
3378 b->ob_digit[MANT_DIG_DIGITS] >> MANT_DIG_BITS == 0);
3379 if (a_is_small && b_is_small) {
3380 double da, db;
3381 da = a->ob_digit[--a_size];
3382 while (a_size > 0)
3383 da = da * PyLong_BASE + a->ob_digit[--a_size];
3384 db = b->ob_digit[--b_size];
3385 while (b_size > 0)
3386 db = db * PyLong_BASE + b->ob_digit[--b_size];
3387 result = da / db;
3388 goto success;
Tim Peterse2a60002001-09-04 06:17:36 +00003389 }
3390
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003391 /* Catch obvious cases of underflow and overflow */
3392 diff = a_size - b_size;
3393 if (diff > PY_SSIZE_T_MAX/PyLong_SHIFT - 1)
3394 /* Extreme overflow */
Tim Peterse2a60002001-09-04 06:17:36 +00003395 goto overflow;
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003396 else if (diff < 1 - PY_SSIZE_T_MAX/PyLong_SHIFT)
3397 /* Extreme underflow */
3398 goto underflow_or_zero;
3399 /* Next line is now safe from overflowing a Py_ssize_t */
3400 diff = diff * PyLong_SHIFT + bits_in_digit(a->ob_digit[a_size - 1]) -
3401 bits_in_digit(b->ob_digit[b_size - 1]);
3402 /* Now diff = a_bits - b_bits. */
3403 if (diff > DBL_MAX_EXP)
Tim Peterse2a60002001-09-04 06:17:36 +00003404 goto overflow;
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003405 else if (diff < DBL_MIN_EXP - DBL_MANT_DIG - 1)
3406 goto underflow_or_zero;
Tim Peterse2a60002001-09-04 06:17:36 +00003407
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003408 /* Choose value for shift; see comments for step 1 above. */
3409 shift = MAX(diff, DBL_MIN_EXP) - DBL_MANT_DIG - 2;
3410
3411 inexact = 0;
3412
3413 /* x = abs(a * 2**-shift) */
3414 if (shift <= 0) {
3415 Py_ssize_t i, shift_digits = -shift / PyLong_SHIFT;
3416 digit rem;
3417 /* x = a << -shift */
3418 if (a_size >= PY_SSIZE_T_MAX - 1 - shift_digits) {
3419 /* In practice, it's probably impossible to end up
3420 here. Both a and b would have to be enormous,
3421 using close to SIZE_T_MAX bytes of memory each. */
3422 PyErr_SetString(PyExc_OverflowError,
3423 "intermediate overflow during division");
3424 goto error;
3425 }
3426 x = _PyLong_New(a_size + shift_digits + 1);
3427 if (x == NULL)
3428 goto error;
3429 for (i = 0; i < shift_digits; i++)
3430 x->ob_digit[i] = 0;
3431 rem = v_lshift(x->ob_digit + shift_digits, a->ob_digit,
3432 a_size, -shift % PyLong_SHIFT);
3433 x->ob_digit[a_size + shift_digits] = rem;
3434 }
3435 else {
3436 Py_ssize_t shift_digits = shift / PyLong_SHIFT;
3437 digit rem;
3438 /* x = a >> shift */
3439 assert(a_size >= shift_digits);
3440 x = _PyLong_New(a_size - shift_digits);
3441 if (x == NULL)
3442 goto error;
3443 rem = v_rshift(x->ob_digit, a->ob_digit + shift_digits,
3444 a_size - shift_digits, shift % PyLong_SHIFT);
3445 /* set inexact if any of the bits shifted out is nonzero */
3446 if (rem)
3447 inexact = 1;
3448 while (!inexact && shift_digits > 0)
3449 if (a->ob_digit[--shift_digits])
3450 inexact = 1;
3451 }
3452 long_normalize(x);
3453 x_size = Py_SIZE(x);
3454
3455 /* x //= b. If the remainder is nonzero, set inexact. We own the only
3456 reference to x, so it's safe to modify it in-place. */
3457 if (b_size == 1) {
3458 digit rem = inplace_divrem1(x->ob_digit, x->ob_digit, x_size,
3459 b->ob_digit[0]);
3460 long_normalize(x);
3461 if (rem)
3462 inexact = 1;
3463 }
3464 else {
3465 PyLongObject *div, *rem;
3466 div = x_divrem(x, b, &rem);
3467 Py_DECREF(x);
3468 x = div;
3469 if (x == NULL)
3470 goto error;
3471 if (Py_SIZE(rem))
3472 inexact = 1;
3473 Py_DECREF(rem);
3474 }
3475 x_size = ABS(Py_SIZE(x));
3476 assert(x_size > 0); /* result of division is never zero */
3477 x_bits = (x_size-1)*PyLong_SHIFT+bits_in_digit(x->ob_digit[x_size-1]);
3478
3479 /* The number of extra bits that have to be rounded away. */
3480 extra_bits = MAX(x_bits, DBL_MIN_EXP - shift) - DBL_MANT_DIG;
3481 assert(extra_bits == 2 || extra_bits == 3);
3482
3483 /* Round by directly modifying the low digit of x. */
3484 mask = (digit)1 << (extra_bits - 1);
3485 low = x->ob_digit[0] | inexact;
3486 if (low & mask && low & (3*mask-1))
3487 low += mask;
3488 x->ob_digit[0] = low & ~(mask-1U);
3489
3490 /* Convert x to a double dx; the conversion is exact. */
3491 dx = x->ob_digit[--x_size];
3492 while (x_size > 0)
3493 dx = dx * PyLong_BASE + x->ob_digit[--x_size];
3494 Py_DECREF(x);
3495
3496 /* Check whether ldexp result will overflow a double. */
3497 if (shift + x_bits >= DBL_MAX_EXP &&
3498 (shift + x_bits > DBL_MAX_EXP || dx == ldexp(1.0, x_bits)))
3499 goto overflow;
3500 result = ldexp(dx, shift);
3501
3502 success:
3503 return PyFloat_FromDouble(negate ? -result : result);
3504
3505 underflow_or_zero:
3506 return PyFloat_FromDouble(negate ? -0.0 : 0.0);
3507
3508 overflow:
Tim Peterse2a60002001-09-04 06:17:36 +00003509 PyErr_SetString(PyExc_OverflowError,
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003510 "integer division result too large for a float");
3511 error:
Tim Peterse2a60002001-09-04 06:17:36 +00003512 return NULL;
Tim Peters20dab9f2001-09-04 05:31:47 +00003513}
3514
3515static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003516long_mod(PyObject *a, PyObject *b)
Guido van Rossume32e0141992-01-19 16:31:05 +00003517{
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003518 PyLongObject *mod;
3519
3520 CHECK_BINOP(a, b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003521
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003522 if (l_divmod((PyLongObject*)a, (PyLongObject*)b, NULL, &mod) < 0)
Tim Peters47e52ee2004-08-30 02:44:38 +00003523 mod = NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003524 return (PyObject *)mod;
Guido van Rossume32e0141992-01-19 16:31:05 +00003525}
3526
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003527static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003528long_divmod(PyObject *a, PyObject *b)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003529{
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003530 PyLongObject *div, *mod;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003531 PyObject *z;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003532
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003533 CHECK_BINOP(a, b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003534
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003535 if (l_divmod((PyLongObject*)a, (PyLongObject*)b, &div, &mod) < 0) {
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003536 return NULL;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003537 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003538 z = PyTuple_New(2);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003539 if (z != NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003540 PyTuple_SetItem(z, 0, (PyObject *) div);
3541 PyTuple_SetItem(z, 1, (PyObject *) mod);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003542 }
3543 else {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003544 Py_DECREF(div);
3545 Py_DECREF(mod);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003546 }
3547 return z;
3548}
3549
Tim Peters47e52ee2004-08-30 02:44:38 +00003550/* pow(v, w, x) */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003551static PyObject *
Neil Schemenauerba872e22001-01-04 01:46:03 +00003552long_pow(PyObject *v, PyObject *w, PyObject *x)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003553{
Tim Peters47e52ee2004-08-30 02:44:38 +00003554 PyLongObject *a, *b, *c; /* a,b,c = v,w,x */
3555 int negativeOutput = 0; /* if x<0 return negative output */
Neil Schemenauerba872e22001-01-04 01:46:03 +00003556
Tim Peters47e52ee2004-08-30 02:44:38 +00003557 PyLongObject *z = NULL; /* accumulated result */
Martin v. Löwis18e16552006-02-15 17:27:45 +00003558 Py_ssize_t i, j, k; /* counters */
Tim Peters47e52ee2004-08-30 02:44:38 +00003559 PyLongObject *temp = NULL;
3560
3561 /* 5-ary values. If the exponent is large enough, table is
3562 * precomputed so that table[i] == a**i % c for i in range(32).
3563 */
3564 PyLongObject *table[32] = {0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3565 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0};
3566
3567 /* a, b, c = v, w, x */
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003568 CHECK_BINOP(v, w);
3569 a = (PyLongObject*)v; Py_INCREF(a);
3570 b = (PyLongObject*)w; Py_INCREF(b);
Tim Peters47e52ee2004-08-30 02:44:38 +00003571 if (PyLong_Check(x)) {
3572 c = (PyLongObject *)x;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003573 Py_INCREF(x);
3574 }
Tim Peters47e52ee2004-08-30 02:44:38 +00003575 else if (x == Py_None)
3576 c = NULL;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003577 else {
3578 Py_DECREF(a);
3579 Py_DECREF(b);
3580 Py_INCREF(Py_NotImplemented);
3581 return Py_NotImplemented;
3582 }
Tim Peters4c483c42001-09-05 06:24:58 +00003583
Christian Heimes90aa7642007-12-19 02:45:37 +00003584 if (Py_SIZE(b) < 0) { /* if exponent is negative */
Tim Peters47e52ee2004-08-30 02:44:38 +00003585 if (c) {
Tim Peters4c483c42001-09-05 06:24:58 +00003586 PyErr_SetString(PyExc_TypeError, "pow() 2nd argument "
Tim Peters47e52ee2004-08-30 02:44:38 +00003587 "cannot be negative when 3rd argument specified");
Tim Peterscd97da32004-08-30 02:58:59 +00003588 goto Error;
Tim Peters32f453e2001-09-03 08:35:41 +00003589 }
Guido van Rossum2c7b8fe1999-10-11 22:34:41 +00003590 else {
Tim Peters47e52ee2004-08-30 02:44:38 +00003591 /* else return a float. This works because we know
3592 that this calls float_pow() which converts its
3593 arguments to double. */
3594 Py_DECREF(a);
3595 Py_DECREF(b);
3596 return PyFloat_Type.tp_as_number->nb_power(v, w, x);
Guido van Rossum2c7b8fe1999-10-11 22:34:41 +00003597 }
Guido van Rossumeb1fafc1994-08-29 12:47:19 +00003598 }
Tim Peters47e52ee2004-08-30 02:44:38 +00003599
3600 if (c) {
3601 /* if modulus == 0:
3602 raise ValueError() */
Christian Heimes90aa7642007-12-19 02:45:37 +00003603 if (Py_SIZE(c) == 0) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003604 PyErr_SetString(PyExc_ValueError,
3605 "pow() 3rd argument cannot be 0");
Tim Peterscd97da32004-08-30 02:58:59 +00003606 goto Error;
Tim Peters47e52ee2004-08-30 02:44:38 +00003607 }
3608
3609 /* if modulus < 0:
3610 negativeOutput = True
3611 modulus = -modulus */
Christian Heimes90aa7642007-12-19 02:45:37 +00003612 if (Py_SIZE(c) < 0) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003613 negativeOutput = 1;
3614 temp = (PyLongObject *)_PyLong_Copy(c);
3615 if (temp == NULL)
3616 goto Error;
3617 Py_DECREF(c);
3618 c = temp;
3619 temp = NULL;
Guido van Rossumddefaf32007-01-14 03:31:43 +00003620 NEGATE(c);
Tim Peters47e52ee2004-08-30 02:44:38 +00003621 }
3622
3623 /* if modulus == 1:
3624 return 0 */
Christian Heimes90aa7642007-12-19 02:45:37 +00003625 if ((Py_SIZE(c) == 1) && (c->ob_digit[0] == 1)) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003626 z = (PyLongObject *)PyLong_FromLong(0L);
3627 goto Done;
3628 }
3629
3630 /* if base < 0:
3631 base = base % modulus
3632 Having the base positive just makes things easier. */
Christian Heimes90aa7642007-12-19 02:45:37 +00003633 if (Py_SIZE(a) < 0) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003634 if (l_divmod(a, c, NULL, &temp) < 0)
Tim Peterscd97da32004-08-30 02:58:59 +00003635 goto Error;
Tim Peters47e52ee2004-08-30 02:44:38 +00003636 Py_DECREF(a);
3637 a = temp;
3638 temp = NULL;
3639 }
3640 }
3641
3642 /* At this point a, b, and c are guaranteed non-negative UNLESS
3643 c is NULL, in which case a may be negative. */
3644
3645 z = (PyLongObject *)PyLong_FromLong(1L);
3646 if (z == NULL)
3647 goto Error;
3648
3649 /* Perform a modular reduction, X = X % c, but leave X alone if c
3650 * is NULL.
3651 */
3652#define REDUCE(X) \
3653 if (c != NULL) { \
3654 if (l_divmod(X, c, NULL, &temp) < 0) \
3655 goto Error; \
3656 Py_XDECREF(X); \
3657 X = temp; \
3658 temp = NULL; \
3659 }
3660
3661 /* Multiply two values, then reduce the result:
3662 result = X*Y % c. If c is NULL, skip the mod. */
3663#define MULT(X, Y, result) \
3664{ \
3665 temp = (PyLongObject *)long_mul(X, Y); \
3666 if (temp == NULL) \
3667 goto Error; \
3668 Py_XDECREF(result); \
3669 result = temp; \
3670 temp = NULL; \
3671 REDUCE(result) \
3672}
3673
Christian Heimes90aa7642007-12-19 02:45:37 +00003674 if (Py_SIZE(b) <= FIVEARY_CUTOFF) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003675 /* Left-to-right binary exponentiation (HAC Algorithm 14.79) */
3676 /* http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf */
Christian Heimes90aa7642007-12-19 02:45:37 +00003677 for (i = Py_SIZE(b) - 1; i >= 0; --i) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003678 digit bi = b->ob_digit[i];
3679
Mark Dickinsone4416742009-02-15 15:14:57 +00003680 for (j = (digit)1 << (PyLong_SHIFT-1); j != 0; j >>= 1) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003681 MULT(z, z, z)
3682 if (bi & j)
3683 MULT(z, a, z)
3684 }
3685 }
3686 }
3687 else {
3688 /* Left-to-right 5-ary exponentiation (HAC Algorithm 14.82) */
3689 Py_INCREF(z); /* still holds 1L */
3690 table[0] = z;
3691 for (i = 1; i < 32; ++i)
3692 MULT(table[i-1], a, table[i])
3693
Christian Heimes90aa7642007-12-19 02:45:37 +00003694 for (i = Py_SIZE(b) - 1; i >= 0; --i) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003695 const digit bi = b->ob_digit[i];
3696
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003697 for (j = PyLong_SHIFT - 5; j >= 0; j -= 5) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003698 const int index = (bi >> j) & 0x1f;
3699 for (k = 0; k < 5; ++k)
3700 MULT(z, z, z)
3701 if (index)
3702 MULT(z, table[index], z)
3703 }
3704 }
3705 }
3706
Christian Heimes90aa7642007-12-19 02:45:37 +00003707 if (negativeOutput && (Py_SIZE(z) != 0)) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003708 temp = (PyLongObject *)long_sub(z, c);
3709 if (temp == NULL)
3710 goto Error;
3711 Py_DECREF(z);
3712 z = temp;
3713 temp = NULL;
3714 }
3715 goto Done;
3716
3717 Error:
3718 if (z != NULL) {
3719 Py_DECREF(z);
3720 z = NULL;
3721 }
3722 /* fall through */
3723 Done:
Christian Heimes90aa7642007-12-19 02:45:37 +00003724 if (Py_SIZE(b) > FIVEARY_CUTOFF) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003725 for (i = 0; i < 32; ++i)
3726 Py_XDECREF(table[i]);
3727 }
Tim Petersde7990b2005-07-17 23:45:23 +00003728 Py_DECREF(a);
3729 Py_DECREF(b);
3730 Py_XDECREF(c);
3731 Py_XDECREF(temp);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003732 return (PyObject *)z;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003733}
3734
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003735static PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00003736long_invert(PyLongObject *v)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003737{
Guido van Rossum4c260ff1992-01-14 18:36:43 +00003738 /* Implement ~x as -(x+1) */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003739 PyLongObject *x;
3740 PyLongObject *w;
Christian Heimes90aa7642007-12-19 02:45:37 +00003741 if (ABS(Py_SIZE(v)) <=1)
Guido van Rossumddefaf32007-01-14 03:31:43 +00003742 return PyLong_FromLong(-(MEDIUM_VALUE(v)+1));
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003743 w = (PyLongObject *)PyLong_FromLong(1L);
Guido van Rossum4c260ff1992-01-14 18:36:43 +00003744 if (w == NULL)
3745 return NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003746 x = (PyLongObject *) long_add(v, w);
3747 Py_DECREF(w);
Guido van Rossum4c260ff1992-01-14 18:36:43 +00003748 if (x == NULL)
3749 return NULL;
Christian Heimes90aa7642007-12-19 02:45:37 +00003750 Py_SIZE(x) = -(Py_SIZE(x));
Facundo Batista6e6f59b2008-07-24 18:57:11 +00003751 return (PyObject *)maybe_small_long(x);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003752}
3753
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003754static PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00003755long_neg(PyLongObject *v)
Guido van Rossumc6913e71991-11-19 20:26:46 +00003756{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003757 PyLongObject *z;
Christian Heimes90aa7642007-12-19 02:45:37 +00003758 if (ABS(Py_SIZE(v)) <= 1)
Guido van Rossumddefaf32007-01-14 03:31:43 +00003759 return PyLong_FromLong(-MEDIUM_VALUE(v));
Tim Peters69c2de32001-09-11 22:31:33 +00003760 z = (PyLongObject *)_PyLong_Copy(v);
3761 if (z != NULL)
Christian Heimes90aa7642007-12-19 02:45:37 +00003762 Py_SIZE(z) = -(Py_SIZE(v));
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003763 return (PyObject *)z;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003764}
3765
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003766static PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00003767long_abs(PyLongObject *v)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003768{
Christian Heimes90aa7642007-12-19 02:45:37 +00003769 if (Py_SIZE(v) < 0)
Guido van Rossum4c260ff1992-01-14 18:36:43 +00003770 return long_neg(v);
Tim Peters69c2de32001-09-11 22:31:33 +00003771 else
Guido van Rossumb43daf72007-08-01 18:08:08 +00003772 return long_long((PyObject *)v);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003773}
3774
Guido van Rossum23d6f0e1991-05-14 12:06:49 +00003775static int
Jack Diederich4dafcc42006-11-28 19:15:13 +00003776long_bool(PyLongObject *v)
Guido van Rossum23d6f0e1991-05-14 12:06:49 +00003777{
Christian Heimes90aa7642007-12-19 02:45:37 +00003778 return ABS(Py_SIZE(v)) != 0;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003779}
3780
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003781static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003782long_rshift(PyLongObject *a, PyLongObject *b)
Guido van Rossumc6913e71991-11-19 20:26:46 +00003783{
Neil Schemenauerba872e22001-01-04 01:46:03 +00003784 PyLongObject *z = NULL;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003785 long shiftby;
Martin v. Löwis18e16552006-02-15 17:27:45 +00003786 Py_ssize_t newsize, wordshift, loshift, hishift, i, j;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003787 digit lomask, himask;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003788
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003789 CHECK_BINOP(a, b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003790
Christian Heimes90aa7642007-12-19 02:45:37 +00003791 if (Py_SIZE(a) < 0) {
Guido van Rossum4c260ff1992-01-14 18:36:43 +00003792 /* Right shifting negative numbers is harder */
Neil Schemenauerba872e22001-01-04 01:46:03 +00003793 PyLongObject *a1, *a2;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003794 a1 = (PyLongObject *) long_invert(a);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003795 if (a1 == NULL)
3796 goto rshift_error;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003797 a2 = (PyLongObject *) long_rshift(a1, b);
3798 Py_DECREF(a1);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003799 if (a2 == NULL)
3800 goto rshift_error;
3801 z = (PyLongObject *) long_invert(a2);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003802 Py_DECREF(a2);
Guido van Rossumc6913e71991-11-19 20:26:46 +00003803 }
Neil Schemenauerba872e22001-01-04 01:46:03 +00003804 else {
Tim Peters5af4e6c2002-08-12 02:31:19 +00003805
Neil Schemenauerba872e22001-01-04 01:46:03 +00003806 shiftby = PyLong_AsLong((PyObject *)b);
3807 if (shiftby == -1L && PyErr_Occurred())
3808 goto rshift_error;
3809 if (shiftby < 0) {
3810 PyErr_SetString(PyExc_ValueError,
3811 "negative shift count");
3812 goto rshift_error;
3813 }
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003814 wordshift = shiftby / PyLong_SHIFT;
Christian Heimes90aa7642007-12-19 02:45:37 +00003815 newsize = ABS(Py_SIZE(a)) - wordshift;
Facundo Batista6e6f59b2008-07-24 18:57:11 +00003816 if (newsize <= 0)
3817 return PyLong_FromLong(0);
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003818 loshift = shiftby % PyLong_SHIFT;
3819 hishift = PyLong_SHIFT - loshift;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003820 lomask = ((digit)1 << hishift) - 1;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003821 himask = PyLong_MASK ^ lomask;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003822 z = _PyLong_New(newsize);
3823 if (z == NULL)
3824 goto rshift_error;
Christian Heimes90aa7642007-12-19 02:45:37 +00003825 if (Py_SIZE(a) < 0)
3826 Py_SIZE(z) = -(Py_SIZE(z));
Neil Schemenauerba872e22001-01-04 01:46:03 +00003827 for (i = 0, j = wordshift; i < newsize; i++, j++) {
3828 z->ob_digit[i] = (a->ob_digit[j] >> loshift) & lomask;
3829 if (i+1 < newsize)
3830 z->ob_digit[i] |=
3831 (a->ob_digit[j+1] << hishift) & himask;
3832 }
3833 z = long_normalize(z);
Guido van Rossumc6913e71991-11-19 20:26:46 +00003834 }
Neil Schemenauerba872e22001-01-04 01:46:03 +00003835rshift_error:
Facundo Batista6e6f59b2008-07-24 18:57:11 +00003836 return (PyObject *) maybe_small_long(z);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003837
Guido van Rossumc6913e71991-11-19 20:26:46 +00003838}
3839
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003840static PyObject *
Neil Schemenauerba872e22001-01-04 01:46:03 +00003841long_lshift(PyObject *v, PyObject *w)
Guido van Rossumc6913e71991-11-19 20:26:46 +00003842{
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003843 /* This version due to Tim Peters */
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003844 PyLongObject *a = (PyLongObject*)v;
3845 PyLongObject *b = (PyLongObject*)w;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003846 PyLongObject *z = NULL;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003847 long shiftby;
Martin v. Löwis18e16552006-02-15 17:27:45 +00003848 Py_ssize_t oldsize, newsize, wordshift, remshift, i, j;
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003849 twodigits accum;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003850
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003851 CHECK_BINOP(a, b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003852
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003853 shiftby = PyLong_AsLong((PyObject *)b);
3854 if (shiftby == -1L && PyErr_Occurred())
Neil Schemenauerba872e22001-01-04 01:46:03 +00003855 goto lshift_error;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003856 if (shiftby < 0) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003857 PyErr_SetString(PyExc_ValueError, "negative shift count");
Neil Schemenauerba872e22001-01-04 01:46:03 +00003858 goto lshift_error;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003859 }
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003860 if ((long)(int)shiftby != shiftby) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003861 PyErr_SetString(PyExc_ValueError,
3862 "outrageous left shift count");
Neil Schemenauerba872e22001-01-04 01:46:03 +00003863 goto lshift_error;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003864 }
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003865 /* wordshift, remshift = divmod(shiftby, PyLong_SHIFT) */
3866 wordshift = (int)shiftby / PyLong_SHIFT;
3867 remshift = (int)shiftby - wordshift * PyLong_SHIFT;
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003868
Christian Heimes90aa7642007-12-19 02:45:37 +00003869 oldsize = ABS(Py_SIZE(a));
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003870 newsize = oldsize + wordshift;
3871 if (remshift)
3872 ++newsize;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003873 z = _PyLong_New(newsize);
Guido van Rossumc6913e71991-11-19 20:26:46 +00003874 if (z == NULL)
Neil Schemenauerba872e22001-01-04 01:46:03 +00003875 goto lshift_error;
Christian Heimes90aa7642007-12-19 02:45:37 +00003876 if (Py_SIZE(a) < 0)
Guido van Rossumddefaf32007-01-14 03:31:43 +00003877 NEGATE(z);
Guido van Rossumc6913e71991-11-19 20:26:46 +00003878 for (i = 0; i < wordshift; i++)
3879 z->ob_digit[i] = 0;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003880 accum = 0;
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003881 for (i = wordshift, j = 0; j < oldsize; i++, j++) {
Tim Peters0d2d87d2002-08-20 19:00:22 +00003882 accum |= (twodigits)a->ob_digit[j] << remshift;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003883 z->ob_digit[i] = (digit)(accum & PyLong_MASK);
3884 accum >>= PyLong_SHIFT;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003885 }
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003886 if (remshift)
3887 z->ob_digit[newsize-1] = (digit)accum;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003888 else
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003889 assert(!accum);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003890 z = long_normalize(z);
3891lshift_error:
Facundo Batista6e6f59b2008-07-24 18:57:11 +00003892 return (PyObject *) maybe_small_long(z);
Guido van Rossumc6913e71991-11-19 20:26:46 +00003893}
3894
Mark Dickinson27a87a22009-10-25 20:43:34 +00003895/* Compute two's complement of digit vector a[0:m], writing result to
3896 z[0:m]. The digit vector a need not be normalized, but should not
3897 be entirely zero. a and z may point to the same digit vector. */
3898
3899static void
3900v_complement(digit *z, digit *a, Py_ssize_t m)
3901{
3902 Py_ssize_t i;
3903 digit carry = 1;
3904 for (i = 0; i < m; ++i) {
3905 carry += a[i] ^ PyLong_MASK;
3906 z[i] = carry & PyLong_MASK;
3907 carry >>= PyLong_SHIFT;
3908 }
3909 assert(carry == 0);
3910}
Guido van Rossum4c260ff1992-01-14 18:36:43 +00003911
3912/* Bitwise and/xor/or operations */
3913
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003914static PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00003915long_bitwise(PyLongObject *a,
3916 int op, /* '&', '|', '^' */
3917 PyLongObject *b)
Guido van Rossumc6913e71991-11-19 20:26:46 +00003918{
Mark Dickinson27a87a22009-10-25 20:43:34 +00003919 int nega, negb, negz;
Mark Dickinsone4416742009-02-15 15:14:57 +00003920 Py_ssize_t size_a, size_b, size_z, i;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003921 PyLongObject *z;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003922
Mark Dickinson27a87a22009-10-25 20:43:34 +00003923 /* Bitwise operations for negative numbers operate as though
3924 on a two's complement representation. So convert arguments
3925 from sign-magnitude to two's complement, and convert the
3926 result back to sign-magnitude at the end. */
3927
3928 /* If a is negative, replace it by its two's complement. */
3929 size_a = ABS(Py_SIZE(a));
3930 nega = Py_SIZE(a) < 0;
3931 if (nega) {
3932 z = _PyLong_New(size_a);
3933 if (z == NULL)
Hye-Shik Chang4af5c8c2006-03-07 15:39:21 +00003934 return NULL;
Mark Dickinson27a87a22009-10-25 20:43:34 +00003935 v_complement(z->ob_digit, a->ob_digit, size_a);
3936 a = z;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003937 }
Mark Dickinson27a87a22009-10-25 20:43:34 +00003938 else
3939 /* Keep reference count consistent. */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003940 Py_INCREF(a);
Mark Dickinson27a87a22009-10-25 20:43:34 +00003941
3942 /* Same for b. */
3943 size_b = ABS(Py_SIZE(b));
3944 negb = Py_SIZE(b) < 0;
3945 if (negb) {
3946 z = _PyLong_New(size_b);
3947 if (z == NULL) {
Hye-Shik Chang4af5c8c2006-03-07 15:39:21 +00003948 Py_DECREF(a);
3949 return NULL;
3950 }
Mark Dickinson27a87a22009-10-25 20:43:34 +00003951 v_complement(z->ob_digit, b->ob_digit, size_b);
3952 b = z;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003953 }
Mark Dickinson27a87a22009-10-25 20:43:34 +00003954 else
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003955 Py_INCREF(b);
Tim Peters5af4e6c2002-08-12 02:31:19 +00003956
Mark Dickinson27a87a22009-10-25 20:43:34 +00003957 /* Swap a and b if necessary to ensure size_a >= size_b. */
3958 if (size_a < size_b) {
3959 z = a; a = b; b = z;
3960 size_z = size_a; size_a = size_b; size_b = size_z;
3961 negz = nega; nega = negb; negb = negz;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003962 }
Tim Peters5af4e6c2002-08-12 02:31:19 +00003963
Guido van Rossumbd3a5271998-08-11 15:04:47 +00003964 /* JRH: The original logic here was to allocate the result value (z)
3965 as the longer of the two operands. However, there are some cases
3966 where the result is guaranteed to be shorter than that: AND of two
3967 positives, OR of two negatives: use the shorter number. AND with
3968 mixed signs: use the positive number. OR with mixed signs: use the
Mark Dickinson27a87a22009-10-25 20:43:34 +00003969 negative number.
Guido van Rossumbd3a5271998-08-11 15:04:47 +00003970 */
Mark Dickinson27a87a22009-10-25 20:43:34 +00003971 switch (op) {
3972 case '^':
3973 negz = nega ^ negb;
3974 size_z = size_a;
3975 break;
3976 case '&':
3977 negz = nega & negb;
3978 size_z = negb ? size_a : size_b;
3979 break;
3980 case '|':
3981 negz = nega | negb;
3982 size_z = negb ? size_b : size_a;
3983 break;
3984 default:
3985 PyErr_BadArgument();
3986 return NULL;
3987 }
Guido van Rossumbd3a5271998-08-11 15:04:47 +00003988
Mark Dickinson27a87a22009-10-25 20:43:34 +00003989 /* We allow an extra digit if z is negative, to make sure that
3990 the final two's complement of z doesn't overflow. */
3991 z = _PyLong_New(size_z + negz);
Hye-Shik Chang4af5c8c2006-03-07 15:39:21 +00003992 if (z == NULL) {
Thomas Wouters0e3f5912006-08-11 14:57:12 +00003993 Py_DECREF(a);
3994 Py_DECREF(b);
Guido van Rossumbd3a5271998-08-11 15:04:47 +00003995 return NULL;
3996 }
Tim Peters5af4e6c2002-08-12 02:31:19 +00003997
Mark Dickinson27a87a22009-10-25 20:43:34 +00003998 /* Compute digits for overlap of a and b. */
3999 switch(op) {
4000 case '&':
4001 for (i = 0; i < size_b; ++i)
4002 z->ob_digit[i] = a->ob_digit[i] & b->ob_digit[i];
4003 break;
4004 case '|':
4005 for (i = 0; i < size_b; ++i)
4006 z->ob_digit[i] = a->ob_digit[i] | b->ob_digit[i];
4007 break;
4008 case '^':
4009 for (i = 0; i < size_b; ++i)
4010 z->ob_digit[i] = a->ob_digit[i] ^ b->ob_digit[i];
4011 break;
4012 default:
4013 PyErr_BadArgument();
4014 return NULL;
4015 }
4016
4017 /* Copy any remaining digits of a, inverting if necessary. */
4018 if (op == '^' && negb)
4019 for (; i < size_z; ++i)
4020 z->ob_digit[i] = a->ob_digit[i] ^ PyLong_MASK;
4021 else if (i < size_z)
4022 memcpy(&z->ob_digit[i], &a->ob_digit[i],
4023 (size_z-i)*sizeof(digit));
4024
4025 /* Complement result if negative. */
4026 if (negz) {
4027 Py_SIZE(z) = -(Py_SIZE(z));
4028 z->ob_digit[size_z] = PyLong_MASK;
4029 v_complement(z->ob_digit, z->ob_digit, size_z+1);
Guido van Rossumafbb8db1991-12-31 13:14:13 +00004030 }
Tim Peters5af4e6c2002-08-12 02:31:19 +00004031
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004032 Py_DECREF(a);
4033 Py_DECREF(b);
Mark Dickinson27a87a22009-10-25 20:43:34 +00004034 return (PyObject *)maybe_small_long(long_normalize(z));
Guido van Rossumc6913e71991-11-19 20:26:46 +00004035}
4036
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004037static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00004038long_and(PyObject *a, PyObject *b)
Guido van Rossumc6913e71991-11-19 20:26:46 +00004039{
Neil Schemenauerba872e22001-01-04 01:46:03 +00004040 PyObject *c;
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00004041 CHECK_BINOP(a, b);
4042 c = long_bitwise((PyLongObject*)a, '&', (PyLongObject*)b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00004043 return c;
Guido van Rossumc6913e71991-11-19 20:26:46 +00004044}
4045
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004046static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00004047long_xor(PyObject *a, PyObject *b)
Guido van Rossumc6913e71991-11-19 20:26:46 +00004048{
Neil Schemenauerba872e22001-01-04 01:46:03 +00004049 PyObject *c;
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00004050 CHECK_BINOP(a, b);
4051 c = long_bitwise((PyLongObject*)a, '^', (PyLongObject*)b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00004052 return c;
Guido van Rossumc6913e71991-11-19 20:26:46 +00004053}
4054
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004055static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00004056long_or(PyObject *a, PyObject *b)
Guido van Rossumc6913e71991-11-19 20:26:46 +00004057{
Neil Schemenauerba872e22001-01-04 01:46:03 +00004058 PyObject *c;
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00004059 CHECK_BINOP(a, b);
4060 c = long_bitwise((PyLongObject*)a, '|', (PyLongObject*)b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00004061 return c;
Guido van Rossum23d6f0e1991-05-14 12:06:49 +00004062}
4063
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004064static PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00004065long_long(PyObject *v)
Guido van Rossum1899c2e1992-09-12 11:09:23 +00004066{
Brett Cannonc3647ac2005-04-26 03:45:26 +00004067 if (PyLong_CheckExact(v))
4068 Py_INCREF(v);
4069 else
4070 v = _PyLong_Copy((PyLongObject *)v);
Guido van Rossum1899c2e1992-09-12 11:09:23 +00004071 return v;
4072}
4073
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004074static PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00004075long_float(PyObject *v)
Guido van Rossum1899c2e1992-09-12 11:09:23 +00004076{
Guido van Rossum09e6ad01997-02-14 22:54:21 +00004077 double result;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004078 result = PyLong_AsDouble(v);
Tim Peters9fffa3e2001-09-04 05:14:19 +00004079 if (result == -1.0 && PyErr_Occurred())
4080 return NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004081 return PyFloat_FromDouble(result);
Guido van Rossum1899c2e1992-09-12 11:09:23 +00004082}
4083
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004084static PyObject *
Guido van Rossumbef14172001-08-29 15:47:46 +00004085long_subtype_new(PyTypeObject *type, PyObject *args, PyObject *kwds);
Guido van Rossum1899c2e1992-09-12 11:09:23 +00004086
Tim Peters6d6c1a32001-08-02 04:15:00 +00004087static PyObject *
4088long_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
4089{
4090 PyObject *x = NULL;
4091 int base = -909; /* unlikely! */
Martin v. Löwis15e62742006-02-27 16:46:16 +00004092 static char *kwlist[] = {"x", "base", 0};
Tim Peters6d6c1a32001-08-02 04:15:00 +00004093
Guido van Rossumbef14172001-08-29 15:47:46 +00004094 if (type != &PyLong_Type)
4095 return long_subtype_new(type, args, kwds); /* Wimp out */
Guido van Rossumddefaf32007-01-14 03:31:43 +00004096 if (!PyArg_ParseTupleAndKeywords(args, kwds, "|Oi:int", kwlist,
Tim Peters6d6c1a32001-08-02 04:15:00 +00004097 &x, &base))
4098 return NULL;
4099 if (x == NULL)
4100 return PyLong_FromLong(0L);
4101 if (base == -909)
4102 return PyNumber_Long(x);
Guido van Rossum98297ee2007-11-06 21:34:58 +00004103 else if (PyUnicode_Check(x))
4104 return PyLong_FromUnicode(PyUnicode_AS_UNICODE(x),
4105 PyUnicode_GET_SIZE(x),
4106 base);
Christian Heimes72b710a2008-05-26 13:28:38 +00004107 else if (PyByteArray_Check(x) || PyBytes_Check(x)) {
Guido van Rossumd8faa362007-04-27 19:54:29 +00004108 /* Since PyLong_FromString doesn't have a length parameter,
4109 * check here for possible NULs in the string. */
Guido van Rossum98297ee2007-11-06 21:34:58 +00004110 char *string;
Mark Dickinson5a74bf62009-02-15 11:04:38 +00004111 Py_ssize_t size = Py_SIZE(x);
Christian Heimes9c4756e2008-05-26 13:22:05 +00004112 if (PyByteArray_Check(x))
4113 string = PyByteArray_AS_STRING(x);
Guido van Rossum98297ee2007-11-06 21:34:58 +00004114 else
Christian Heimes72b710a2008-05-26 13:28:38 +00004115 string = PyBytes_AS_STRING(x);
Mark Dickinson5a74bf62009-02-15 11:04:38 +00004116 if (strlen(string) != (size_t)size) {
Guido van Rossum25236212007-08-22 23:28:23 +00004117 /* We only see this if there's a null byte in x,
Guido van Rossum98297ee2007-11-06 21:34:58 +00004118 x is a bytes or buffer, *and* a base is given. */
Guido van Rossumd8faa362007-04-27 19:54:29 +00004119 PyErr_Format(PyExc_ValueError,
Guido van Rossum25236212007-08-22 23:28:23 +00004120 "invalid literal for int() with base %d: %R",
4121 base, x);
Guido van Rossumd8faa362007-04-27 19:54:29 +00004122 return NULL;
Guido van Rossumddefaf32007-01-14 03:31:43 +00004123 }
Guido van Rossum4581ae52007-05-22 21:56:47 +00004124 return PyLong_FromString(string, NULL, base);
Guido van Rossumddefaf32007-01-14 03:31:43 +00004125 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00004126 else {
4127 PyErr_SetString(PyExc_TypeError,
Guido van Rossumddefaf32007-01-14 03:31:43 +00004128 "int() can't convert non-string with explicit base");
Tim Peters6d6c1a32001-08-02 04:15:00 +00004129 return NULL;
4130 }
4131}
4132
Guido van Rossumbef14172001-08-29 15:47:46 +00004133/* Wimpy, slow approach to tp_new calls for subtypes of long:
4134 first create a regular long from whatever arguments we got,
4135 then allocate a subtype instance and initialize it from
4136 the regular long. The regular long is then thrown away.
4137*/
4138static PyObject *
4139long_subtype_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
4140{
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004141 PyLongObject *tmp, *newobj;
Martin v. Löwis18e16552006-02-15 17:27:45 +00004142 Py_ssize_t i, n;
Guido van Rossumbef14172001-08-29 15:47:46 +00004143
4144 assert(PyType_IsSubtype(type, &PyLong_Type));
4145 tmp = (PyLongObject *)long_new(&PyLong_Type, args, kwds);
4146 if (tmp == NULL)
4147 return NULL;
Tim Peters64b5ce32001-09-10 20:52:51 +00004148 assert(PyLong_CheckExact(tmp));
Christian Heimes90aa7642007-12-19 02:45:37 +00004149 n = Py_SIZE(tmp);
Guido van Rossumbef14172001-08-29 15:47:46 +00004150 if (n < 0)
4151 n = -n;
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004152 newobj = (PyLongObject *)type->tp_alloc(type, n);
4153 if (newobj == NULL) {
Raymond Hettingerf4667932003-06-28 20:04:25 +00004154 Py_DECREF(tmp);
Guido van Rossumbef14172001-08-29 15:47:46 +00004155 return NULL;
Raymond Hettingerf4667932003-06-28 20:04:25 +00004156 }
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004157 assert(PyLong_Check(newobj));
Christian Heimes90aa7642007-12-19 02:45:37 +00004158 Py_SIZE(newobj) = Py_SIZE(tmp);
Guido van Rossumbef14172001-08-29 15:47:46 +00004159 for (i = 0; i < n; i++)
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004160 newobj->ob_digit[i] = tmp->ob_digit[i];
Guido van Rossumbef14172001-08-29 15:47:46 +00004161 Py_DECREF(tmp);
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004162 return (PyObject *)newobj;
Guido van Rossumbef14172001-08-29 15:47:46 +00004163}
4164
Guido van Rossum5d9113d2003-01-29 17:58:45 +00004165static PyObject *
4166long_getnewargs(PyLongObject *v)
4167{
4168 return Py_BuildValue("(N)", _PyLong_Copy(v));
4169}
4170
Guido van Rossumb43daf72007-08-01 18:08:08 +00004171static PyObject *
Mark Dickinson6bf19002009-05-02 17:57:52 +00004172long_get0(PyLongObject *v, void *context) {
4173 return PyLong_FromLong(0L);
4174}
4175
4176static PyObject *
4177long_get1(PyLongObject *v, void *context) {
4178 return PyLong_FromLong(1L);
Guido van Rossumb43daf72007-08-01 18:08:08 +00004179}
4180
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004181static PyObject *
Eric Smith8c663262007-08-25 02:26:07 +00004182long__format__(PyObject *self, PyObject *args)
4183{
Eric Smith4a7d76d2008-05-30 18:10:19 +00004184 PyObject *format_spec;
4185
4186 if (!PyArg_ParseTuple(args, "U:__format__", &format_spec))
4187 return NULL;
4188 return _PyLong_FormatAdvanced(self,
4189 PyUnicode_AS_UNICODE(format_spec),
4190 PyUnicode_GET_SIZE(format_spec));
Eric Smith8c663262007-08-25 02:26:07 +00004191}
4192
Eric Smith8c663262007-08-25 02:26:07 +00004193static PyObject *
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004194long_round(PyObject *self, PyObject *args)
4195{
Mark Dickinson1124e712009-01-28 21:25:58 +00004196 PyObject *o_ndigits=NULL, *temp;
4197 PyLongObject *pow=NULL, *q=NULL, *r=NULL, *ndigits=NULL, *one;
4198 int errcode;
4199 digit q_mod_4;
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004200
Mark Dickinson1124e712009-01-28 21:25:58 +00004201 /* Notes on the algorithm: to round to the nearest 10**n (n positive),
4202 the straightforward method is:
4203
4204 (1) divide by 10**n
4205 (2) round to nearest integer (round to even in case of tie)
4206 (3) multiply result by 10**n.
4207
4208 But the rounding step involves examining the fractional part of the
4209 quotient to see whether it's greater than 0.5 or not. Since we
4210 want to do the whole calculation in integer arithmetic, it's
4211 simpler to do:
4212
4213 (1) divide by (10**n)/2
4214 (2) round to nearest multiple of 2 (multiple of 4 in case of tie)
4215 (3) multiply result by (10**n)/2.
4216
4217 Then all we need to know about the fractional part of the quotient
4218 arising in step (2) is whether it's zero or not.
4219
4220 Doing both a multiplication and division is wasteful, and is easily
4221 avoided if we just figure out how much to adjust the original input
4222 by to do the rounding.
4223
4224 Here's the whole algorithm expressed in Python.
4225
4226 def round(self, ndigits = None):
4227 """round(int, int) -> int"""
4228 if ndigits is None or ndigits >= 0:
4229 return self
4230 pow = 10**-ndigits >> 1
4231 q, r = divmod(self, pow)
4232 self -= r
4233 if (q & 1 != 0):
4234 if (q & 2 == r == 0):
4235 self -= pow
4236 else:
4237 self += pow
4238 return self
4239
4240 */
4241 if (!PyArg_ParseTuple(args, "|O", &o_ndigits))
4242 return NULL;
4243 if (o_ndigits == NULL)
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004244 return long_long(self);
4245
Mark Dickinson1124e712009-01-28 21:25:58 +00004246 ndigits = (PyLongObject *)PyNumber_Index(o_ndigits);
4247 if (ndigits == NULL)
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004248 return NULL;
Mark Dickinson1124e712009-01-28 21:25:58 +00004249
4250 if (Py_SIZE(ndigits) >= 0) {
4251 Py_DECREF(ndigits);
4252 return long_long(self);
4253 }
4254
4255 Py_INCREF(self); /* to keep refcounting simple */
4256 /* we now own references to self, ndigits */
4257
4258 /* pow = 10 ** -ndigits >> 1 */
4259 pow = (PyLongObject *)PyLong_FromLong(10L);
4260 if (pow == NULL)
4261 goto error;
4262 temp = long_neg(ndigits);
4263 Py_DECREF(ndigits);
4264 ndigits = (PyLongObject *)temp;
4265 if (ndigits == NULL)
4266 goto error;
4267 temp = long_pow((PyObject *)pow, (PyObject *)ndigits, Py_None);
4268 Py_DECREF(pow);
4269 pow = (PyLongObject *)temp;
4270 if (pow == NULL)
4271 goto error;
4272 assert(PyLong_Check(pow)); /* check long_pow returned a long */
4273 one = (PyLongObject *)PyLong_FromLong(1L);
4274 if (one == NULL)
4275 goto error;
4276 temp = long_rshift(pow, one);
4277 Py_DECREF(one);
4278 Py_DECREF(pow);
4279 pow = (PyLongObject *)temp;
4280 if (pow == NULL)
4281 goto error;
4282
4283 /* q, r = divmod(self, pow) */
4284 errcode = l_divmod((PyLongObject *)self, pow, &q, &r);
4285 if (errcode == -1)
4286 goto error;
4287
4288 /* self -= r */
4289 temp = long_sub((PyLongObject *)self, r);
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004290 Py_DECREF(self);
Mark Dickinson1124e712009-01-28 21:25:58 +00004291 self = temp;
4292 if (self == NULL)
4293 goto error;
4294
4295 /* get value of quotient modulo 4 */
4296 if (Py_SIZE(q) == 0)
4297 q_mod_4 = 0;
4298 else if (Py_SIZE(q) > 0)
4299 q_mod_4 = q->ob_digit[0] & 3;
4300 else
4301 q_mod_4 = (PyLong_BASE-q->ob_digit[0]) & 3;
4302
4303 if ((q_mod_4 & 1) == 1) {
4304 /* q is odd; round self up or down by adding or subtracting pow */
4305 if (q_mod_4 == 1 && Py_SIZE(r) == 0)
4306 temp = (PyObject *)long_sub((PyLongObject *)self, pow);
4307 else
4308 temp = (PyObject *)long_add((PyLongObject *)self, pow);
4309 Py_DECREF(self);
4310 self = temp;
4311 if (self == NULL)
4312 goto error;
4313 }
4314 Py_DECREF(q);
4315 Py_DECREF(r);
4316 Py_DECREF(pow);
4317 Py_DECREF(ndigits);
4318 return self;
4319
4320 error:
4321 Py_XDECREF(q);
4322 Py_XDECREF(r);
4323 Py_XDECREF(pow);
4324 Py_XDECREF(self);
4325 Py_XDECREF(ndigits);
4326 return NULL;
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004327}
4328
Martin v. Löwis00709aa2008-06-04 14:18:43 +00004329static PyObject *
4330long_sizeof(PyLongObject *v)
4331{
4332 Py_ssize_t res;
4333
Mark Dickinson5a74bf62009-02-15 11:04:38 +00004334 res = offsetof(PyLongObject, ob_digit) + ABS(Py_SIZE(v))*sizeof(digit);
Martin v. Löwis00709aa2008-06-04 14:18:43 +00004335 return PyLong_FromSsize_t(res);
4336}
4337
Mark Dickinson54bc1ec2008-12-17 16:19:07 +00004338static PyObject *
4339long_bit_length(PyLongObject *v)
4340{
4341 PyLongObject *result, *x, *y;
4342 Py_ssize_t ndigits, msd_bits = 0;
4343 digit msd;
4344
4345 assert(v != NULL);
4346 assert(PyLong_Check(v));
4347
4348 ndigits = ABS(Py_SIZE(v));
4349 if (ndigits == 0)
4350 return PyLong_FromLong(0);
4351
4352 msd = v->ob_digit[ndigits-1];
4353 while (msd >= 32) {
4354 msd_bits += 6;
4355 msd >>= 6;
4356 }
4357 msd_bits += (long)(BitLengthTable[msd]);
4358
4359 if (ndigits <= PY_SSIZE_T_MAX/PyLong_SHIFT)
4360 return PyLong_FromSsize_t((ndigits-1)*PyLong_SHIFT + msd_bits);
4361
4362 /* expression above may overflow; use Python integers instead */
4363 result = (PyLongObject *)PyLong_FromSsize_t(ndigits - 1);
4364 if (result == NULL)
4365 return NULL;
4366 x = (PyLongObject *)PyLong_FromLong(PyLong_SHIFT);
4367 if (x == NULL)
4368 goto error;
4369 y = (PyLongObject *)long_mul(result, x);
4370 Py_DECREF(x);
4371 if (y == NULL)
4372 goto error;
4373 Py_DECREF(result);
4374 result = y;
4375
4376 x = (PyLongObject *)PyLong_FromLong(msd_bits);
4377 if (x == NULL)
4378 goto error;
4379 y = (PyLongObject *)long_add(result, x);
4380 Py_DECREF(x);
4381 if (y == NULL)
4382 goto error;
4383 Py_DECREF(result);
4384 result = y;
4385
4386 return (PyObject *)result;
4387
4388error:
4389 Py_DECREF(result);
4390 return NULL;
4391}
4392
4393PyDoc_STRVAR(long_bit_length_doc,
4394"int.bit_length() -> int\n\
4395\n\
4396Number of bits necessary to represent self in binary.\n\
4397>>> bin(37)\n\
4398'0b100101'\n\
4399>>> (37).bit_length()\n\
44006");
4401
Christian Heimes53876d92008-04-19 00:31:39 +00004402#if 0
4403static PyObject *
4404long_is_finite(PyObject *v)
4405{
4406 Py_RETURN_TRUE;
4407}
4408#endif
4409
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004410
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004411static PyObject *
4412long_to_bytes(PyLongObject *v, PyObject *args, PyObject *kwds)
4413{
4414 PyObject *byteorder_str;
4415 PyObject *is_signed_obj = NULL;
4416 Py_ssize_t length;
4417 int little_endian;
4418 int is_signed;
4419 PyObject *bytes;
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004420 static char *kwlist[] = {"length", "byteorder", "signed", NULL};
4421
Benjamin Peterson0c0e2292010-01-09 21:50:11 +00004422 if (!PyArg_ParseTupleAndKeywords(args, kwds, "nU|O:to_bytes", kwlist,
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004423 &length, &byteorder_str,
4424 &is_signed_obj))
4425 return NULL;
4426
4427 if (args != NULL && Py_SIZE(args) > 2) {
4428 PyErr_SetString(PyExc_TypeError,
4429 "'signed' is a keyword-only argument");
4430 return NULL;
4431 }
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004432
Benjamin Peterson0c0e2292010-01-09 21:50:11 +00004433 if (!PyUnicode_CompareWithASCIIString(byteorder_str, "little"))
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004434 little_endian = 1;
Benjamin Peterson0c0e2292010-01-09 21:50:11 +00004435 else if (!PyUnicode_CompareWithASCIIString(byteorder_str, "big"))
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004436 little_endian = 0;
4437 else {
4438 PyErr_SetString(PyExc_ValueError,
4439 "byteorder must be either 'little' or 'big'");
4440 return NULL;
4441 }
4442
4443 if (is_signed_obj != NULL) {
4444 int cmp = PyObject_IsTrue(is_signed_obj);
4445 if (cmp < 0)
4446 return NULL;
4447 is_signed = cmp ? 1 : 0;
4448 }
4449 else {
4450 /* If the signed argument was omitted, use False as the
4451 default. */
4452 is_signed = 0;
4453 }
4454
4455 if (length < 0) {
4456 PyErr_SetString(PyExc_ValueError,
4457 "length argument must be non-negative");
4458 return NULL;
4459 }
4460
4461 bytes = PyBytes_FromStringAndSize(NULL, length);
4462 if (bytes == NULL)
4463 return NULL;
4464
4465 if (_PyLong_AsByteArray(v, (unsigned char *)PyBytes_AS_STRING(bytes),
4466 length, little_endian, is_signed) < 0) {
4467 Py_DECREF(bytes);
4468 return NULL;
4469 }
4470
4471 return bytes;
4472}
4473
Mark Dickinson078c2532010-01-30 18:06:17 +00004474PyDoc_STRVAR(long_to_bytes_doc,
4475"int.to_bytes(length, byteorder, *, signed=False) -> bytes\n\
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004476\n\
Mark Dickinson078c2532010-01-30 18:06:17 +00004477Return an array of bytes representing an integer.\n\
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004478\n\
Mark Dickinson078c2532010-01-30 18:06:17 +00004479The integer is represented using length bytes. An OverflowError is\n\
4480raised if the integer is not representable with the given number of\n\
4481bytes.\n\
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004482\n\
4483The byteorder argument determines the byte order used to represent the\n\
4484integer. If byteorder is 'big', the most significant byte is at the\n\
4485beginning of the byte array. If byteorder is 'little', the most\n\
4486significant byte is at the end of the byte array. To request the native\n\
4487byte order of the host system, use `sys.byteorder' as the byte order value.\n\
4488\n\
Mark Dickinson078c2532010-01-30 18:06:17 +00004489The signed keyword-only argument determines whether two's complement is\n\
4490used to represent the integer. If signed is False and a negative integer\n\
4491is given, an OverflowError is raised.");
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004492
4493static PyObject *
4494long_from_bytes(PyTypeObject *type, PyObject *args, PyObject *kwds)
4495{
4496 PyObject *byteorder_str;
4497 PyObject *is_signed_obj = NULL;
4498 int little_endian;
4499 int is_signed;
4500 PyObject *obj;
4501 PyObject *bytes;
4502 PyObject *long_obj;
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004503 static char *kwlist[] = {"bytes", "byteorder", "signed", NULL};
4504
Benjamin Peterson0c0e2292010-01-09 21:50:11 +00004505 if (!PyArg_ParseTupleAndKeywords(args, kwds, "OU|O:from_bytes", kwlist,
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004506 &obj, &byteorder_str,
4507 &is_signed_obj))
4508 return NULL;
4509
4510 if (args != NULL && Py_SIZE(args) > 2) {
4511 PyErr_SetString(PyExc_TypeError,
4512 "'signed' is a keyword-only argument");
4513 return NULL;
4514 }
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004515
Benjamin Peterson0c0e2292010-01-09 21:50:11 +00004516 if (!PyUnicode_CompareWithASCIIString(byteorder_str, "little"))
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004517 little_endian = 1;
Benjamin Peterson0c0e2292010-01-09 21:50:11 +00004518 else if (!PyUnicode_CompareWithASCIIString(byteorder_str, "big"))
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004519 little_endian = 0;
4520 else {
4521 PyErr_SetString(PyExc_ValueError,
4522 "byteorder must be either 'little' or 'big'");
4523 return NULL;
4524 }
4525
4526 if (is_signed_obj != NULL) {
4527 int cmp = PyObject_IsTrue(is_signed_obj);
4528 if (cmp < 0)
4529 return NULL;
4530 is_signed = cmp ? 1 : 0;
4531 }
4532 else {
4533 /* If the signed argument was omitted, use False as the
4534 default. */
4535 is_signed = 0;
4536 }
4537
4538 bytes = PyObject_Bytes(obj);
4539 if (bytes == NULL)
4540 return NULL;
4541
4542 long_obj = _PyLong_FromByteArray(
4543 (unsigned char *)PyBytes_AS_STRING(bytes), Py_SIZE(bytes),
4544 little_endian, is_signed);
4545 Py_DECREF(bytes);
4546
4547 /* If from_bytes() was used on subclass, allocate new subclass
4548 * instance, initialize it with decoded long value and return it.
4549 */
4550 if (type != &PyLong_Type && PyType_IsSubtype(type, &PyLong_Type)) {
4551 PyLongObject *newobj;
4552 int i;
4553 Py_ssize_t n = ABS(Py_SIZE(long_obj));
4554
4555 newobj = (PyLongObject *)type->tp_alloc(type, n);
4556 if (newobj == NULL) {
4557 Py_DECREF(long_obj);
4558 return NULL;
4559 }
4560 assert(PyLong_Check(newobj));
4561 Py_SIZE(newobj) = Py_SIZE(long_obj);
4562 for (i = 0; i < n; i++) {
4563 newobj->ob_digit[i] =
4564 ((PyLongObject *)long_obj)->ob_digit[i];
4565 }
4566 Py_DECREF(long_obj);
4567 return (PyObject *)newobj;
4568 }
4569
4570 return long_obj;
4571}
4572
Mark Dickinson078c2532010-01-30 18:06:17 +00004573PyDoc_STRVAR(long_from_bytes_doc,
4574"int.from_bytes(bytes, byteorder, *, signed=False) -> int\n\
4575\n\
4576Return the integer represented by the given array of bytes.\n\
4577\n\
4578The bytes argument must either support the buffer protocol or be an\n\
4579iterable object producing bytes. Bytes and bytearray are examples of\n\
4580built-in objects that support the buffer protocol.\n\
4581\n\
4582The byteorder argument determines the byte order used to represent the\n\
4583integer. If byteorder is 'big', the most significant byte is at the\n\
4584beginning of the byte array. If byteorder is 'little', the most\n\
4585significant byte is at the end of the byte array. To request the native\n\
4586byte order of the host system, use `sys.byteorder' as the byte order value.\n\
4587\n\
4588The signed keyword-only argument indicates whether two's complement is\n\
4589used to represent the integer.");
4590
Guido van Rossum5d9113d2003-01-29 17:58:45 +00004591static PyMethodDef long_methods[] = {
Guido van Rossumb43daf72007-08-01 18:08:08 +00004592 {"conjugate", (PyCFunction)long_long, METH_NOARGS,
4593 "Returns self, the complex conjugate of any int."},
Mark Dickinson54bc1ec2008-12-17 16:19:07 +00004594 {"bit_length", (PyCFunction)long_bit_length, METH_NOARGS,
4595 long_bit_length_doc},
Christian Heimes53876d92008-04-19 00:31:39 +00004596#if 0
4597 {"is_finite", (PyCFunction)long_is_finite, METH_NOARGS,
4598 "Returns always True."},
4599#endif
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004600 {"to_bytes", (PyCFunction)long_to_bytes,
4601 METH_VARARGS|METH_KEYWORDS, long_to_bytes_doc},
4602 {"from_bytes", (PyCFunction)long_from_bytes,
4603 METH_VARARGS|METH_KEYWORDS|METH_CLASS, long_from_bytes_doc},
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004604 {"__trunc__", (PyCFunction)long_long, METH_NOARGS,
4605 "Truncating an Integral returns itself."},
4606 {"__floor__", (PyCFunction)long_long, METH_NOARGS,
4607 "Flooring an Integral returns itself."},
4608 {"__ceil__", (PyCFunction)long_long, METH_NOARGS,
4609 "Ceiling of an Integral returns itself."},
4610 {"__round__", (PyCFunction)long_round, METH_VARARGS,
Mark Dickinson1124e712009-01-28 21:25:58 +00004611 "Rounding an Integral returns itself.\n"
4612 "Rounding with an ndigits argument also returns an integer."},
Guido van Rossum5d9113d2003-01-29 17:58:45 +00004613 {"__getnewargs__", (PyCFunction)long_getnewargs, METH_NOARGS},
Eric Smith8c663262007-08-25 02:26:07 +00004614 {"__format__", (PyCFunction)long__format__, METH_VARARGS},
Martin v. Löwis00709aa2008-06-04 14:18:43 +00004615 {"__sizeof__", (PyCFunction)long_sizeof, METH_NOARGS,
4616 "Returns size in memory, in bytes"},
Guido van Rossum5d9113d2003-01-29 17:58:45 +00004617 {NULL, NULL} /* sentinel */
4618};
4619
Guido van Rossumb43daf72007-08-01 18:08:08 +00004620static PyGetSetDef long_getset[] = {
Mark Dickinson6bf19002009-05-02 17:57:52 +00004621 {"real",
Guido van Rossumb43daf72007-08-01 18:08:08 +00004622 (getter)long_long, (setter)NULL,
4623 "the real part of a complex number",
4624 NULL},
Mark Dickinson6bf19002009-05-02 17:57:52 +00004625 {"imag",
4626 (getter)long_get0, (setter)NULL,
Guido van Rossumb43daf72007-08-01 18:08:08 +00004627 "the imaginary part of a complex number",
Mark Dickinson6bf19002009-05-02 17:57:52 +00004628 NULL},
4629 {"numerator",
Guido van Rossumb43daf72007-08-01 18:08:08 +00004630 (getter)long_long, (setter)NULL,
4631 "the numerator of a rational number in lowest terms",
4632 NULL},
Mark Dickinson6bf19002009-05-02 17:57:52 +00004633 {"denominator",
4634 (getter)long_get1, (setter)NULL,
Guido van Rossumb43daf72007-08-01 18:08:08 +00004635 "the denominator of a rational number in lowest terms",
Mark Dickinson6bf19002009-05-02 17:57:52 +00004636 NULL},
Guido van Rossumb43daf72007-08-01 18:08:08 +00004637 {NULL} /* Sentinel */
4638};
4639
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00004640PyDoc_STRVAR(long_doc,
Guido van Rossumddefaf32007-01-14 03:31:43 +00004641"int(x[, base]) -> integer\n\
Tim Peters6d6c1a32001-08-02 04:15:00 +00004642\n\
Guido van Rossumddefaf32007-01-14 03:31:43 +00004643Convert a string or number to an integer, if possible. A floating\n\
Tim Peters6d6c1a32001-08-02 04:15:00 +00004644point argument will be truncated towards zero (this does not include a\n\
4645string representation of a floating point number!) When converting a\n\
4646string, use the optional base. It is an error to supply a base when\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00004647converting a non-string.");
Tim Peters6d6c1a32001-08-02 04:15:00 +00004648
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004649static PyNumberMethods long_as_number = {
Tim Peters9f688bf2000-07-07 15:53:28 +00004650 (binaryfunc) long_add, /*nb_add*/
4651 (binaryfunc) long_sub, /*nb_subtract*/
4652 (binaryfunc) long_mul, /*nb_multiply*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004653 long_mod, /*nb_remainder*/
4654 long_divmod, /*nb_divmod*/
4655 long_pow, /*nb_power*/
Tim Peters9f688bf2000-07-07 15:53:28 +00004656 (unaryfunc) long_neg, /*nb_negative*/
Guido van Rossumb43daf72007-08-01 18:08:08 +00004657 (unaryfunc) long_long, /*tp_positive*/
Tim Peters9f688bf2000-07-07 15:53:28 +00004658 (unaryfunc) long_abs, /*tp_absolute*/
Jack Diederich4dafcc42006-11-28 19:15:13 +00004659 (inquiry) long_bool, /*tp_bool*/
Tim Peters9f688bf2000-07-07 15:53:28 +00004660 (unaryfunc) long_invert, /*nb_invert*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004661 long_lshift, /*nb_lshift*/
Tim Peters9f688bf2000-07-07 15:53:28 +00004662 (binaryfunc) long_rshift, /*nb_rshift*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004663 long_and, /*nb_and*/
4664 long_xor, /*nb_xor*/
4665 long_or, /*nb_or*/
Guido van Rossumb43daf72007-08-01 18:08:08 +00004666 long_long, /*nb_int*/
Mark Dickinson8055afd2009-01-17 10:04:45 +00004667 0, /*nb_reserved*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004668 long_float, /*nb_float*/
Guido van Rossum4668b002001-08-08 05:00:18 +00004669 0, /* nb_inplace_add */
4670 0, /* nb_inplace_subtract */
4671 0, /* nb_inplace_multiply */
Guido van Rossum4668b002001-08-08 05:00:18 +00004672 0, /* nb_inplace_remainder */
4673 0, /* nb_inplace_power */
4674 0, /* nb_inplace_lshift */
4675 0, /* nb_inplace_rshift */
4676 0, /* nb_inplace_and */
4677 0, /* nb_inplace_xor */
4678 0, /* nb_inplace_or */
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004679 long_div, /* nb_floor_divide */
Guido van Rossum4668b002001-08-08 05:00:18 +00004680 long_true_divide, /* nb_true_divide */
4681 0, /* nb_inplace_floor_divide */
4682 0, /* nb_inplace_true_divide */
Thomas Wouters00ee7ba2006-08-21 19:07:27 +00004683 long_long, /* nb_index */
Guido van Rossumedcc38a1991-05-05 20:09:44 +00004684};
4685
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004686PyTypeObject PyLong_Type = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00004687 PyVarObject_HEAD_INIT(&PyType_Type, 0)
Guido van Rossumddefaf32007-01-14 03:31:43 +00004688 "int", /* tp_name */
Mark Dickinson5a74bf62009-02-15 11:04:38 +00004689 offsetof(PyLongObject, ob_digit), /* tp_basicsize */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004690 sizeof(digit), /* tp_itemsize */
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004691 long_dealloc, /* tp_dealloc */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004692 0, /* tp_print */
4693 0, /* tp_getattr */
4694 0, /* tp_setattr */
Mark Dickinsone94c6792009-02-02 20:36:42 +00004695 0, /* tp_reserved */
Mark Dickinson2031d132009-09-17 00:17:48 +00004696 long_to_decimal_string, /* tp_repr */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004697 &long_as_number, /* tp_as_number */
4698 0, /* tp_as_sequence */
4699 0, /* tp_as_mapping */
4700 (hashfunc)long_hash, /* tp_hash */
Mark Dickinson5a74bf62009-02-15 11:04:38 +00004701 0, /* tp_call */
Mark Dickinson2031d132009-09-17 00:17:48 +00004702 long_to_decimal_string, /* tp_str */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004703 PyObject_GenericGetAttr, /* tp_getattro */
4704 0, /* tp_setattro */
4705 0, /* tp_as_buffer */
Thomas Wouters27d517b2007-02-25 20:39:11 +00004706 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE |
4707 Py_TPFLAGS_LONG_SUBCLASS, /* tp_flags */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004708 long_doc, /* tp_doc */
4709 0, /* tp_traverse */
4710 0, /* tp_clear */
Guido van Rossum47b9ff62006-08-24 00:41:19 +00004711 long_richcompare, /* tp_richcompare */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004712 0, /* tp_weaklistoffset */
4713 0, /* tp_iter */
4714 0, /* tp_iternext */
Guido van Rossum5d9113d2003-01-29 17:58:45 +00004715 long_methods, /* tp_methods */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004716 0, /* tp_members */
Guido van Rossumb43daf72007-08-01 18:08:08 +00004717 long_getset, /* tp_getset */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004718 0, /* tp_base */
4719 0, /* tp_dict */
4720 0, /* tp_descr_get */
4721 0, /* tp_descr_set */
4722 0, /* tp_dictoffset */
4723 0, /* tp_init */
4724 0, /* tp_alloc */
4725 long_new, /* tp_new */
Mark Dickinson5a74bf62009-02-15 11:04:38 +00004726 PyObject_Del, /* tp_free */
Guido van Rossumedcc38a1991-05-05 20:09:44 +00004727};
Guido van Rossumddefaf32007-01-14 03:31:43 +00004728
Mark Dickinsonbd792642009-03-18 20:06:12 +00004729static PyTypeObject Int_InfoType;
4730
4731PyDoc_STRVAR(int_info__doc__,
4732"sys.int_info\n\
4733\n\
4734A struct sequence that holds information about Python's\n\
4735internal representation of integers. The attributes are read only.");
4736
4737static PyStructSequence_Field int_info_fields[] = {
4738 {"bits_per_digit", "size of a digit in bits"},
4739 {"sizeof_digit", "size in bytes of the C type used to "
4740 "represent a digit"},
4741 {NULL, NULL}
4742};
4743
4744static PyStructSequence_Desc int_info_desc = {
4745 "sys.int_info", /* name */
4746 int_info__doc__, /* doc */
4747 int_info_fields, /* fields */
4748 2 /* number of fields */
4749};
4750
4751PyObject *
4752PyLong_GetInfo(void)
4753{
4754 PyObject* int_info;
4755 int field = 0;
4756 int_info = PyStructSequence_New(&Int_InfoType);
4757 if (int_info == NULL)
4758 return NULL;
Mark Dickinson0bdab682009-04-02 18:41:40 +00004759 PyStructSequence_SET_ITEM(int_info, field++,
4760 PyLong_FromLong(PyLong_SHIFT));
4761 PyStructSequence_SET_ITEM(int_info, field++,
4762 PyLong_FromLong(sizeof(digit)));
Mark Dickinsonbd792642009-03-18 20:06:12 +00004763 if (PyErr_Occurred()) {
4764 Py_CLEAR(int_info);
4765 return NULL;
4766 }
4767 return int_info;
4768}
4769
Guido van Rossumddefaf32007-01-14 03:31:43 +00004770int
4771_PyLong_Init(void)
4772{
4773#if NSMALLNEGINTS + NSMALLPOSINTS > 0
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004774 int ival, size;
Guido van Rossumddefaf32007-01-14 03:31:43 +00004775 PyLongObject *v = small_ints;
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004776
4777 for (ival = -NSMALLNEGINTS; ival < NSMALLPOSINTS; ival++, v++) {
4778 size = (ival < 0) ? -1 : ((ival == 0) ? 0 : 1);
4779 if (Py_TYPE(v) == &PyLong_Type) {
4780 /* The element is already initialized, most likely
4781 * the Python interpreter was initialized before.
4782 */
Christian Heimes48aa4b12008-02-01 16:56:30 +00004783 Py_ssize_t refcnt;
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004784 PyObject* op = (PyObject*)v;
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004785
Christian Heimes48aa4b12008-02-01 16:56:30 +00004786 refcnt = Py_REFCNT(op) < 0 ? 0 : Py_REFCNT(op);
4787 _Py_NewReference(op);
4788 /* _Py_NewReference sets the ref count to 1 but
4789 * the ref count might be larger. Set the refcnt
4790 * to the original refcnt + 1 */
4791 Py_REFCNT(op) = refcnt + 1;
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004792 assert(Py_SIZE(op) == size);
4793 assert(v->ob_digit[0] == abs(ival));
4794 }
4795 else {
4796 PyObject_INIT(v, &PyLong_Type);
4797 }
4798 Py_SIZE(v) = size;
4799 v->ob_digit[0] = abs(ival);
Guido van Rossumddefaf32007-01-14 03:31:43 +00004800 }
4801#endif
Mark Dickinsonbd792642009-03-18 20:06:12 +00004802 /* initialize int_info */
4803 if (Int_InfoType.tp_name == 0)
4804 PyStructSequence_InitType(&Int_InfoType, &int_info_desc);
4805
Guido van Rossumddefaf32007-01-14 03:31:43 +00004806 return 1;
4807}
4808
4809void
4810PyLong_Fini(void)
4811{
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004812 /* Integers are currently statically allocated. Py_DECREF is not
4813 needed, but Python must forget about the reference or multiple
4814 reinitializations will fail. */
Guido van Rossumddefaf32007-01-14 03:31:43 +00004815#if NSMALLNEGINTS + NSMALLPOSINTS > 0
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004816 int i;
4817 PyLongObject *v = small_ints;
4818 for (i = 0; i < NSMALLNEGINTS + NSMALLPOSINTS; i++, v++) {
4819 _Py_DEC_REFTOTAL;
4820 _Py_ForgetReference((PyObject*)v);
4821 }
Guido van Rossumddefaf32007-01-14 03:31:43 +00004822#endif
4823}