blob: 2229aed2f313b58da2a98f90ce89c2a8142793ac [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)
Stefan Krah0091e5e2010-04-07 08:49:55 +00001114 return PyLong_FromLong((long)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,
Stefan Krah0091e5e2010-04-07 08:49:55 +00002408 (int)shift_bits);
Mark Dickinson6ecd9e52010-01-02 15:33:56 +00002409 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,
Stefan Krah0091e5e2010-04-07 08:49:55 +00002416 a_size - shift_digits, (int)shift_bits);
Mark Dickinson6ecd9e52010-01-02 15:33:56 +00002417 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 }
Mark Dickinson49a519c2010-04-06 19:02:54 +00002431 assert(1 <= x_size && x_size <= (Py_ssize_t)(sizeof(x_digits)/sizeof(digit)));
Mark Dickinson6ecd9e52010-01-02 15:33:56 +00002432
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 }
Stefan Krah0091e5e2010-04-07 08:49:55 +00002478 return ldexp(x, (int)exponent);
Mark Dickinson6ecd9e52010-01-02 15:33:56 +00002479}
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)) {
Mark Dickinsone97ecba2010-05-08 08:03:09 +00002495 sign = Py_SIZE(a) - Py_SIZE(b);
Guido van Rossumc6913e71991-11-19 20:26:46 +00002496 }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002497 else {
Christian Heimes90aa7642007-12-19 02:45:37 +00002498 Py_ssize_t i = ABS(Py_SIZE(a));
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002499 while (--i >= 0 && a->ob_digit[i] == b->ob_digit[i])
2500 ;
2501 if (i < 0)
2502 sign = 0;
Guido van Rossum0b0db8e1993-01-21 16:07:51 +00002503 else {
Mark Dickinsone4416742009-02-15 15:14:57 +00002504 sign = (sdigit)a->ob_digit[i] - (sdigit)b->ob_digit[i];
Christian Heimes90aa7642007-12-19 02:45:37 +00002505 if (Py_SIZE(a) < 0)
Guido van Rossum0b0db8e1993-01-21 16:07:51 +00002506 sign = -sign;
2507 }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002508 }
Guido van Rossumc6913e71991-11-19 20:26:46 +00002509 return sign < 0 ? -1 : sign > 0 ? 1 : 0;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002510}
2511
Antoine Pitrou51f3ef92008-12-20 13:14:23 +00002512#define TEST_COND(cond) \
2513 ((cond) ? Py_True : Py_False)
2514
Guido van Rossum47b9ff62006-08-24 00:41:19 +00002515static PyObject *
2516long_richcompare(PyObject *self, PyObject *other, int op)
2517{
Antoine Pitrou51f3ef92008-12-20 13:14:23 +00002518 int result;
2519 PyObject *v;
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002520 CHECK_BINOP(self, other);
Antoine Pitrou51f3ef92008-12-20 13:14:23 +00002521 if (self == other)
2522 result = 0;
2523 else
2524 result = long_compare((PyLongObject*)self, (PyLongObject*)other);
2525 /* Convert the return value to a Boolean */
2526 switch (op) {
2527 case Py_EQ:
2528 v = TEST_COND(result == 0);
2529 break;
2530 case Py_NE:
2531 v = TEST_COND(result != 0);
2532 break;
2533 case Py_LE:
2534 v = TEST_COND(result <= 0);
2535 break;
2536 case Py_GE:
2537 v = TEST_COND(result >= 0);
2538 break;
2539 case Py_LT:
2540 v = TEST_COND(result == -1);
2541 break;
2542 case Py_GT:
2543 v = TEST_COND(result == 1);
2544 break;
2545 default:
2546 PyErr_BadArgument();
2547 return NULL;
2548 }
2549 Py_INCREF(v);
2550 return v;
Guido van Rossum47b9ff62006-08-24 00:41:19 +00002551}
2552
Guido van Rossum9bfef441993-03-29 10:43:31 +00002553static long
Tim Peters9f688bf2000-07-07 15:53:28 +00002554long_hash(PyLongObject *v)
Guido van Rossum9bfef441993-03-29 10:43:31 +00002555{
Mark Dickinsona5cafdf2009-01-26 21:56:07 +00002556 unsigned long x;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002557 Py_ssize_t i;
2558 int sign;
Guido van Rossum9bfef441993-03-29 10:43:31 +00002559
Christian Heimes90aa7642007-12-19 02:45:37 +00002560 i = Py_SIZE(v);
Guido van Rossumddefaf32007-01-14 03:31:43 +00002561 switch(i) {
Mark Dickinson0d4785b2009-02-15 17:27:41 +00002562 case -1: return v->ob_digit[0]==1 ? -2 : -(sdigit)v->ob_digit[0];
Guido van Rossumddefaf32007-01-14 03:31:43 +00002563 case 0: return 0;
2564 case 1: return v->ob_digit[0];
2565 }
Guido van Rossum9bfef441993-03-29 10:43:31 +00002566 sign = 1;
2567 x = 0;
2568 if (i < 0) {
2569 sign = -1;
2570 i = -(i);
2571 }
Mark Dickinsona5cafdf2009-01-26 21:56:07 +00002572 /* The following loop produces a C unsigned long x such that x is
2573 congruent to the absolute value of v modulo ULONG_MAX. The
Thomas Woutersce272b62007-09-19 21:19:28 +00002574 resulting x is nonzero if and only if v is. */
Guido van Rossum9bfef441993-03-29 10:43:31 +00002575 while (--i >= 0) {
Neal Norwitzd5a65a72003-02-23 23:11:41 +00002576 /* Force a native long #-bits (32 or 64) circular shift */
Mark Dickinson5a74bf62009-02-15 11:04:38 +00002577 x = (x >> (8*SIZEOF_LONG-PyLong_SHIFT)) | (x << PyLong_SHIFT);
Guido van Rossum9bfef441993-03-29 10:43:31 +00002578 x += v->ob_digit[i];
Mark Dickinsona5cafdf2009-01-26 21:56:07 +00002579 /* If the addition above overflowed we compensate by
2580 incrementing. This preserves the value modulo
2581 ULONG_MAX. */
2582 if (x < v->ob_digit[i])
Thomas Woutersce272b62007-09-19 21:19:28 +00002583 x++;
Guido van Rossum9bfef441993-03-29 10:43:31 +00002584 }
2585 x = x * sign;
Mark Dickinson5a74bf62009-02-15 11:04:38 +00002586 if (x == (unsigned long)-1)
2587 x = (unsigned long)-2;
2588 return (long)x;
Guido van Rossum9bfef441993-03-29 10:43:31 +00002589}
2590
2591
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002592/* Add the absolute values of two long integers. */
2593
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002594static PyLongObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00002595x_add(PyLongObject *a, PyLongObject *b)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002596{
Christian Heimes90aa7642007-12-19 02:45:37 +00002597 Py_ssize_t size_a = ABS(Py_SIZE(a)), size_b = ABS(Py_SIZE(b));
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002598 PyLongObject *z;
Mark Dickinson17e55872009-01-24 15:56:57 +00002599 Py_ssize_t i;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002600 digit carry = 0;
Tim Peters69c2de32001-09-11 22:31:33 +00002601
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002602 /* Ensure a is the larger of the two: */
2603 if (size_a < size_b) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002604 { PyLongObject *temp = a; a = b; b = temp; }
Martin v. Löwis18e16552006-02-15 17:27:45 +00002605 { Py_ssize_t size_temp = size_a;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002606 size_a = size_b;
2607 size_b = size_temp; }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002608 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002609 z = _PyLong_New(size_a+1);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002610 if (z == NULL)
2611 return NULL;
2612 for (i = 0; i < size_b; ++i) {
2613 carry += a->ob_digit[i] + b->ob_digit[i];
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002614 z->ob_digit[i] = carry & PyLong_MASK;
2615 carry >>= PyLong_SHIFT;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002616 }
2617 for (; i < size_a; ++i) {
2618 carry += a->ob_digit[i];
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002619 z->ob_digit[i] = carry & PyLong_MASK;
2620 carry >>= PyLong_SHIFT;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002621 }
2622 z->ob_digit[i] = carry;
2623 return long_normalize(z);
2624}
2625
2626/* Subtract the absolute values of two integers. */
2627
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002628static PyLongObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00002629x_sub(PyLongObject *a, PyLongObject *b)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002630{
Christian Heimes90aa7642007-12-19 02:45:37 +00002631 Py_ssize_t size_a = ABS(Py_SIZE(a)), size_b = ABS(Py_SIZE(b));
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002632 PyLongObject *z;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002633 Py_ssize_t i;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002634 int sign = 1;
2635 digit borrow = 0;
Tim Peters69c2de32001-09-11 22:31:33 +00002636
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002637 /* Ensure a is the larger of the two: */
2638 if (size_a < size_b) {
2639 sign = -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002640 { PyLongObject *temp = a; a = b; b = temp; }
Martin v. Löwis18e16552006-02-15 17:27:45 +00002641 { Py_ssize_t size_temp = size_a;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002642 size_a = size_b;
2643 size_b = size_temp; }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002644 }
2645 else if (size_a == size_b) {
2646 /* Find highest digit where a and b differ: */
2647 i = size_a;
2648 while (--i >= 0 && a->ob_digit[i] == b->ob_digit[i])
2649 ;
2650 if (i < 0)
Facundo Batista6e6f59b2008-07-24 18:57:11 +00002651 return (PyLongObject *)PyLong_FromLong(0);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002652 if (a->ob_digit[i] < b->ob_digit[i]) {
2653 sign = -1;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002654 { PyLongObject *temp = a; a = b; b = temp; }
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002655 }
2656 size_a = size_b = i+1;
2657 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002658 z = _PyLong_New(size_a);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002659 if (z == NULL)
2660 return NULL;
2661 for (i = 0; i < size_b; ++i) {
2662 /* The following assumes unsigned arithmetic
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002663 works module 2**N for some N>PyLong_SHIFT. */
Guido van Rossumeb1fafc1994-08-29 12:47:19 +00002664 borrow = a->ob_digit[i] - b->ob_digit[i] - borrow;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002665 z->ob_digit[i] = borrow & PyLong_MASK;
2666 borrow >>= PyLong_SHIFT;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002667 borrow &= 1; /* Keep only one sign bit */
2668 }
2669 for (; i < size_a; ++i) {
2670 borrow = a->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;
Tim Peters43f04a32000-07-08 02:26:47 +00002673 borrow &= 1; /* Keep only one sign bit */
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002674 }
2675 assert(borrow == 0);
Guido van Rossumc6913e71991-11-19 20:26:46 +00002676 if (sign < 0)
Guido van Rossumddefaf32007-01-14 03:31:43 +00002677 NEGATE(z);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002678 return long_normalize(z);
2679}
2680
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002681static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002682long_add(PyLongObject *a, PyLongObject *b)
Guido van Rossum4c260ff1992-01-14 18:36:43 +00002683{
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002684 PyLongObject *z;
Tim Peters69c2de32001-09-11 22:31:33 +00002685
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002686 CHECK_BINOP(a, b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00002687
Christian Heimes90aa7642007-12-19 02:45:37 +00002688 if (ABS(Py_SIZE(a)) <= 1 && ABS(Py_SIZE(b)) <= 1) {
Christian Heimes217cfd12007-12-02 14:31:20 +00002689 PyObject *result = PyLong_FromLong(MEDIUM_VALUE(a) +
Martin v. Löwis14b6d922007-02-06 21:05:30 +00002690 MEDIUM_VALUE(b));
Martin v. Löwis14b6d922007-02-06 21:05:30 +00002691 return result;
2692 }
Christian Heimes90aa7642007-12-19 02:45:37 +00002693 if (Py_SIZE(a) < 0) {
2694 if (Py_SIZE(b) < 0) {
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002695 z = x_add(a, b);
Christian Heimes90aa7642007-12-19 02:45:37 +00002696 if (z != NULL && Py_SIZE(z) != 0)
2697 Py_SIZE(z) = -(Py_SIZE(z));
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002698 }
2699 else
2700 z = x_sub(b, a);
2701 }
2702 else {
Christian Heimes90aa7642007-12-19 02:45:37 +00002703 if (Py_SIZE(b) < 0)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002704 z = x_sub(a, b);
2705 else
2706 z = x_add(a, b);
2707 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002708 return (PyObject *)z;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002709}
2710
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002711static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002712long_sub(PyLongObject *a, PyLongObject *b)
Guido van Rossum4c260ff1992-01-14 18:36:43 +00002713{
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002714 PyLongObject *z;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002715
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00002716 CHECK_BINOP(a, b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00002717
Christian Heimes90aa7642007-12-19 02:45:37 +00002718 if (ABS(Py_SIZE(a)) <= 1 && ABS(Py_SIZE(b)) <= 1) {
Martin v. Löwis14b6d922007-02-06 21:05:30 +00002719 PyObject* r;
2720 r = PyLong_FromLong(MEDIUM_VALUE(a)-MEDIUM_VALUE(b));
Martin v. Löwis14b6d922007-02-06 21:05:30 +00002721 return r;
2722 }
Christian Heimes90aa7642007-12-19 02:45:37 +00002723 if (Py_SIZE(a) < 0) {
2724 if (Py_SIZE(b) < 0)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002725 z = x_sub(a, b);
2726 else
2727 z = x_add(a, b);
Christian Heimes90aa7642007-12-19 02:45:37 +00002728 if (z != NULL && Py_SIZE(z) != 0)
2729 Py_SIZE(z) = -(Py_SIZE(z));
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002730 }
2731 else {
Christian Heimes90aa7642007-12-19 02:45:37 +00002732 if (Py_SIZE(b) < 0)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002733 z = x_add(a, b);
2734 else
2735 z = x_sub(a, b);
2736 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00002737 return (PyObject *)z;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002738}
2739
Tim Peters5af4e6c2002-08-12 02:31:19 +00002740/* Grade school multiplication, ignoring the signs.
2741 * Returns the absolute value of the product, or NULL if error.
2742 */
2743static PyLongObject *
2744x_mul(PyLongObject *a, PyLongObject *b)
Neil Schemenauerba872e22001-01-04 01:46:03 +00002745{
Tim Peters5af4e6c2002-08-12 02:31:19 +00002746 PyLongObject *z;
Christian Heimes90aa7642007-12-19 02:45:37 +00002747 Py_ssize_t size_a = ABS(Py_SIZE(a));
2748 Py_ssize_t size_b = ABS(Py_SIZE(b));
Martin v. Löwis18e16552006-02-15 17:27:45 +00002749 Py_ssize_t i;
Neil Schemenauerba872e22001-01-04 01:46:03 +00002750
Tim Peters5af4e6c2002-08-12 02:31:19 +00002751 z = _PyLong_New(size_a + size_b);
2752 if (z == NULL)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002753 return NULL;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002754
Christian Heimes90aa7642007-12-19 02:45:37 +00002755 memset(z->ob_digit, 0, Py_SIZE(z) * sizeof(digit));
Tim Peters0973b992004-08-29 22:16:50 +00002756 if (a == b) {
2757 /* Efficient squaring per HAC, Algorithm 14.16:
2758 * http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf
2759 * Gives slightly less than a 2x speedup when a == b,
2760 * via exploiting that each entry in the multiplication
2761 * pyramid appears twice (except for the size_a squares).
2762 */
2763 for (i = 0; i < size_a; ++i) {
2764 twodigits carry;
2765 twodigits f = a->ob_digit[i];
2766 digit *pz = z->ob_digit + (i << 1);
2767 digit *pa = a->ob_digit + i + 1;
2768 digit *paend = a->ob_digit + size_a;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002769
Tim Peters0973b992004-08-29 22:16:50 +00002770 SIGCHECK({
2771 Py_DECREF(z);
2772 return NULL;
2773 })
2774
2775 carry = *pz + f * f;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002776 *pz++ = (digit)(carry & PyLong_MASK);
2777 carry >>= PyLong_SHIFT;
2778 assert(carry <= PyLong_MASK);
Tim Peters0973b992004-08-29 22:16:50 +00002779
2780 /* Now f is added in twice in each column of the
2781 * pyramid it appears. Same as adding f<<1 once.
2782 */
2783 f <<= 1;
2784 while (pa < paend) {
2785 carry += *pz + *pa++ * f;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002786 *pz++ = (digit)(carry & PyLong_MASK);
2787 carry >>= PyLong_SHIFT;
2788 assert(carry <= (PyLong_MASK << 1));
Tim Peters0973b992004-08-29 22:16:50 +00002789 }
2790 if (carry) {
2791 carry += *pz;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002792 *pz++ = (digit)(carry & PyLong_MASK);
2793 carry >>= PyLong_SHIFT;
Tim Peters0973b992004-08-29 22:16:50 +00002794 }
2795 if (carry)
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002796 *pz += (digit)(carry & PyLong_MASK);
2797 assert((carry >> PyLong_SHIFT) == 0);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002798 }
Tim Peters0973b992004-08-29 22:16:50 +00002799 }
2800 else { /* a is not the same as b -- gradeschool long mult */
2801 for (i = 0; i < size_a; ++i) {
2802 twodigits carry = 0;
2803 twodigits f = a->ob_digit[i];
2804 digit *pz = z->ob_digit + i;
2805 digit *pb = b->ob_digit;
2806 digit *pbend = b->ob_digit + size_b;
2807
2808 SIGCHECK({
2809 Py_DECREF(z);
2810 return NULL;
2811 })
2812
2813 while (pb < pbend) {
2814 carry += *pz + *pb++ * f;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002815 *pz++ = (digit)(carry & PyLong_MASK);
2816 carry >>= PyLong_SHIFT;
2817 assert(carry <= PyLong_MASK);
Tim Peters0973b992004-08-29 22:16:50 +00002818 }
2819 if (carry)
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00002820 *pz += (digit)(carry & PyLong_MASK);
2821 assert((carry >> PyLong_SHIFT) == 0);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00002822 }
2823 }
Tim Peters44121a62002-08-12 06:17:58 +00002824 return long_normalize(z);
Tim Peters5af4e6c2002-08-12 02:31:19 +00002825}
2826
2827/* A helper for Karatsuba multiplication (k_mul).
2828 Takes a long "n" and an integer "size" representing the place to
2829 split, and sets low and high such that abs(n) == (high << size) + low,
2830 viewing the shift as being by digits. The sign bit is ignored, and
2831 the return values are >= 0.
2832 Returns 0 on success, -1 on failure.
2833*/
2834static int
Martin v. Löwis18e16552006-02-15 17:27:45 +00002835kmul_split(PyLongObject *n, Py_ssize_t size, PyLongObject **high, PyLongObject **low)
Tim Peters5af4e6c2002-08-12 02:31:19 +00002836{
2837 PyLongObject *hi, *lo;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002838 Py_ssize_t size_lo, size_hi;
Christian Heimes90aa7642007-12-19 02:45:37 +00002839 const Py_ssize_t size_n = ABS(Py_SIZE(n));
Tim Peters5af4e6c2002-08-12 02:31:19 +00002840
2841 size_lo = MIN(size_n, size);
2842 size_hi = size_n - size_lo;
2843
2844 if ((hi = _PyLong_New(size_hi)) == NULL)
2845 return -1;
2846 if ((lo = _PyLong_New(size_lo)) == NULL) {
2847 Py_DECREF(hi);
2848 return -1;
2849 }
2850
2851 memcpy(lo->ob_digit, n->ob_digit, size_lo * sizeof(digit));
2852 memcpy(hi->ob_digit, n->ob_digit + size_lo, size_hi * sizeof(digit));
2853
2854 *high = long_normalize(hi);
2855 *low = long_normalize(lo);
2856 return 0;
2857}
2858
Tim Peters60004642002-08-12 22:01:34 +00002859static PyLongObject *k_lopsided_mul(PyLongObject *a, PyLongObject *b);
2860
Tim Peters5af4e6c2002-08-12 02:31:19 +00002861/* Karatsuba multiplication. Ignores the input signs, and returns the
2862 * absolute value of the product (or NULL if error).
2863 * See Knuth Vol. 2 Chapter 4.3.3 (Pp. 294-295).
2864 */
2865static PyLongObject *
2866k_mul(PyLongObject *a, PyLongObject *b)
2867{
Christian Heimes90aa7642007-12-19 02:45:37 +00002868 Py_ssize_t asize = ABS(Py_SIZE(a));
2869 Py_ssize_t bsize = ABS(Py_SIZE(b));
Tim Peters5af4e6c2002-08-12 02:31:19 +00002870 PyLongObject *ah = NULL;
2871 PyLongObject *al = NULL;
2872 PyLongObject *bh = NULL;
2873 PyLongObject *bl = NULL;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002874 PyLongObject *ret = NULL;
Tim Peters738eda72002-08-12 15:08:20 +00002875 PyLongObject *t1, *t2, *t3;
Martin v. Löwis18e16552006-02-15 17:27:45 +00002876 Py_ssize_t shift; /* the number of digits we split off */
2877 Py_ssize_t i;
Tim Peters738eda72002-08-12 15:08:20 +00002878
Tim Peters5af4e6c2002-08-12 02:31:19 +00002879 /* (ah*X+al)(bh*X+bl) = ah*bh*X*X + (ah*bl + al*bh)*X + al*bl
2880 * Let k = (ah+al)*(bh+bl) = ah*bl + al*bh + ah*bh + al*bl
2881 * Then the original product is
Tim Peters18c15b92002-08-12 02:43:58 +00002882 * ah*bh*X*X + (k - ah*bh - al*bl)*X + al*bl
Tim Peters5af4e6c2002-08-12 02:31:19 +00002883 * By picking X to be a power of 2, "*X" is just shifting, and it's
2884 * been reduced to 3 multiplies on numbers half the size.
2885 */
2886
Tim Petersfc07e562002-08-12 02:54:10 +00002887 /* We want to split based on the larger number; fiddle so that b
Tim Peters5af4e6c2002-08-12 02:31:19 +00002888 * is largest.
2889 */
Tim Peters738eda72002-08-12 15:08:20 +00002890 if (asize > bsize) {
Tim Peters5af4e6c2002-08-12 02:31:19 +00002891 t1 = a;
2892 a = b;
2893 b = t1;
Tim Peters738eda72002-08-12 15:08:20 +00002894
2895 i = asize;
2896 asize = bsize;
2897 bsize = i;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002898 }
2899
2900 /* Use gradeschool math when either number is too small. */
Tim Peters0973b992004-08-29 22:16:50 +00002901 i = a == b ? KARATSUBA_SQUARE_CUTOFF : KARATSUBA_CUTOFF;
2902 if (asize <= i) {
Tim Peters738eda72002-08-12 15:08:20 +00002903 if (asize == 0)
Facundo Batista6e6f59b2008-07-24 18:57:11 +00002904 return (PyLongObject *)PyLong_FromLong(0);
Tim Peters44121a62002-08-12 06:17:58 +00002905 else
2906 return x_mul(a, b);
2907 }
Tim Peters5af4e6c2002-08-12 02:31:19 +00002908
Tim Peters60004642002-08-12 22:01:34 +00002909 /* If a is small compared to b, splitting on b gives a degenerate
2910 * case with ah==0, and Karatsuba may be (even much) less efficient
2911 * than "grade school" then. However, we can still win, by viewing
2912 * b as a string of "big digits", each of width a->ob_size. That
2913 * leads to a sequence of balanced calls to k_mul.
2914 */
2915 if (2 * asize <= bsize)
2916 return k_lopsided_mul(a, b);
2917
Tim Petersd6974a52002-08-13 20:37:51 +00002918 /* Split a & b into hi & lo pieces. */
Tim Peters738eda72002-08-12 15:08:20 +00002919 shift = bsize >> 1;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002920 if (kmul_split(a, shift, &ah, &al) < 0) goto fail;
Christian Heimes90aa7642007-12-19 02:45:37 +00002921 assert(Py_SIZE(ah) > 0); /* the split isn't degenerate */
Tim Petersd6974a52002-08-13 20:37:51 +00002922
Tim Peters0973b992004-08-29 22:16:50 +00002923 if (a == b) {
2924 bh = ah;
2925 bl = al;
2926 Py_INCREF(bh);
2927 Py_INCREF(bl);
2928 }
2929 else if (kmul_split(b, shift, &bh, &bl) < 0) goto fail;
Tim Peters5af4e6c2002-08-12 02:31:19 +00002930
Tim Petersd64c1de2002-08-12 17:36:03 +00002931 /* The plan:
2932 * 1. Allocate result space (asize + bsize digits: that's always
2933 * enough).
2934 * 2. Compute ah*bh, and copy into result at 2*shift.
2935 * 3. Compute al*bl, and copy into result at 0. Note that this
2936 * can't overlap with #2.
2937 * 4. Subtract al*bl from the result, starting at shift. This may
2938 * underflow (borrow out of the high digit), but we don't care:
2939 * we're effectively doing unsigned arithmetic mod
2940 * BASE**(sizea + sizeb), and so long as the *final* result fits,
2941 * borrows and carries out of the high digit can be ignored.
2942 * 5. Subtract ah*bh from the result, starting at shift.
2943 * 6. Compute (ah+al)*(bh+bl), and add it into the result starting
2944 * at shift.
2945 */
2946
2947 /* 1. Allocate result space. */
Tim Peters70b041b2002-08-12 19:38:01 +00002948 ret = _PyLong_New(asize + bsize);
Tim Peters5af4e6c2002-08-12 02:31:19 +00002949 if (ret == NULL) goto fail;
2950#ifdef Py_DEBUG
2951 /* Fill with trash, to catch reference to uninitialized digits. */
Christian Heimes90aa7642007-12-19 02:45:37 +00002952 memset(ret->ob_digit, 0xDF, Py_SIZE(ret) * sizeof(digit));
Tim Peters5af4e6c2002-08-12 02:31:19 +00002953#endif
Tim Peters44121a62002-08-12 06:17:58 +00002954
Tim Petersd64c1de2002-08-12 17:36:03 +00002955 /* 2. t1 <- ah*bh, and copy into high digits of result. */
Tim Peters738eda72002-08-12 15:08:20 +00002956 if ((t1 = k_mul(ah, bh)) == NULL) goto fail;
Christian Heimes90aa7642007-12-19 02:45:37 +00002957 assert(Py_SIZE(t1) >= 0);
2958 assert(2*shift + Py_SIZE(t1) <= Py_SIZE(ret));
Tim Peters738eda72002-08-12 15:08:20 +00002959 memcpy(ret->ob_digit + 2*shift, t1->ob_digit,
Christian Heimes90aa7642007-12-19 02:45:37 +00002960 Py_SIZE(t1) * sizeof(digit));
Tim Peters738eda72002-08-12 15:08:20 +00002961
2962 /* Zero-out the digits higher than the ah*bh copy. */
Christian Heimes90aa7642007-12-19 02:45:37 +00002963 i = Py_SIZE(ret) - 2*shift - Py_SIZE(t1);
Tim Peters44121a62002-08-12 06:17:58 +00002964 if (i)
Christian Heimes90aa7642007-12-19 02:45:37 +00002965 memset(ret->ob_digit + 2*shift + Py_SIZE(t1), 0,
Tim Peters44121a62002-08-12 06:17:58 +00002966 i * sizeof(digit));
Tim Peters5af4e6c2002-08-12 02:31:19 +00002967
Tim Petersd64c1de2002-08-12 17:36:03 +00002968 /* 3. t2 <- al*bl, and copy into the low digits. */
Tim Peters738eda72002-08-12 15:08:20 +00002969 if ((t2 = k_mul(al, bl)) == NULL) {
2970 Py_DECREF(t1);
2971 goto fail;
2972 }
Christian Heimes90aa7642007-12-19 02:45:37 +00002973 assert(Py_SIZE(t2) >= 0);
2974 assert(Py_SIZE(t2) <= 2*shift); /* no overlap with high digits */
2975 memcpy(ret->ob_digit, t2->ob_digit, Py_SIZE(t2) * sizeof(digit));
Tim Peters5af4e6c2002-08-12 02:31:19 +00002976
2977 /* Zero out remaining digits. */
Christian Heimes90aa7642007-12-19 02:45:37 +00002978 i = 2*shift - Py_SIZE(t2); /* number of uninitialized digits */
Tim Peters5af4e6c2002-08-12 02:31:19 +00002979 if (i)
Christian Heimes90aa7642007-12-19 02:45:37 +00002980 memset(ret->ob_digit + Py_SIZE(t2), 0, i * sizeof(digit));
Tim Peters5af4e6c2002-08-12 02:31:19 +00002981
Tim Petersd64c1de2002-08-12 17:36:03 +00002982 /* 4 & 5. Subtract ah*bh (t1) and al*bl (t2). We do al*bl first
2983 * because it's fresher in cache.
2984 */
Christian Heimes90aa7642007-12-19 02:45:37 +00002985 i = Py_SIZE(ret) - shift; /* # digits after shift */
2986 (void)v_isub(ret->ob_digit + shift, i, t2->ob_digit, Py_SIZE(t2));
Tim Peters738eda72002-08-12 15:08:20 +00002987 Py_DECREF(t2);
2988
Christian Heimes90aa7642007-12-19 02:45:37 +00002989 (void)v_isub(ret->ob_digit + shift, i, t1->ob_digit, Py_SIZE(t1));
Tim Peters738eda72002-08-12 15:08:20 +00002990 Py_DECREF(t1);
2991
Tim Petersd64c1de2002-08-12 17:36:03 +00002992 /* 6. t3 <- (ah+al)(bh+bl), and add into result. */
Tim Peters5af4e6c2002-08-12 02:31:19 +00002993 if ((t1 = x_add(ah, al)) == NULL) goto fail;
2994 Py_DECREF(ah);
2995 Py_DECREF(al);
2996 ah = al = NULL;
2997
Tim Peters0973b992004-08-29 22:16:50 +00002998 if (a == b) {
2999 t2 = t1;
3000 Py_INCREF(t2);
3001 }
3002 else if ((t2 = x_add(bh, bl)) == NULL) {
Tim Peters5af4e6c2002-08-12 02:31:19 +00003003 Py_DECREF(t1);
3004 goto fail;
3005 }
3006 Py_DECREF(bh);
3007 Py_DECREF(bl);
3008 bh = bl = NULL;
3009
Tim Peters738eda72002-08-12 15:08:20 +00003010 t3 = k_mul(t1, t2);
Tim Peters5af4e6c2002-08-12 02:31:19 +00003011 Py_DECREF(t1);
3012 Py_DECREF(t2);
Tim Peters738eda72002-08-12 15:08:20 +00003013 if (t3 == NULL) goto fail;
Christian Heimes90aa7642007-12-19 02:45:37 +00003014 assert(Py_SIZE(t3) >= 0);
Tim Peters5af4e6c2002-08-12 02:31:19 +00003015
Tim Petersd6974a52002-08-13 20:37:51 +00003016 /* Add t3. It's not obvious why we can't run out of room here.
3017 * See the (*) comment after this function.
Tim Petersd8b21732002-08-12 19:30:26 +00003018 */
Christian Heimes90aa7642007-12-19 02:45:37 +00003019 (void)v_iadd(ret->ob_digit + shift, i, t3->ob_digit, Py_SIZE(t3));
Tim Peters738eda72002-08-12 15:08:20 +00003020 Py_DECREF(t3);
Tim Peters5af4e6c2002-08-12 02:31:19 +00003021
Tim Peters5af4e6c2002-08-12 02:31:19 +00003022 return long_normalize(ret);
3023
3024 fail:
3025 Py_XDECREF(ret);
3026 Py_XDECREF(ah);
3027 Py_XDECREF(al);
3028 Py_XDECREF(bh);
3029 Py_XDECREF(bl);
Tim Peters5af4e6c2002-08-12 02:31:19 +00003030 return NULL;
3031}
3032
Tim Petersd6974a52002-08-13 20:37:51 +00003033/* (*) Why adding t3 can't "run out of room" above.
3034
Tim Petersab86c2b2002-08-15 20:06:00 +00003035Let f(x) mean the floor of x and c(x) mean the ceiling of x. Some facts
3036to start with:
Tim Petersd6974a52002-08-13 20:37:51 +00003037
Tim Petersab86c2b2002-08-15 20:06:00 +000030381. For any integer i, i = c(i/2) + f(i/2). In particular,
3039 bsize = c(bsize/2) + f(bsize/2).
30402. shift = f(bsize/2)
30413. asize <= bsize
30424. Since we call k_lopsided_mul if asize*2 <= bsize, asize*2 > bsize in this
3043 routine, so asize > bsize/2 >= f(bsize/2) in this routine.
Tim Petersd6974a52002-08-13 20:37:51 +00003044
Tim Petersab86c2b2002-08-15 20:06:00 +00003045We allocated asize + bsize result digits, and add t3 into them at an offset
3046of shift. This leaves asize+bsize-shift allocated digit positions for t3
3047to fit into, = (by #1 and #2) asize + f(bsize/2) + c(bsize/2) - f(bsize/2) =
3048asize + c(bsize/2) available digit positions.
Tim Petersd6974a52002-08-13 20:37:51 +00003049
Tim Petersab86c2b2002-08-15 20:06:00 +00003050bh has c(bsize/2) digits, and bl at most f(size/2) digits. So bh+hl has
3051at most c(bsize/2) digits + 1 bit.
Tim Petersd6974a52002-08-13 20:37:51 +00003052
Tim Petersab86c2b2002-08-15 20:06:00 +00003053If asize == bsize, ah has c(bsize/2) digits, else ah has at most f(bsize/2)
3054digits, and al has at most f(bsize/2) digits in any case. So ah+al has at
3055most (asize == bsize ? c(bsize/2) : f(bsize/2)) digits + 1 bit.
Tim Petersd6974a52002-08-13 20:37:51 +00003056
Tim Petersab86c2b2002-08-15 20:06:00 +00003057The product (ah+al)*(bh+bl) therefore has at most
Tim Petersd6974a52002-08-13 20:37:51 +00003058
Tim Petersab86c2b2002-08-15 20:06:00 +00003059 c(bsize/2) + (asize == bsize ? c(bsize/2) : f(bsize/2)) digits + 2 bits
Tim Petersd6974a52002-08-13 20:37:51 +00003060
Tim Petersab86c2b2002-08-15 20:06:00 +00003061and we have asize + c(bsize/2) available digit positions. We need to show
3062this is always enough. An instance of c(bsize/2) cancels out in both, so
3063the question reduces to whether asize digits is enough to hold
3064(asize == bsize ? c(bsize/2) : f(bsize/2)) digits + 2 bits. If asize < bsize,
3065then we're asking whether asize digits >= f(bsize/2) digits + 2 bits. By #4,
3066asize 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 +00003067digit is enough to hold 2 bits. This is so since PyLong_SHIFT=15 >= 2. If
Tim Petersab86c2b2002-08-15 20:06:00 +00003068asize == bsize, then we're asking whether bsize digits is enough to hold
Tim Peterse417de02002-08-15 20:10:45 +00003069c(bsize/2) digits + 2 bits, or equivalently (by #1) whether f(bsize/2) digits
3070is enough to hold 2 bits. This is so if bsize >= 2, which holds because
3071bsize >= KARATSUBA_CUTOFF >= 2.
Tim Peters8e966ee2002-08-14 16:36:23 +00003072
Tim Peters48d52c02002-08-14 17:07:32 +00003073Note that since there's always enough room for (ah+al)*(bh+bl), and that's
3074clearly >= each of ah*bh and al*bl, there's always enough room to subtract
3075ah*bh and al*bl too.
Tim Petersd6974a52002-08-13 20:37:51 +00003076*/
3077
Tim Peters60004642002-08-12 22:01:34 +00003078/* b has at least twice the digits of a, and a is big enough that Karatsuba
3079 * would pay off *if* the inputs had balanced sizes. View b as a sequence
3080 * of slices, each with a->ob_size digits, and multiply the slices by a,
3081 * one at a time. This gives k_mul balanced inputs to work with, and is
3082 * also cache-friendly (we compute one double-width slice of the result
3083 * at a time, then move on, never bactracking except for the helpful
3084 * single-width slice overlap between successive partial sums).
3085 */
3086static PyLongObject *
3087k_lopsided_mul(PyLongObject *a, PyLongObject *b)
3088{
Christian Heimes90aa7642007-12-19 02:45:37 +00003089 const Py_ssize_t asize = ABS(Py_SIZE(a));
3090 Py_ssize_t bsize = ABS(Py_SIZE(b));
Martin v. Löwis18e16552006-02-15 17:27:45 +00003091 Py_ssize_t nbdone; /* # of b digits already multiplied */
Tim Peters60004642002-08-12 22:01:34 +00003092 PyLongObject *ret;
3093 PyLongObject *bslice = NULL;
3094
3095 assert(asize > KARATSUBA_CUTOFF);
3096 assert(2 * asize <= bsize);
3097
3098 /* Allocate result space, and zero it out. */
3099 ret = _PyLong_New(asize + bsize);
3100 if (ret == NULL)
3101 return NULL;
Christian Heimes90aa7642007-12-19 02:45:37 +00003102 memset(ret->ob_digit, 0, Py_SIZE(ret) * sizeof(digit));
Tim Peters60004642002-08-12 22:01:34 +00003103
3104 /* Successive slices of b are copied into bslice. */
Tim Peters12034032002-08-12 22:10:00 +00003105 bslice = _PyLong_New(asize);
Tim Peters60004642002-08-12 22:01:34 +00003106 if (bslice == NULL)
3107 goto fail;
3108
3109 nbdone = 0;
3110 while (bsize > 0) {
3111 PyLongObject *product;
Martin v. Löwis18e16552006-02-15 17:27:45 +00003112 const Py_ssize_t nbtouse = MIN(bsize, asize);
Tim Peters60004642002-08-12 22:01:34 +00003113
3114 /* Multiply the next slice of b by a. */
3115 memcpy(bslice->ob_digit, b->ob_digit + nbdone,
3116 nbtouse * sizeof(digit));
Christian Heimes90aa7642007-12-19 02:45:37 +00003117 Py_SIZE(bslice) = nbtouse;
Tim Peters60004642002-08-12 22:01:34 +00003118 product = k_mul(a, bslice);
3119 if (product == NULL)
3120 goto fail;
3121
3122 /* Add into result. */
Christian Heimes90aa7642007-12-19 02:45:37 +00003123 (void)v_iadd(ret->ob_digit + nbdone, Py_SIZE(ret) - nbdone,
3124 product->ob_digit, Py_SIZE(product));
Tim Peters60004642002-08-12 22:01:34 +00003125 Py_DECREF(product);
3126
3127 bsize -= nbtouse;
3128 nbdone += nbtouse;
3129 }
3130
3131 Py_DECREF(bslice);
3132 return long_normalize(ret);
3133
3134 fail:
3135 Py_DECREF(ret);
3136 Py_XDECREF(bslice);
3137 return NULL;
3138}
Tim Peters5af4e6c2002-08-12 02:31:19 +00003139
3140static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003141long_mul(PyLongObject *a, PyLongObject *b)
Tim Peters5af4e6c2002-08-12 02:31:19 +00003142{
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003143 PyLongObject *z;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003144
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003145 CHECK_BINOP(a, b);
Tim Peters5af4e6c2002-08-12 02:31:19 +00003146
Mark Dickinsonbd792642009-03-18 20:06:12 +00003147 /* fast path for single-digit multiplication */
Christian Heimes90aa7642007-12-19 02:45:37 +00003148 if (ABS(Py_SIZE(a)) <= 1 && ABS(Py_SIZE(b)) <= 1) {
Mark Dickinsonbd792642009-03-18 20:06:12 +00003149 stwodigits v = (stwodigits)(MEDIUM_VALUE(a)) * MEDIUM_VALUE(b);
3150#ifdef HAVE_LONG_LONG
3151 return PyLong_FromLongLong((PY_LONG_LONG)v);
3152#else
3153 /* if we don't have long long then we're almost certainly
3154 using 15-bit digits, so v will fit in a long. In the
3155 unlikely event that we're using 30-bit digits on a platform
3156 without long long, a large v will just cause us to fall
3157 through to the general multiplication code below. */
3158 if (v >= LONG_MIN && v <= LONG_MAX)
3159 return PyLong_FromLong((long)v);
3160#endif
Martin v. Löwis14b6d922007-02-06 21:05:30 +00003161 }
Guido van Rossumddefaf32007-01-14 03:31:43 +00003162
Tim Petersd64c1de2002-08-12 17:36:03 +00003163 z = k_mul(a, b);
Tim Peters9973d742002-08-15 19:41:06 +00003164 /* Negate if exactly one of the inputs is negative. */
Christian Heimes90aa7642007-12-19 02:45:37 +00003165 if (((Py_SIZE(a) ^ Py_SIZE(b)) < 0) && z)
Guido van Rossumddefaf32007-01-14 03:31:43 +00003166 NEGATE(z);
Tim Peters9973d742002-08-15 19:41:06 +00003167 return (PyObject *)z;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003168}
3169
Guido van Rossume32e0141992-01-19 16:31:05 +00003170/* The / and % operators are now defined in terms of divmod().
3171 The expression a mod b has the value a - b*floor(a/b).
3172 The long_divrem function gives the remainder after division of
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003173 |a| by |b|, with the sign of a. This is also expressed
3174 as a - b*trunc(a/b), if trunc truncates towards zero.
3175 Some examples:
3176 a b a rem b a mod b
3177 13 10 3 3
3178 -13 10 -3 7
3179 13 -10 3 -7
3180 -13 -10 -3 -3
3181 So, to get from rem to mod, we have to add b if a and b
Guido van Rossum23d6f0e1991-05-14 12:06:49 +00003182 have different signs. We then subtract one from the 'div'
3183 part of the outcome to keep the invariant intact. */
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003184
Tim Peters47e52ee2004-08-30 02:44:38 +00003185/* Compute
3186 * *pdiv, *pmod = divmod(v, w)
3187 * NULL can be passed for pdiv or pmod, in which case that part of
3188 * the result is simply thrown away. The caller owns a reference to
3189 * each of these it requests (does not pass NULL for).
3190 */
Guido van Rossume32e0141992-01-19 16:31:05 +00003191static int
Tim Peters5af4e6c2002-08-12 02:31:19 +00003192l_divmod(PyLongObject *v, PyLongObject *w,
Tim Peters9f688bf2000-07-07 15:53:28 +00003193 PyLongObject **pdiv, PyLongObject **pmod)
Guido van Rossume32e0141992-01-19 16:31:05 +00003194{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003195 PyLongObject *div, *mod;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003196
Guido van Rossume32e0141992-01-19 16:31:05 +00003197 if (long_divrem(v, w, &div, &mod) < 0)
3198 return -1;
Christian Heimes90aa7642007-12-19 02:45:37 +00003199 if ((Py_SIZE(mod) < 0 && Py_SIZE(w) > 0) ||
3200 (Py_SIZE(mod) > 0 && Py_SIZE(w) < 0)) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003201 PyLongObject *temp;
3202 PyLongObject *one;
3203 temp = (PyLongObject *) long_add(mod, w);
3204 Py_DECREF(mod);
Guido van Rossume32e0141992-01-19 16:31:05 +00003205 mod = temp;
3206 if (mod == NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003207 Py_DECREF(div);
Guido van Rossume32e0141992-01-19 16:31:05 +00003208 return -1;
3209 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003210 one = (PyLongObject *) PyLong_FromLong(1L);
Guido van Rossume32e0141992-01-19 16:31:05 +00003211 if (one == NULL ||
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003212 (temp = (PyLongObject *) long_sub(div, one)) == NULL) {
3213 Py_DECREF(mod);
3214 Py_DECREF(div);
3215 Py_XDECREF(one);
Guido van Rossume32e0141992-01-19 16:31:05 +00003216 return -1;
3217 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003218 Py_DECREF(one);
3219 Py_DECREF(div);
Guido van Rossume32e0141992-01-19 16:31:05 +00003220 div = temp;
3221 }
Tim Peters47e52ee2004-08-30 02:44:38 +00003222 if (pdiv != NULL)
3223 *pdiv = div;
3224 else
3225 Py_DECREF(div);
3226
3227 if (pmod != NULL)
3228 *pmod = mod;
3229 else
3230 Py_DECREF(mod);
3231
Guido van Rossume32e0141992-01-19 16:31:05 +00003232 return 0;
3233}
3234
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003235static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003236long_div(PyObject *a, PyObject *b)
Guido van Rossume32e0141992-01-19 16:31:05 +00003237{
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003238 PyLongObject *div;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003239
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003240 CHECK_BINOP(a, b);
3241 if (l_divmod((PyLongObject*)a, (PyLongObject*)b, &div, NULL) < 0)
Tim Peters47e52ee2004-08-30 02:44:38 +00003242 div = NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003243 return (PyObject *)div;
Guido van Rossume32e0141992-01-19 16:31:05 +00003244}
3245
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003246/* PyLong/PyLong -> float, with correctly rounded result. */
3247
3248#define MANT_DIG_DIGITS (DBL_MANT_DIG / PyLong_SHIFT)
3249#define MANT_DIG_BITS (DBL_MANT_DIG % PyLong_SHIFT)
3250
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003251static PyObject *
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003252long_true_divide(PyObject *v, PyObject *w)
Tim Peters20dab9f2001-09-04 05:31:47 +00003253{
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003254 PyLongObject *a, *b, *x;
3255 Py_ssize_t a_size, b_size, shift, extra_bits, diff, x_size, x_bits;
3256 digit mask, low;
3257 int inexact, negate, a_is_small, b_is_small;
3258 double dx, result;
Tim Peterse2a60002001-09-04 06:17:36 +00003259
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003260 CHECK_BINOP(v, w);
3261 a = (PyLongObject *)v;
3262 b = (PyLongObject *)w;
Tim Peterse2a60002001-09-04 06:17:36 +00003263
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003264 /*
3265 Method in a nutshell:
3266
3267 0. reduce to case a, b > 0; filter out obvious underflow/overflow
3268 1. choose a suitable integer 'shift'
3269 2. use integer arithmetic to compute x = floor(2**-shift*a/b)
3270 3. adjust x for correct rounding
3271 4. convert x to a double dx with the same value
3272 5. return ldexp(dx, shift).
3273
3274 In more detail:
3275
3276 0. For any a, a/0 raises ZeroDivisionError; for nonzero b, 0/b
3277 returns either 0.0 or -0.0, depending on the sign of b. For a and
3278 b both nonzero, ignore signs of a and b, and add the sign back in
3279 at the end. Now write a_bits and b_bits for the bit lengths of a
3280 and b respectively (that is, a_bits = 1 + floor(log_2(a)); likewise
3281 for b). Then
3282
3283 2**(a_bits - b_bits - 1) < a/b < 2**(a_bits - b_bits + 1).
3284
3285 So if a_bits - b_bits > DBL_MAX_EXP then a/b > 2**DBL_MAX_EXP and
3286 so overflows. Similarly, if a_bits - b_bits < DBL_MIN_EXP -
3287 DBL_MANT_DIG - 1 then a/b underflows to 0. With these cases out of
3288 the way, we can assume that
3289
3290 DBL_MIN_EXP - DBL_MANT_DIG - 1 <= a_bits - b_bits <= DBL_MAX_EXP.
3291
3292 1. The integer 'shift' is chosen so that x has the right number of
3293 bits for a double, plus two or three extra bits that will be used
3294 in the rounding decisions. Writing a_bits and b_bits for the
3295 number of significant bits in a and b respectively, a
3296 straightforward formula for shift is:
3297
3298 shift = a_bits - b_bits - DBL_MANT_DIG - 2
3299
3300 This is fine in the usual case, but if a/b is smaller than the
3301 smallest normal float then it can lead to double rounding on an
3302 IEEE 754 platform, giving incorrectly rounded results. So we
3303 adjust the formula slightly. The actual formula used is:
3304
3305 shift = MAX(a_bits - b_bits, DBL_MIN_EXP) - DBL_MANT_DIG - 2
3306
3307 2. The quantity x is computed by first shifting a (left -shift bits
3308 if shift <= 0, right shift bits if shift > 0) and then dividing by
3309 b. For both the shift and the division, we keep track of whether
3310 the result is inexact, in a flag 'inexact'; this information is
3311 needed at the rounding stage.
3312
3313 With the choice of shift above, together with our assumption that
3314 a_bits - b_bits >= DBL_MIN_EXP - DBL_MANT_DIG - 1, it follows
3315 that x >= 1.
3316
3317 3. Now x * 2**shift <= a/b < (x+1) * 2**shift. We want to replace
3318 this with an exactly representable float of the form
3319
3320 round(x/2**extra_bits) * 2**(extra_bits+shift).
3321
3322 For float representability, we need x/2**extra_bits <
3323 2**DBL_MANT_DIG and extra_bits + shift >= DBL_MIN_EXP -
3324 DBL_MANT_DIG. This translates to the condition:
3325
3326 extra_bits >= MAX(x_bits, DBL_MIN_EXP - shift) - DBL_MANT_DIG
3327
3328 To round, we just modify the bottom digit of x in-place; this can
3329 end up giving a digit with value > PyLONG_MASK, but that's not a
3330 problem since digits can hold values up to 2*PyLONG_MASK+1.
3331
3332 With the original choices for shift above, extra_bits will always
3333 be 2 or 3. Then rounding under the round-half-to-even rule, we
3334 round up iff the most significant of the extra bits is 1, and
3335 either: (a) the computation of x in step 2 had an inexact result,
3336 or (b) at least one other of the extra bits is 1, or (c) the least
3337 significant bit of x (above those to be rounded) is 1.
3338
3339 4. Conversion to a double is straightforward; all floating-point
3340 operations involved in the conversion are exact, so there's no
3341 danger of rounding errors.
3342
3343 5. Use ldexp(x, shift) to compute x*2**shift, the final result.
3344 The result will always be exactly representable as a double, except
3345 in the case that it overflows. To avoid dependence on the exact
3346 behaviour of ldexp on overflow, we check for overflow before
3347 applying ldexp. The result of ldexp is adjusted for sign before
3348 returning.
3349 */
3350
3351 /* Reduce to case where a and b are both positive. */
3352 a_size = ABS(Py_SIZE(a));
3353 b_size = ABS(Py_SIZE(b));
3354 negate = (Py_SIZE(a) < 0) ^ (Py_SIZE(b) < 0);
3355 if (b_size == 0) {
Tim Peterse2a60002001-09-04 06:17:36 +00003356 PyErr_SetString(PyExc_ZeroDivisionError,
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003357 "division by zero");
3358 goto error;
3359 }
3360 if (a_size == 0)
3361 goto underflow_or_zero;
3362
3363 /* Fast path for a and b small (exactly representable in a double).
3364 Relies on floating-point division being correctly rounded; results
3365 may be subject to double rounding on x86 machines that operate with
3366 the x87 FPU set to 64-bit precision. */
3367 a_is_small = a_size <= MANT_DIG_DIGITS ||
3368 (a_size == MANT_DIG_DIGITS+1 &&
3369 a->ob_digit[MANT_DIG_DIGITS] >> MANT_DIG_BITS == 0);
3370 b_is_small = b_size <= MANT_DIG_DIGITS ||
3371 (b_size == MANT_DIG_DIGITS+1 &&
3372 b->ob_digit[MANT_DIG_DIGITS] >> MANT_DIG_BITS == 0);
3373 if (a_is_small && b_is_small) {
3374 double da, db;
3375 da = a->ob_digit[--a_size];
3376 while (a_size > 0)
3377 da = da * PyLong_BASE + a->ob_digit[--a_size];
3378 db = b->ob_digit[--b_size];
3379 while (b_size > 0)
3380 db = db * PyLong_BASE + b->ob_digit[--b_size];
3381 result = da / db;
3382 goto success;
Tim Peterse2a60002001-09-04 06:17:36 +00003383 }
3384
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003385 /* Catch obvious cases of underflow and overflow */
3386 diff = a_size - b_size;
3387 if (diff > PY_SSIZE_T_MAX/PyLong_SHIFT - 1)
3388 /* Extreme overflow */
Tim Peterse2a60002001-09-04 06:17:36 +00003389 goto overflow;
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003390 else if (diff < 1 - PY_SSIZE_T_MAX/PyLong_SHIFT)
3391 /* Extreme underflow */
3392 goto underflow_or_zero;
3393 /* Next line is now safe from overflowing a Py_ssize_t */
3394 diff = diff * PyLong_SHIFT + bits_in_digit(a->ob_digit[a_size - 1]) -
3395 bits_in_digit(b->ob_digit[b_size - 1]);
3396 /* Now diff = a_bits - b_bits. */
3397 if (diff > DBL_MAX_EXP)
Tim Peterse2a60002001-09-04 06:17:36 +00003398 goto overflow;
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003399 else if (diff < DBL_MIN_EXP - DBL_MANT_DIG - 1)
3400 goto underflow_or_zero;
Tim Peterse2a60002001-09-04 06:17:36 +00003401
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003402 /* Choose value for shift; see comments for step 1 above. */
3403 shift = MAX(diff, DBL_MIN_EXP) - DBL_MANT_DIG - 2;
3404
3405 inexact = 0;
3406
3407 /* x = abs(a * 2**-shift) */
3408 if (shift <= 0) {
3409 Py_ssize_t i, shift_digits = -shift / PyLong_SHIFT;
3410 digit rem;
3411 /* x = a << -shift */
3412 if (a_size >= PY_SSIZE_T_MAX - 1 - shift_digits) {
3413 /* In practice, it's probably impossible to end up
3414 here. Both a and b would have to be enormous,
3415 using close to SIZE_T_MAX bytes of memory each. */
3416 PyErr_SetString(PyExc_OverflowError,
3417 "intermediate overflow during division");
3418 goto error;
3419 }
3420 x = _PyLong_New(a_size + shift_digits + 1);
3421 if (x == NULL)
3422 goto error;
3423 for (i = 0; i < shift_digits; i++)
3424 x->ob_digit[i] = 0;
3425 rem = v_lshift(x->ob_digit + shift_digits, a->ob_digit,
3426 a_size, -shift % PyLong_SHIFT);
3427 x->ob_digit[a_size + shift_digits] = rem;
3428 }
3429 else {
3430 Py_ssize_t shift_digits = shift / PyLong_SHIFT;
3431 digit rem;
3432 /* x = a >> shift */
3433 assert(a_size >= shift_digits);
3434 x = _PyLong_New(a_size - shift_digits);
3435 if (x == NULL)
3436 goto error;
3437 rem = v_rshift(x->ob_digit, a->ob_digit + shift_digits,
3438 a_size - shift_digits, shift % PyLong_SHIFT);
3439 /* set inexact if any of the bits shifted out is nonzero */
3440 if (rem)
3441 inexact = 1;
3442 while (!inexact && shift_digits > 0)
3443 if (a->ob_digit[--shift_digits])
3444 inexact = 1;
3445 }
3446 long_normalize(x);
3447 x_size = Py_SIZE(x);
3448
3449 /* x //= b. If the remainder is nonzero, set inexact. We own the only
3450 reference to x, so it's safe to modify it in-place. */
3451 if (b_size == 1) {
3452 digit rem = inplace_divrem1(x->ob_digit, x->ob_digit, x_size,
3453 b->ob_digit[0]);
3454 long_normalize(x);
3455 if (rem)
3456 inexact = 1;
3457 }
3458 else {
3459 PyLongObject *div, *rem;
3460 div = x_divrem(x, b, &rem);
3461 Py_DECREF(x);
3462 x = div;
3463 if (x == NULL)
3464 goto error;
3465 if (Py_SIZE(rem))
3466 inexact = 1;
3467 Py_DECREF(rem);
3468 }
3469 x_size = ABS(Py_SIZE(x));
3470 assert(x_size > 0); /* result of division is never zero */
3471 x_bits = (x_size-1)*PyLong_SHIFT+bits_in_digit(x->ob_digit[x_size-1]);
3472
3473 /* The number of extra bits that have to be rounded away. */
3474 extra_bits = MAX(x_bits, DBL_MIN_EXP - shift) - DBL_MANT_DIG;
3475 assert(extra_bits == 2 || extra_bits == 3);
3476
3477 /* Round by directly modifying the low digit of x. */
3478 mask = (digit)1 << (extra_bits - 1);
3479 low = x->ob_digit[0] | inexact;
3480 if (low & mask && low & (3*mask-1))
3481 low += mask;
3482 x->ob_digit[0] = low & ~(mask-1U);
3483
3484 /* Convert x to a double dx; the conversion is exact. */
3485 dx = x->ob_digit[--x_size];
3486 while (x_size > 0)
3487 dx = dx * PyLong_BASE + x->ob_digit[--x_size];
3488 Py_DECREF(x);
3489
3490 /* Check whether ldexp result will overflow a double. */
3491 if (shift + x_bits >= DBL_MAX_EXP &&
Stefan Krah0091e5e2010-04-07 08:49:55 +00003492 (shift + x_bits > DBL_MAX_EXP || dx == ldexp(1.0, (int)x_bits)))
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003493 goto overflow;
Stefan Krah0091e5e2010-04-07 08:49:55 +00003494 result = ldexp(dx, (int)shift);
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003495
3496 success:
3497 return PyFloat_FromDouble(negate ? -result : result);
3498
3499 underflow_or_zero:
3500 return PyFloat_FromDouble(negate ? -0.0 : 0.0);
3501
3502 overflow:
Tim Peterse2a60002001-09-04 06:17:36 +00003503 PyErr_SetString(PyExc_OverflowError,
Mark Dickinsoncbb62742009-12-27 15:09:50 +00003504 "integer division result too large for a float");
3505 error:
Tim Peterse2a60002001-09-04 06:17:36 +00003506 return NULL;
Tim Peters20dab9f2001-09-04 05:31:47 +00003507}
3508
3509static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003510long_mod(PyObject *a, PyObject *b)
Guido van Rossume32e0141992-01-19 16:31:05 +00003511{
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003512 PyLongObject *mod;
3513
3514 CHECK_BINOP(a, b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003515
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003516 if (l_divmod((PyLongObject*)a, (PyLongObject*)b, NULL, &mod) < 0)
Tim Peters47e52ee2004-08-30 02:44:38 +00003517 mod = NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003518 return (PyObject *)mod;
Guido van Rossume32e0141992-01-19 16:31:05 +00003519}
3520
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003521static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003522long_divmod(PyObject *a, PyObject *b)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003523{
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003524 PyLongObject *div, *mod;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003525 PyObject *z;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003526
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003527 CHECK_BINOP(a, b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003528
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003529 if (l_divmod((PyLongObject*)a, (PyLongObject*)b, &div, &mod) < 0) {
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003530 return NULL;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003531 }
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003532 z = PyTuple_New(2);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003533 if (z != NULL) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003534 PyTuple_SetItem(z, 0, (PyObject *) div);
3535 PyTuple_SetItem(z, 1, (PyObject *) mod);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003536 }
3537 else {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003538 Py_DECREF(div);
3539 Py_DECREF(mod);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003540 }
3541 return z;
3542}
3543
Tim Peters47e52ee2004-08-30 02:44:38 +00003544/* pow(v, w, x) */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003545static PyObject *
Neil Schemenauerba872e22001-01-04 01:46:03 +00003546long_pow(PyObject *v, PyObject *w, PyObject *x)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003547{
Tim Peters47e52ee2004-08-30 02:44:38 +00003548 PyLongObject *a, *b, *c; /* a,b,c = v,w,x */
3549 int negativeOutput = 0; /* if x<0 return negative output */
Neil Schemenauerba872e22001-01-04 01:46:03 +00003550
Tim Peters47e52ee2004-08-30 02:44:38 +00003551 PyLongObject *z = NULL; /* accumulated result */
Martin v. Löwis18e16552006-02-15 17:27:45 +00003552 Py_ssize_t i, j, k; /* counters */
Tim Peters47e52ee2004-08-30 02:44:38 +00003553 PyLongObject *temp = NULL;
3554
3555 /* 5-ary values. If the exponent is large enough, table is
3556 * precomputed so that table[i] == a**i % c for i in range(32).
3557 */
3558 PyLongObject *table[32] = {0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3559 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0};
3560
3561 /* a, b, c = v, w, x */
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003562 CHECK_BINOP(v, w);
3563 a = (PyLongObject*)v; Py_INCREF(a);
3564 b = (PyLongObject*)w; Py_INCREF(b);
Tim Peters47e52ee2004-08-30 02:44:38 +00003565 if (PyLong_Check(x)) {
3566 c = (PyLongObject *)x;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003567 Py_INCREF(x);
3568 }
Tim Peters47e52ee2004-08-30 02:44:38 +00003569 else if (x == Py_None)
3570 c = NULL;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003571 else {
3572 Py_DECREF(a);
3573 Py_DECREF(b);
3574 Py_INCREF(Py_NotImplemented);
3575 return Py_NotImplemented;
3576 }
Tim Peters4c483c42001-09-05 06:24:58 +00003577
Christian Heimes90aa7642007-12-19 02:45:37 +00003578 if (Py_SIZE(b) < 0) { /* if exponent is negative */
Tim Peters47e52ee2004-08-30 02:44:38 +00003579 if (c) {
Tim Peters4c483c42001-09-05 06:24:58 +00003580 PyErr_SetString(PyExc_TypeError, "pow() 2nd argument "
Tim Peters47e52ee2004-08-30 02:44:38 +00003581 "cannot be negative when 3rd argument specified");
Tim Peterscd97da32004-08-30 02:58:59 +00003582 goto Error;
Tim Peters32f453e2001-09-03 08:35:41 +00003583 }
Guido van Rossum2c7b8fe1999-10-11 22:34:41 +00003584 else {
Tim Peters47e52ee2004-08-30 02:44:38 +00003585 /* else return a float. This works because we know
3586 that this calls float_pow() which converts its
3587 arguments to double. */
3588 Py_DECREF(a);
3589 Py_DECREF(b);
3590 return PyFloat_Type.tp_as_number->nb_power(v, w, x);
Guido van Rossum2c7b8fe1999-10-11 22:34:41 +00003591 }
Guido van Rossumeb1fafc1994-08-29 12:47:19 +00003592 }
Tim Peters47e52ee2004-08-30 02:44:38 +00003593
3594 if (c) {
3595 /* if modulus == 0:
3596 raise ValueError() */
Christian Heimes90aa7642007-12-19 02:45:37 +00003597 if (Py_SIZE(c) == 0) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003598 PyErr_SetString(PyExc_ValueError,
3599 "pow() 3rd argument cannot be 0");
Tim Peterscd97da32004-08-30 02:58:59 +00003600 goto Error;
Tim Peters47e52ee2004-08-30 02:44:38 +00003601 }
3602
3603 /* if modulus < 0:
3604 negativeOutput = True
3605 modulus = -modulus */
Christian Heimes90aa7642007-12-19 02:45:37 +00003606 if (Py_SIZE(c) < 0) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003607 negativeOutput = 1;
3608 temp = (PyLongObject *)_PyLong_Copy(c);
3609 if (temp == NULL)
3610 goto Error;
3611 Py_DECREF(c);
3612 c = temp;
3613 temp = NULL;
Guido van Rossumddefaf32007-01-14 03:31:43 +00003614 NEGATE(c);
Tim Peters47e52ee2004-08-30 02:44:38 +00003615 }
3616
3617 /* if modulus == 1:
3618 return 0 */
Christian Heimes90aa7642007-12-19 02:45:37 +00003619 if ((Py_SIZE(c) == 1) && (c->ob_digit[0] == 1)) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003620 z = (PyLongObject *)PyLong_FromLong(0L);
3621 goto Done;
3622 }
3623
3624 /* if base < 0:
3625 base = base % modulus
3626 Having the base positive just makes things easier. */
Christian Heimes90aa7642007-12-19 02:45:37 +00003627 if (Py_SIZE(a) < 0) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003628 if (l_divmod(a, c, NULL, &temp) < 0)
Tim Peterscd97da32004-08-30 02:58:59 +00003629 goto Error;
Tim Peters47e52ee2004-08-30 02:44:38 +00003630 Py_DECREF(a);
3631 a = temp;
3632 temp = NULL;
3633 }
3634 }
3635
3636 /* At this point a, b, and c are guaranteed non-negative UNLESS
3637 c is NULL, in which case a may be negative. */
3638
3639 z = (PyLongObject *)PyLong_FromLong(1L);
3640 if (z == NULL)
3641 goto Error;
3642
3643 /* Perform a modular reduction, X = X % c, but leave X alone if c
3644 * is NULL.
3645 */
3646#define REDUCE(X) \
3647 if (c != NULL) { \
3648 if (l_divmod(X, c, NULL, &temp) < 0) \
3649 goto Error; \
3650 Py_XDECREF(X); \
3651 X = temp; \
3652 temp = NULL; \
3653 }
3654
3655 /* Multiply two values, then reduce the result:
3656 result = X*Y % c. If c is NULL, skip the mod. */
3657#define MULT(X, Y, result) \
3658{ \
3659 temp = (PyLongObject *)long_mul(X, Y); \
3660 if (temp == NULL) \
3661 goto Error; \
3662 Py_XDECREF(result); \
3663 result = temp; \
3664 temp = NULL; \
3665 REDUCE(result) \
3666}
3667
Christian Heimes90aa7642007-12-19 02:45:37 +00003668 if (Py_SIZE(b) <= FIVEARY_CUTOFF) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003669 /* Left-to-right binary exponentiation (HAC Algorithm 14.79) */
3670 /* http://www.cacr.math.uwaterloo.ca/hac/about/chap14.pdf */
Christian Heimes90aa7642007-12-19 02:45:37 +00003671 for (i = Py_SIZE(b) - 1; i >= 0; --i) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003672 digit bi = b->ob_digit[i];
3673
Mark Dickinsone4416742009-02-15 15:14:57 +00003674 for (j = (digit)1 << (PyLong_SHIFT-1); j != 0; j >>= 1) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003675 MULT(z, z, z)
3676 if (bi & j)
3677 MULT(z, a, z)
3678 }
3679 }
3680 }
3681 else {
3682 /* Left-to-right 5-ary exponentiation (HAC Algorithm 14.82) */
3683 Py_INCREF(z); /* still holds 1L */
3684 table[0] = z;
3685 for (i = 1; i < 32; ++i)
3686 MULT(table[i-1], a, table[i])
3687
Christian Heimes90aa7642007-12-19 02:45:37 +00003688 for (i = Py_SIZE(b) - 1; i >= 0; --i) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003689 const digit bi = b->ob_digit[i];
3690
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003691 for (j = PyLong_SHIFT - 5; j >= 0; j -= 5) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003692 const int index = (bi >> j) & 0x1f;
3693 for (k = 0; k < 5; ++k)
3694 MULT(z, z, z)
3695 if (index)
3696 MULT(z, table[index], z)
3697 }
3698 }
3699 }
3700
Christian Heimes90aa7642007-12-19 02:45:37 +00003701 if (negativeOutput && (Py_SIZE(z) != 0)) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003702 temp = (PyLongObject *)long_sub(z, c);
3703 if (temp == NULL)
3704 goto Error;
3705 Py_DECREF(z);
3706 z = temp;
3707 temp = NULL;
3708 }
3709 goto Done;
3710
3711 Error:
3712 if (z != NULL) {
3713 Py_DECREF(z);
3714 z = NULL;
3715 }
3716 /* fall through */
3717 Done:
Christian Heimes90aa7642007-12-19 02:45:37 +00003718 if (Py_SIZE(b) > FIVEARY_CUTOFF) {
Tim Peters47e52ee2004-08-30 02:44:38 +00003719 for (i = 0; i < 32; ++i)
3720 Py_XDECREF(table[i]);
3721 }
Tim Petersde7990b2005-07-17 23:45:23 +00003722 Py_DECREF(a);
3723 Py_DECREF(b);
3724 Py_XDECREF(c);
3725 Py_XDECREF(temp);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003726 return (PyObject *)z;
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003727}
3728
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003729static PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00003730long_invert(PyLongObject *v)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003731{
Guido van Rossum4c260ff1992-01-14 18:36:43 +00003732 /* Implement ~x as -(x+1) */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003733 PyLongObject *x;
3734 PyLongObject *w;
Christian Heimes90aa7642007-12-19 02:45:37 +00003735 if (ABS(Py_SIZE(v)) <=1)
Guido van Rossumddefaf32007-01-14 03:31:43 +00003736 return PyLong_FromLong(-(MEDIUM_VALUE(v)+1));
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003737 w = (PyLongObject *)PyLong_FromLong(1L);
Guido van Rossum4c260ff1992-01-14 18:36:43 +00003738 if (w == NULL)
3739 return NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003740 x = (PyLongObject *) long_add(v, w);
3741 Py_DECREF(w);
Guido van Rossum4c260ff1992-01-14 18:36:43 +00003742 if (x == NULL)
3743 return NULL;
Christian Heimes90aa7642007-12-19 02:45:37 +00003744 Py_SIZE(x) = -(Py_SIZE(x));
Facundo Batista6e6f59b2008-07-24 18:57:11 +00003745 return (PyObject *)maybe_small_long(x);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003746}
3747
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003748static PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00003749long_neg(PyLongObject *v)
Guido van Rossumc6913e71991-11-19 20:26:46 +00003750{
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003751 PyLongObject *z;
Christian Heimes90aa7642007-12-19 02:45:37 +00003752 if (ABS(Py_SIZE(v)) <= 1)
Guido van Rossumddefaf32007-01-14 03:31:43 +00003753 return PyLong_FromLong(-MEDIUM_VALUE(v));
Tim Peters69c2de32001-09-11 22:31:33 +00003754 z = (PyLongObject *)_PyLong_Copy(v);
3755 if (z != NULL)
Christian Heimes90aa7642007-12-19 02:45:37 +00003756 Py_SIZE(z) = -(Py_SIZE(v));
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003757 return (PyObject *)z;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003758}
3759
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003760static PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00003761long_abs(PyLongObject *v)
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003762{
Christian Heimes90aa7642007-12-19 02:45:37 +00003763 if (Py_SIZE(v) < 0)
Guido van Rossum4c260ff1992-01-14 18:36:43 +00003764 return long_neg(v);
Tim Peters69c2de32001-09-11 22:31:33 +00003765 else
Guido van Rossumb43daf72007-08-01 18:08:08 +00003766 return long_long((PyObject *)v);
Guido van Rossumedcc38a1991-05-05 20:09:44 +00003767}
3768
Guido van Rossum23d6f0e1991-05-14 12:06:49 +00003769static int
Jack Diederich4dafcc42006-11-28 19:15:13 +00003770long_bool(PyLongObject *v)
Guido van Rossum23d6f0e1991-05-14 12:06:49 +00003771{
Mark Dickinsone97ecba2010-05-08 08:03:09 +00003772 return Py_SIZE(v) != 0;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003773}
3774
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003775static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003776long_rshift(PyLongObject *a, PyLongObject *b)
Guido van Rossumc6913e71991-11-19 20:26:46 +00003777{
Neil Schemenauerba872e22001-01-04 01:46:03 +00003778 PyLongObject *z = NULL;
Mark Dickinson3318d292010-04-06 16:53:17 +00003779 Py_ssize_t shiftby, newsize, wordshift, loshift, hishift, i, j;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003780 digit lomask, himask;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003781
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003782 CHECK_BINOP(a, b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003783
Christian Heimes90aa7642007-12-19 02:45:37 +00003784 if (Py_SIZE(a) < 0) {
Guido van Rossum4c260ff1992-01-14 18:36:43 +00003785 /* Right shifting negative numbers is harder */
Neil Schemenauerba872e22001-01-04 01:46:03 +00003786 PyLongObject *a1, *a2;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003787 a1 = (PyLongObject *) long_invert(a);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003788 if (a1 == NULL)
3789 goto rshift_error;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003790 a2 = (PyLongObject *) long_rshift(a1, b);
3791 Py_DECREF(a1);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003792 if (a2 == NULL)
3793 goto rshift_error;
3794 z = (PyLongObject *) long_invert(a2);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003795 Py_DECREF(a2);
Guido van Rossumc6913e71991-11-19 20:26:46 +00003796 }
Neil Schemenauerba872e22001-01-04 01:46:03 +00003797 else {
Mark Dickinson3318d292010-04-06 16:53:17 +00003798 shiftby = PyLong_AsSsize_t((PyObject *)b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003799 if (shiftby == -1L && PyErr_Occurred())
3800 goto rshift_error;
3801 if (shiftby < 0) {
3802 PyErr_SetString(PyExc_ValueError,
3803 "negative shift count");
3804 goto rshift_error;
3805 }
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003806 wordshift = shiftby / PyLong_SHIFT;
Christian Heimes90aa7642007-12-19 02:45:37 +00003807 newsize = ABS(Py_SIZE(a)) - wordshift;
Facundo Batista6e6f59b2008-07-24 18:57:11 +00003808 if (newsize <= 0)
3809 return PyLong_FromLong(0);
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003810 loshift = shiftby % PyLong_SHIFT;
3811 hishift = PyLong_SHIFT - loshift;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003812 lomask = ((digit)1 << hishift) - 1;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003813 himask = PyLong_MASK ^ lomask;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003814 z = _PyLong_New(newsize);
3815 if (z == NULL)
3816 goto rshift_error;
Christian Heimes90aa7642007-12-19 02:45:37 +00003817 if (Py_SIZE(a) < 0)
3818 Py_SIZE(z) = -(Py_SIZE(z));
Neil Schemenauerba872e22001-01-04 01:46:03 +00003819 for (i = 0, j = wordshift; i < newsize; i++, j++) {
3820 z->ob_digit[i] = (a->ob_digit[j] >> loshift) & lomask;
3821 if (i+1 < newsize)
3822 z->ob_digit[i] |=
3823 (a->ob_digit[j+1] << hishift) & himask;
3824 }
3825 z = long_normalize(z);
Guido van Rossumc6913e71991-11-19 20:26:46 +00003826 }
Neil Schemenauerba872e22001-01-04 01:46:03 +00003827rshift_error:
Facundo Batista6e6f59b2008-07-24 18:57:11 +00003828 return (PyObject *) maybe_small_long(z);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003829
Guido van Rossumc6913e71991-11-19 20:26:46 +00003830}
3831
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003832static PyObject *
Neil Schemenauerba872e22001-01-04 01:46:03 +00003833long_lshift(PyObject *v, PyObject *w)
Guido van Rossumc6913e71991-11-19 20:26:46 +00003834{
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003835 /* This version due to Tim Peters */
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003836 PyLongObject *a = (PyLongObject*)v;
3837 PyLongObject *b = (PyLongObject*)w;
Neil Schemenauerba872e22001-01-04 01:46:03 +00003838 PyLongObject *z = NULL;
Mark Dickinson3318d292010-04-06 16:53:17 +00003839 Py_ssize_t shiftby, oldsize, newsize, wordshift, remshift, i, j;
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003840 twodigits accum;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003841
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00003842 CHECK_BINOP(a, b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003843
Mark Dickinson3318d292010-04-06 16:53:17 +00003844 shiftby = PyLong_AsSsize_t((PyObject *)b);
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003845 if (shiftby == -1L && PyErr_Occurred())
Neil Schemenauerba872e22001-01-04 01:46:03 +00003846 goto lshift_error;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003847 if (shiftby < 0) {
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003848 PyErr_SetString(PyExc_ValueError, "negative shift count");
Neil Schemenauerba872e22001-01-04 01:46:03 +00003849 goto lshift_error;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003850 }
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003851 /* wordshift, remshift = divmod(shiftby, PyLong_SHIFT) */
Mark Dickinson3318d292010-04-06 16:53:17 +00003852 wordshift = shiftby / PyLong_SHIFT;
3853 remshift = shiftby - wordshift * PyLong_SHIFT;
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003854
Christian Heimes90aa7642007-12-19 02:45:37 +00003855 oldsize = ABS(Py_SIZE(a));
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003856 newsize = oldsize + wordshift;
3857 if (remshift)
3858 ++newsize;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003859 z = _PyLong_New(newsize);
Guido van Rossumc6913e71991-11-19 20:26:46 +00003860 if (z == NULL)
Neil Schemenauerba872e22001-01-04 01:46:03 +00003861 goto lshift_error;
Christian Heimes90aa7642007-12-19 02:45:37 +00003862 if (Py_SIZE(a) < 0)
Guido van Rossumddefaf32007-01-14 03:31:43 +00003863 NEGATE(z);
Guido van Rossumc6913e71991-11-19 20:26:46 +00003864 for (i = 0; i < wordshift; i++)
3865 z->ob_digit[i] = 0;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003866 accum = 0;
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003867 for (i = wordshift, j = 0; j < oldsize; i++, j++) {
Tim Peters0d2d87d2002-08-20 19:00:22 +00003868 accum |= (twodigits)a->ob_digit[j] << remshift;
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00003869 z->ob_digit[i] = (digit)(accum & PyLong_MASK);
3870 accum >>= PyLong_SHIFT;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003871 }
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003872 if (remshift)
3873 z->ob_digit[newsize-1] = (digit)accum;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003874 else
Guido van Rossumf2e499b1997-03-16 00:37:59 +00003875 assert(!accum);
Neil Schemenauerba872e22001-01-04 01:46:03 +00003876 z = long_normalize(z);
3877lshift_error:
Facundo Batista6e6f59b2008-07-24 18:57:11 +00003878 return (PyObject *) maybe_small_long(z);
Guido van Rossumc6913e71991-11-19 20:26:46 +00003879}
3880
Mark Dickinson27a87a22009-10-25 20:43:34 +00003881/* Compute two's complement of digit vector a[0:m], writing result to
3882 z[0:m]. The digit vector a need not be normalized, but should not
3883 be entirely zero. a and z may point to the same digit vector. */
3884
3885static void
3886v_complement(digit *z, digit *a, Py_ssize_t m)
3887{
3888 Py_ssize_t i;
3889 digit carry = 1;
3890 for (i = 0; i < m; ++i) {
3891 carry += a[i] ^ PyLong_MASK;
3892 z[i] = carry & PyLong_MASK;
3893 carry >>= PyLong_SHIFT;
3894 }
3895 assert(carry == 0);
3896}
Guido van Rossum4c260ff1992-01-14 18:36:43 +00003897
3898/* Bitwise and/xor/or operations */
3899
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003900static PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00003901long_bitwise(PyLongObject *a,
3902 int op, /* '&', '|', '^' */
3903 PyLongObject *b)
Guido van Rossumc6913e71991-11-19 20:26:46 +00003904{
Mark Dickinson27a87a22009-10-25 20:43:34 +00003905 int nega, negb, negz;
Mark Dickinsone4416742009-02-15 15:14:57 +00003906 Py_ssize_t size_a, size_b, size_z, i;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003907 PyLongObject *z;
Tim Peters5af4e6c2002-08-12 02:31:19 +00003908
Mark Dickinson27a87a22009-10-25 20:43:34 +00003909 /* Bitwise operations for negative numbers operate as though
3910 on a two's complement representation. So convert arguments
3911 from sign-magnitude to two's complement, and convert the
3912 result back to sign-magnitude at the end. */
3913
3914 /* If a is negative, replace it by its two's complement. */
3915 size_a = ABS(Py_SIZE(a));
3916 nega = Py_SIZE(a) < 0;
3917 if (nega) {
3918 z = _PyLong_New(size_a);
3919 if (z == NULL)
Hye-Shik Chang4af5c8c2006-03-07 15:39:21 +00003920 return NULL;
Mark Dickinson27a87a22009-10-25 20:43:34 +00003921 v_complement(z->ob_digit, a->ob_digit, size_a);
3922 a = z;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003923 }
Mark Dickinson27a87a22009-10-25 20:43:34 +00003924 else
3925 /* Keep reference count consistent. */
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003926 Py_INCREF(a);
Mark Dickinson27a87a22009-10-25 20:43:34 +00003927
3928 /* Same for b. */
3929 size_b = ABS(Py_SIZE(b));
3930 negb = Py_SIZE(b) < 0;
3931 if (negb) {
3932 z = _PyLong_New(size_b);
3933 if (z == NULL) {
Hye-Shik Chang4af5c8c2006-03-07 15:39:21 +00003934 Py_DECREF(a);
3935 return NULL;
3936 }
Mark Dickinson27a87a22009-10-25 20:43:34 +00003937 v_complement(z->ob_digit, b->ob_digit, size_b);
3938 b = z;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003939 }
Mark Dickinson27a87a22009-10-25 20:43:34 +00003940 else
Guido van Rossumc0b618a1997-05-02 03:12:38 +00003941 Py_INCREF(b);
Tim Peters5af4e6c2002-08-12 02:31:19 +00003942
Mark Dickinson27a87a22009-10-25 20:43:34 +00003943 /* Swap a and b if necessary to ensure size_a >= size_b. */
3944 if (size_a < size_b) {
3945 z = a; a = b; b = z;
3946 size_z = size_a; size_a = size_b; size_b = size_z;
3947 negz = nega; nega = negb; negb = negz;
Guido van Rossumc6913e71991-11-19 20:26:46 +00003948 }
Tim Peters5af4e6c2002-08-12 02:31:19 +00003949
Guido van Rossumbd3a5271998-08-11 15:04:47 +00003950 /* JRH: The original logic here was to allocate the result value (z)
3951 as the longer of the two operands. However, there are some cases
3952 where the result is guaranteed to be shorter than that: AND of two
3953 positives, OR of two negatives: use the shorter number. AND with
3954 mixed signs: use the positive number. OR with mixed signs: use the
Mark Dickinson27a87a22009-10-25 20:43:34 +00003955 negative number.
Guido van Rossumbd3a5271998-08-11 15:04:47 +00003956 */
Mark Dickinson27a87a22009-10-25 20:43:34 +00003957 switch (op) {
3958 case '^':
3959 negz = nega ^ negb;
3960 size_z = size_a;
3961 break;
3962 case '&':
3963 negz = nega & negb;
3964 size_z = negb ? size_a : size_b;
3965 break;
3966 case '|':
3967 negz = nega | negb;
3968 size_z = negb ? size_b : size_a;
3969 break;
3970 default:
3971 PyErr_BadArgument();
3972 return NULL;
3973 }
Guido van Rossumbd3a5271998-08-11 15:04:47 +00003974
Mark Dickinson27a87a22009-10-25 20:43:34 +00003975 /* We allow an extra digit if z is negative, to make sure that
3976 the final two's complement of z doesn't overflow. */
3977 z = _PyLong_New(size_z + negz);
Hye-Shik Chang4af5c8c2006-03-07 15:39:21 +00003978 if (z == NULL) {
Thomas Wouters0e3f5912006-08-11 14:57:12 +00003979 Py_DECREF(a);
3980 Py_DECREF(b);
Guido van Rossumbd3a5271998-08-11 15:04:47 +00003981 return NULL;
3982 }
Tim Peters5af4e6c2002-08-12 02:31:19 +00003983
Mark Dickinson27a87a22009-10-25 20:43:34 +00003984 /* Compute digits for overlap of a and b. */
3985 switch(op) {
3986 case '&':
3987 for (i = 0; i < size_b; ++i)
3988 z->ob_digit[i] = a->ob_digit[i] & b->ob_digit[i];
3989 break;
3990 case '|':
3991 for (i = 0; i < size_b; ++i)
3992 z->ob_digit[i] = a->ob_digit[i] | b->ob_digit[i];
3993 break;
3994 case '^':
3995 for (i = 0; i < size_b; ++i)
3996 z->ob_digit[i] = a->ob_digit[i] ^ b->ob_digit[i];
3997 break;
3998 default:
3999 PyErr_BadArgument();
4000 return NULL;
4001 }
4002
4003 /* Copy any remaining digits of a, inverting if necessary. */
4004 if (op == '^' && negb)
4005 for (; i < size_z; ++i)
4006 z->ob_digit[i] = a->ob_digit[i] ^ PyLong_MASK;
4007 else if (i < size_z)
4008 memcpy(&z->ob_digit[i], &a->ob_digit[i],
4009 (size_z-i)*sizeof(digit));
4010
4011 /* Complement result if negative. */
4012 if (negz) {
4013 Py_SIZE(z) = -(Py_SIZE(z));
4014 z->ob_digit[size_z] = PyLong_MASK;
4015 v_complement(z->ob_digit, z->ob_digit, size_z+1);
Guido van Rossumafbb8db1991-12-31 13:14:13 +00004016 }
Tim Peters5af4e6c2002-08-12 02:31:19 +00004017
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004018 Py_DECREF(a);
4019 Py_DECREF(b);
Mark Dickinson27a87a22009-10-25 20:43:34 +00004020 return (PyObject *)maybe_small_long(long_normalize(z));
Guido van Rossumc6913e71991-11-19 20:26:46 +00004021}
4022
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004023static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00004024long_and(PyObject *a, PyObject *b)
Guido van Rossumc6913e71991-11-19 20:26:46 +00004025{
Neil Schemenauerba872e22001-01-04 01:46:03 +00004026 PyObject *c;
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00004027 CHECK_BINOP(a, b);
4028 c = long_bitwise((PyLongObject*)a, '&', (PyLongObject*)b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00004029 return c;
Guido van Rossumc6913e71991-11-19 20:26:46 +00004030}
4031
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004032static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00004033long_xor(PyObject *a, PyObject *b)
Guido van Rossumc6913e71991-11-19 20:26:46 +00004034{
Neil Schemenauerba872e22001-01-04 01:46:03 +00004035 PyObject *c;
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00004036 CHECK_BINOP(a, b);
4037 c = long_bitwise((PyLongObject*)a, '^', (PyLongObject*)b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00004038 return c;
Guido van Rossumc6913e71991-11-19 20:26:46 +00004039}
4040
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004041static PyObject *
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00004042long_or(PyObject *a, PyObject *b)
Guido van Rossumc6913e71991-11-19 20:26:46 +00004043{
Neil Schemenauerba872e22001-01-04 01:46:03 +00004044 PyObject *c;
Martin v. Löwisda86fcc2007-09-10 07:59:54 +00004045 CHECK_BINOP(a, b);
4046 c = long_bitwise((PyLongObject*)a, '|', (PyLongObject*)b);
Neil Schemenauerba872e22001-01-04 01:46:03 +00004047 return c;
Guido van Rossum23d6f0e1991-05-14 12:06:49 +00004048}
4049
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004050static PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00004051long_long(PyObject *v)
Guido van Rossum1899c2e1992-09-12 11:09:23 +00004052{
Brett Cannonc3647ac2005-04-26 03:45:26 +00004053 if (PyLong_CheckExact(v))
4054 Py_INCREF(v);
4055 else
4056 v = _PyLong_Copy((PyLongObject *)v);
Guido van Rossum1899c2e1992-09-12 11:09:23 +00004057 return v;
4058}
4059
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004060static PyObject *
Tim Peters9f688bf2000-07-07 15:53:28 +00004061long_float(PyObject *v)
Guido van Rossum1899c2e1992-09-12 11:09:23 +00004062{
Guido van Rossum09e6ad01997-02-14 22:54:21 +00004063 double result;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004064 result = PyLong_AsDouble(v);
Tim Peters9fffa3e2001-09-04 05:14:19 +00004065 if (result == -1.0 && PyErr_Occurred())
4066 return NULL;
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004067 return PyFloat_FromDouble(result);
Guido van Rossum1899c2e1992-09-12 11:09:23 +00004068}
4069
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004070static PyObject *
Guido van Rossumbef14172001-08-29 15:47:46 +00004071long_subtype_new(PyTypeObject *type, PyObject *args, PyObject *kwds);
Guido van Rossum1899c2e1992-09-12 11:09:23 +00004072
Tim Peters6d6c1a32001-08-02 04:15:00 +00004073static PyObject *
4074long_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
4075{
4076 PyObject *x = NULL;
4077 int base = -909; /* unlikely! */
Martin v. Löwis15e62742006-02-27 16:46:16 +00004078 static char *kwlist[] = {"x", "base", 0};
Tim Peters6d6c1a32001-08-02 04:15:00 +00004079
Guido van Rossumbef14172001-08-29 15:47:46 +00004080 if (type != &PyLong_Type)
4081 return long_subtype_new(type, args, kwds); /* Wimp out */
Guido van Rossumddefaf32007-01-14 03:31:43 +00004082 if (!PyArg_ParseTupleAndKeywords(args, kwds, "|Oi:int", kwlist,
Tim Peters6d6c1a32001-08-02 04:15:00 +00004083 &x, &base))
4084 return NULL;
4085 if (x == NULL)
4086 return PyLong_FromLong(0L);
4087 if (base == -909)
4088 return PyNumber_Long(x);
Guido van Rossum98297ee2007-11-06 21:34:58 +00004089 else if (PyUnicode_Check(x))
4090 return PyLong_FromUnicode(PyUnicode_AS_UNICODE(x),
4091 PyUnicode_GET_SIZE(x),
4092 base);
Christian Heimes72b710a2008-05-26 13:28:38 +00004093 else if (PyByteArray_Check(x) || PyBytes_Check(x)) {
Guido van Rossumd8faa362007-04-27 19:54:29 +00004094 /* Since PyLong_FromString doesn't have a length parameter,
4095 * check here for possible NULs in the string. */
Guido van Rossum98297ee2007-11-06 21:34:58 +00004096 char *string;
Mark Dickinson5a74bf62009-02-15 11:04:38 +00004097 Py_ssize_t size = Py_SIZE(x);
Christian Heimes9c4756e2008-05-26 13:22:05 +00004098 if (PyByteArray_Check(x))
4099 string = PyByteArray_AS_STRING(x);
Guido van Rossum98297ee2007-11-06 21:34:58 +00004100 else
Christian Heimes72b710a2008-05-26 13:28:38 +00004101 string = PyBytes_AS_STRING(x);
Mark Dickinson5a74bf62009-02-15 11:04:38 +00004102 if (strlen(string) != (size_t)size) {
Guido van Rossum25236212007-08-22 23:28:23 +00004103 /* We only see this if there's a null byte in x,
Guido van Rossum98297ee2007-11-06 21:34:58 +00004104 x is a bytes or buffer, *and* a base is given. */
Guido van Rossumd8faa362007-04-27 19:54:29 +00004105 PyErr_Format(PyExc_ValueError,
Guido van Rossum25236212007-08-22 23:28:23 +00004106 "invalid literal for int() with base %d: %R",
4107 base, x);
Guido van Rossumd8faa362007-04-27 19:54:29 +00004108 return NULL;
Guido van Rossumddefaf32007-01-14 03:31:43 +00004109 }
Guido van Rossum4581ae52007-05-22 21:56:47 +00004110 return PyLong_FromString(string, NULL, base);
Guido van Rossumddefaf32007-01-14 03:31:43 +00004111 }
Tim Peters6d6c1a32001-08-02 04:15:00 +00004112 else {
4113 PyErr_SetString(PyExc_TypeError,
Guido van Rossumddefaf32007-01-14 03:31:43 +00004114 "int() can't convert non-string with explicit base");
Tim Peters6d6c1a32001-08-02 04:15:00 +00004115 return NULL;
4116 }
4117}
4118
Guido van Rossumbef14172001-08-29 15:47:46 +00004119/* Wimpy, slow approach to tp_new calls for subtypes of long:
4120 first create a regular long from whatever arguments we got,
4121 then allocate a subtype instance and initialize it from
4122 the regular long. The regular long is then thrown away.
4123*/
4124static PyObject *
4125long_subtype_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
4126{
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004127 PyLongObject *tmp, *newobj;
Martin v. Löwis18e16552006-02-15 17:27:45 +00004128 Py_ssize_t i, n;
Guido van Rossumbef14172001-08-29 15:47:46 +00004129
4130 assert(PyType_IsSubtype(type, &PyLong_Type));
4131 tmp = (PyLongObject *)long_new(&PyLong_Type, args, kwds);
4132 if (tmp == NULL)
4133 return NULL;
Tim Peters64b5ce32001-09-10 20:52:51 +00004134 assert(PyLong_CheckExact(tmp));
Christian Heimes90aa7642007-12-19 02:45:37 +00004135 n = Py_SIZE(tmp);
Guido van Rossumbef14172001-08-29 15:47:46 +00004136 if (n < 0)
4137 n = -n;
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004138 newobj = (PyLongObject *)type->tp_alloc(type, n);
4139 if (newobj == NULL) {
Raymond Hettingerf4667932003-06-28 20:04:25 +00004140 Py_DECREF(tmp);
Guido van Rossumbef14172001-08-29 15:47:46 +00004141 return NULL;
Raymond Hettingerf4667932003-06-28 20:04:25 +00004142 }
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004143 assert(PyLong_Check(newobj));
Christian Heimes90aa7642007-12-19 02:45:37 +00004144 Py_SIZE(newobj) = Py_SIZE(tmp);
Guido van Rossumbef14172001-08-29 15:47:46 +00004145 for (i = 0; i < n; i++)
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004146 newobj->ob_digit[i] = tmp->ob_digit[i];
Guido van Rossumbef14172001-08-29 15:47:46 +00004147 Py_DECREF(tmp);
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004148 return (PyObject *)newobj;
Guido van Rossumbef14172001-08-29 15:47:46 +00004149}
4150
Guido van Rossum5d9113d2003-01-29 17:58:45 +00004151static PyObject *
4152long_getnewargs(PyLongObject *v)
4153{
4154 return Py_BuildValue("(N)", _PyLong_Copy(v));
4155}
4156
Guido van Rossumb43daf72007-08-01 18:08:08 +00004157static PyObject *
Mark Dickinson6bf19002009-05-02 17:57:52 +00004158long_get0(PyLongObject *v, void *context) {
4159 return PyLong_FromLong(0L);
4160}
4161
4162static PyObject *
4163long_get1(PyLongObject *v, void *context) {
4164 return PyLong_FromLong(1L);
Guido van Rossumb43daf72007-08-01 18:08:08 +00004165}
4166
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004167static PyObject *
Eric Smith8c663262007-08-25 02:26:07 +00004168long__format__(PyObject *self, PyObject *args)
4169{
Eric Smith4a7d76d2008-05-30 18:10:19 +00004170 PyObject *format_spec;
4171
4172 if (!PyArg_ParseTuple(args, "U:__format__", &format_spec))
4173 return NULL;
4174 return _PyLong_FormatAdvanced(self,
4175 PyUnicode_AS_UNICODE(format_spec),
4176 PyUnicode_GET_SIZE(format_spec));
Eric Smith8c663262007-08-25 02:26:07 +00004177}
4178
Eric Smith8c663262007-08-25 02:26:07 +00004179static PyObject *
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004180long_round(PyObject *self, PyObject *args)
4181{
Mark Dickinson1124e712009-01-28 21:25:58 +00004182 PyObject *o_ndigits=NULL, *temp;
4183 PyLongObject *pow=NULL, *q=NULL, *r=NULL, *ndigits=NULL, *one;
4184 int errcode;
4185 digit q_mod_4;
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004186
Mark Dickinson1124e712009-01-28 21:25:58 +00004187 /* Notes on the algorithm: to round to the nearest 10**n (n positive),
4188 the straightforward method is:
4189
4190 (1) divide by 10**n
4191 (2) round to nearest integer (round to even in case of tie)
4192 (3) multiply result by 10**n.
4193
4194 But the rounding step involves examining the fractional part of the
4195 quotient to see whether it's greater than 0.5 or not. Since we
4196 want to do the whole calculation in integer arithmetic, it's
4197 simpler to do:
4198
4199 (1) divide by (10**n)/2
4200 (2) round to nearest multiple of 2 (multiple of 4 in case of tie)
4201 (3) multiply result by (10**n)/2.
4202
4203 Then all we need to know about the fractional part of the quotient
4204 arising in step (2) is whether it's zero or not.
4205
4206 Doing both a multiplication and division is wasteful, and is easily
4207 avoided if we just figure out how much to adjust the original input
4208 by to do the rounding.
4209
4210 Here's the whole algorithm expressed in Python.
4211
4212 def round(self, ndigits = None):
4213 """round(int, int) -> int"""
4214 if ndigits is None or ndigits >= 0:
4215 return self
4216 pow = 10**-ndigits >> 1
4217 q, r = divmod(self, pow)
4218 self -= r
4219 if (q & 1 != 0):
4220 if (q & 2 == r == 0):
4221 self -= pow
4222 else:
4223 self += pow
4224 return self
4225
4226 */
4227 if (!PyArg_ParseTuple(args, "|O", &o_ndigits))
4228 return NULL;
4229 if (o_ndigits == NULL)
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004230 return long_long(self);
4231
Mark Dickinson1124e712009-01-28 21:25:58 +00004232 ndigits = (PyLongObject *)PyNumber_Index(o_ndigits);
4233 if (ndigits == NULL)
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004234 return NULL;
Mark Dickinson1124e712009-01-28 21:25:58 +00004235
4236 if (Py_SIZE(ndigits) >= 0) {
4237 Py_DECREF(ndigits);
4238 return long_long(self);
4239 }
4240
4241 Py_INCREF(self); /* to keep refcounting simple */
4242 /* we now own references to self, ndigits */
4243
4244 /* pow = 10 ** -ndigits >> 1 */
4245 pow = (PyLongObject *)PyLong_FromLong(10L);
4246 if (pow == NULL)
4247 goto error;
4248 temp = long_neg(ndigits);
4249 Py_DECREF(ndigits);
4250 ndigits = (PyLongObject *)temp;
4251 if (ndigits == NULL)
4252 goto error;
4253 temp = long_pow((PyObject *)pow, (PyObject *)ndigits, Py_None);
4254 Py_DECREF(pow);
4255 pow = (PyLongObject *)temp;
4256 if (pow == NULL)
4257 goto error;
4258 assert(PyLong_Check(pow)); /* check long_pow returned a long */
4259 one = (PyLongObject *)PyLong_FromLong(1L);
4260 if (one == NULL)
4261 goto error;
4262 temp = long_rshift(pow, one);
4263 Py_DECREF(one);
4264 Py_DECREF(pow);
4265 pow = (PyLongObject *)temp;
4266 if (pow == NULL)
4267 goto error;
4268
4269 /* q, r = divmod(self, pow) */
4270 errcode = l_divmod((PyLongObject *)self, pow, &q, &r);
4271 if (errcode == -1)
4272 goto error;
4273
4274 /* self -= r */
4275 temp = long_sub((PyLongObject *)self, r);
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004276 Py_DECREF(self);
Mark Dickinson1124e712009-01-28 21:25:58 +00004277 self = temp;
4278 if (self == NULL)
4279 goto error;
4280
4281 /* get value of quotient modulo 4 */
4282 if (Py_SIZE(q) == 0)
4283 q_mod_4 = 0;
4284 else if (Py_SIZE(q) > 0)
4285 q_mod_4 = q->ob_digit[0] & 3;
4286 else
4287 q_mod_4 = (PyLong_BASE-q->ob_digit[0]) & 3;
4288
4289 if ((q_mod_4 & 1) == 1) {
4290 /* q is odd; round self up or down by adding or subtracting pow */
4291 if (q_mod_4 == 1 && Py_SIZE(r) == 0)
4292 temp = (PyObject *)long_sub((PyLongObject *)self, pow);
4293 else
4294 temp = (PyObject *)long_add((PyLongObject *)self, pow);
4295 Py_DECREF(self);
4296 self = temp;
4297 if (self == NULL)
4298 goto error;
4299 }
4300 Py_DECREF(q);
4301 Py_DECREF(r);
4302 Py_DECREF(pow);
4303 Py_DECREF(ndigits);
4304 return self;
4305
4306 error:
4307 Py_XDECREF(q);
4308 Py_XDECREF(r);
4309 Py_XDECREF(pow);
4310 Py_XDECREF(self);
4311 Py_XDECREF(ndigits);
4312 return NULL;
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004313}
4314
Martin v. Löwis00709aa2008-06-04 14:18:43 +00004315static PyObject *
4316long_sizeof(PyLongObject *v)
4317{
4318 Py_ssize_t res;
4319
Mark Dickinson5a74bf62009-02-15 11:04:38 +00004320 res = offsetof(PyLongObject, ob_digit) + ABS(Py_SIZE(v))*sizeof(digit);
Martin v. Löwis00709aa2008-06-04 14:18:43 +00004321 return PyLong_FromSsize_t(res);
4322}
4323
Mark Dickinson54bc1ec2008-12-17 16:19:07 +00004324static PyObject *
4325long_bit_length(PyLongObject *v)
4326{
4327 PyLongObject *result, *x, *y;
4328 Py_ssize_t ndigits, msd_bits = 0;
4329 digit msd;
4330
4331 assert(v != NULL);
4332 assert(PyLong_Check(v));
4333
4334 ndigits = ABS(Py_SIZE(v));
4335 if (ndigits == 0)
4336 return PyLong_FromLong(0);
4337
4338 msd = v->ob_digit[ndigits-1];
4339 while (msd >= 32) {
4340 msd_bits += 6;
4341 msd >>= 6;
4342 }
4343 msd_bits += (long)(BitLengthTable[msd]);
4344
4345 if (ndigits <= PY_SSIZE_T_MAX/PyLong_SHIFT)
4346 return PyLong_FromSsize_t((ndigits-1)*PyLong_SHIFT + msd_bits);
4347
4348 /* expression above may overflow; use Python integers instead */
4349 result = (PyLongObject *)PyLong_FromSsize_t(ndigits - 1);
4350 if (result == NULL)
4351 return NULL;
4352 x = (PyLongObject *)PyLong_FromLong(PyLong_SHIFT);
4353 if (x == NULL)
4354 goto error;
4355 y = (PyLongObject *)long_mul(result, x);
4356 Py_DECREF(x);
4357 if (y == NULL)
4358 goto error;
4359 Py_DECREF(result);
4360 result = y;
4361
Stefan Krah0091e5e2010-04-07 08:49:55 +00004362 x = (PyLongObject *)PyLong_FromLong((long)msd_bits);
Mark Dickinson54bc1ec2008-12-17 16:19:07 +00004363 if (x == NULL)
4364 goto error;
4365 y = (PyLongObject *)long_add(result, x);
4366 Py_DECREF(x);
4367 if (y == NULL)
4368 goto error;
4369 Py_DECREF(result);
4370 result = y;
4371
4372 return (PyObject *)result;
4373
4374error:
4375 Py_DECREF(result);
4376 return NULL;
4377}
4378
4379PyDoc_STRVAR(long_bit_length_doc,
4380"int.bit_length() -> int\n\
4381\n\
4382Number of bits necessary to represent self in binary.\n\
4383>>> bin(37)\n\
4384'0b100101'\n\
4385>>> (37).bit_length()\n\
43866");
4387
Christian Heimes53876d92008-04-19 00:31:39 +00004388#if 0
4389static PyObject *
4390long_is_finite(PyObject *v)
4391{
4392 Py_RETURN_TRUE;
4393}
4394#endif
4395
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004396
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004397static PyObject *
4398long_to_bytes(PyLongObject *v, PyObject *args, PyObject *kwds)
4399{
4400 PyObject *byteorder_str;
4401 PyObject *is_signed_obj = NULL;
4402 Py_ssize_t length;
4403 int little_endian;
4404 int is_signed;
4405 PyObject *bytes;
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004406 static char *kwlist[] = {"length", "byteorder", "signed", NULL};
4407
Benjamin Peterson0c0e2292010-01-09 21:50:11 +00004408 if (!PyArg_ParseTupleAndKeywords(args, kwds, "nU|O:to_bytes", kwlist,
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004409 &length, &byteorder_str,
4410 &is_signed_obj))
4411 return NULL;
4412
4413 if (args != NULL && Py_SIZE(args) > 2) {
4414 PyErr_SetString(PyExc_TypeError,
4415 "'signed' is a keyword-only argument");
4416 return NULL;
4417 }
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004418
Benjamin Peterson0c0e2292010-01-09 21:50:11 +00004419 if (!PyUnicode_CompareWithASCIIString(byteorder_str, "little"))
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004420 little_endian = 1;
Benjamin Peterson0c0e2292010-01-09 21:50:11 +00004421 else if (!PyUnicode_CompareWithASCIIString(byteorder_str, "big"))
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004422 little_endian = 0;
4423 else {
4424 PyErr_SetString(PyExc_ValueError,
4425 "byteorder must be either 'little' or 'big'");
4426 return NULL;
4427 }
4428
4429 if (is_signed_obj != NULL) {
4430 int cmp = PyObject_IsTrue(is_signed_obj);
4431 if (cmp < 0)
4432 return NULL;
4433 is_signed = cmp ? 1 : 0;
4434 }
4435 else {
4436 /* If the signed argument was omitted, use False as the
4437 default. */
4438 is_signed = 0;
4439 }
4440
4441 if (length < 0) {
4442 PyErr_SetString(PyExc_ValueError,
4443 "length argument must be non-negative");
4444 return NULL;
4445 }
4446
4447 bytes = PyBytes_FromStringAndSize(NULL, length);
4448 if (bytes == NULL)
4449 return NULL;
4450
4451 if (_PyLong_AsByteArray(v, (unsigned char *)PyBytes_AS_STRING(bytes),
4452 length, little_endian, is_signed) < 0) {
4453 Py_DECREF(bytes);
4454 return NULL;
4455 }
4456
4457 return bytes;
4458}
4459
Mark Dickinson078c2532010-01-30 18:06:17 +00004460PyDoc_STRVAR(long_to_bytes_doc,
4461"int.to_bytes(length, byteorder, *, signed=False) -> bytes\n\
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004462\n\
Mark Dickinson078c2532010-01-30 18:06:17 +00004463Return an array of bytes representing an integer.\n\
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004464\n\
Mark Dickinson078c2532010-01-30 18:06:17 +00004465The integer is represented using length bytes. An OverflowError is\n\
4466raised if the integer is not representable with the given number of\n\
4467bytes.\n\
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004468\n\
4469The byteorder argument determines the byte order used to represent the\n\
4470integer. If byteorder is 'big', the most significant byte is at the\n\
4471beginning of the byte array. If byteorder is 'little', the most\n\
4472significant byte is at the end of the byte array. To request the native\n\
4473byte order of the host system, use `sys.byteorder' as the byte order value.\n\
4474\n\
Mark Dickinson078c2532010-01-30 18:06:17 +00004475The signed keyword-only argument determines whether two's complement is\n\
4476used to represent the integer. If signed is False and a negative integer\n\
4477is given, an OverflowError is raised.");
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004478
4479static PyObject *
4480long_from_bytes(PyTypeObject *type, PyObject *args, PyObject *kwds)
4481{
4482 PyObject *byteorder_str;
4483 PyObject *is_signed_obj = NULL;
4484 int little_endian;
4485 int is_signed;
4486 PyObject *obj;
4487 PyObject *bytes;
4488 PyObject *long_obj;
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004489 static char *kwlist[] = {"bytes", "byteorder", "signed", NULL};
4490
Benjamin Peterson0c0e2292010-01-09 21:50:11 +00004491 if (!PyArg_ParseTupleAndKeywords(args, kwds, "OU|O:from_bytes", kwlist,
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004492 &obj, &byteorder_str,
4493 &is_signed_obj))
4494 return NULL;
4495
4496 if (args != NULL && Py_SIZE(args) > 2) {
4497 PyErr_SetString(PyExc_TypeError,
4498 "'signed' is a keyword-only argument");
4499 return NULL;
4500 }
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004501
Benjamin Peterson0c0e2292010-01-09 21:50:11 +00004502 if (!PyUnicode_CompareWithASCIIString(byteorder_str, "little"))
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004503 little_endian = 1;
Benjamin Peterson0c0e2292010-01-09 21:50:11 +00004504 else if (!PyUnicode_CompareWithASCIIString(byteorder_str, "big"))
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004505 little_endian = 0;
4506 else {
4507 PyErr_SetString(PyExc_ValueError,
4508 "byteorder must be either 'little' or 'big'");
4509 return NULL;
4510 }
4511
4512 if (is_signed_obj != NULL) {
4513 int cmp = PyObject_IsTrue(is_signed_obj);
4514 if (cmp < 0)
4515 return NULL;
4516 is_signed = cmp ? 1 : 0;
4517 }
4518 else {
4519 /* If the signed argument was omitted, use False as the
4520 default. */
4521 is_signed = 0;
4522 }
4523
4524 bytes = PyObject_Bytes(obj);
4525 if (bytes == NULL)
4526 return NULL;
4527
4528 long_obj = _PyLong_FromByteArray(
4529 (unsigned char *)PyBytes_AS_STRING(bytes), Py_SIZE(bytes),
4530 little_endian, is_signed);
4531 Py_DECREF(bytes);
4532
4533 /* If from_bytes() was used on subclass, allocate new subclass
4534 * instance, initialize it with decoded long value and return it.
4535 */
4536 if (type != &PyLong_Type && PyType_IsSubtype(type, &PyLong_Type)) {
4537 PyLongObject *newobj;
4538 int i;
4539 Py_ssize_t n = ABS(Py_SIZE(long_obj));
4540
4541 newobj = (PyLongObject *)type->tp_alloc(type, n);
4542 if (newobj == NULL) {
4543 Py_DECREF(long_obj);
4544 return NULL;
4545 }
4546 assert(PyLong_Check(newobj));
4547 Py_SIZE(newobj) = Py_SIZE(long_obj);
4548 for (i = 0; i < n; i++) {
4549 newobj->ob_digit[i] =
4550 ((PyLongObject *)long_obj)->ob_digit[i];
4551 }
4552 Py_DECREF(long_obj);
4553 return (PyObject *)newobj;
4554 }
4555
4556 return long_obj;
4557}
4558
Mark Dickinson078c2532010-01-30 18:06:17 +00004559PyDoc_STRVAR(long_from_bytes_doc,
4560"int.from_bytes(bytes, byteorder, *, signed=False) -> int\n\
4561\n\
4562Return the integer represented by the given array of bytes.\n\
4563\n\
4564The bytes argument must either support the buffer protocol or be an\n\
4565iterable object producing bytes. Bytes and bytearray are examples of\n\
4566built-in objects that support the buffer protocol.\n\
4567\n\
4568The byteorder argument determines the byte order used to represent the\n\
4569integer. If byteorder is 'big', the most significant byte is at the\n\
4570beginning of the byte array. If byteorder is 'little', the most\n\
4571significant byte is at the end of the byte array. To request the native\n\
4572byte order of the host system, use `sys.byteorder' as the byte order value.\n\
4573\n\
4574The signed keyword-only argument indicates whether two's complement is\n\
4575used to represent the integer.");
4576
Guido van Rossum5d9113d2003-01-29 17:58:45 +00004577static PyMethodDef long_methods[] = {
Guido van Rossumb43daf72007-08-01 18:08:08 +00004578 {"conjugate", (PyCFunction)long_long, METH_NOARGS,
4579 "Returns self, the complex conjugate of any int."},
Mark Dickinson54bc1ec2008-12-17 16:19:07 +00004580 {"bit_length", (PyCFunction)long_bit_length, METH_NOARGS,
4581 long_bit_length_doc},
Christian Heimes53876d92008-04-19 00:31:39 +00004582#if 0
4583 {"is_finite", (PyCFunction)long_is_finite, METH_NOARGS,
4584 "Returns always True."},
4585#endif
Alexandre Vassalottic36c3782010-01-09 20:35:09 +00004586 {"to_bytes", (PyCFunction)long_to_bytes,
4587 METH_VARARGS|METH_KEYWORDS, long_to_bytes_doc},
4588 {"from_bytes", (PyCFunction)long_from_bytes,
4589 METH_VARARGS|METH_KEYWORDS|METH_CLASS, long_from_bytes_doc},
Guido van Rossum2fa33db2007-08-23 22:07:24 +00004590 {"__trunc__", (PyCFunction)long_long, METH_NOARGS,
4591 "Truncating an Integral returns itself."},
4592 {"__floor__", (PyCFunction)long_long, METH_NOARGS,
4593 "Flooring an Integral returns itself."},
4594 {"__ceil__", (PyCFunction)long_long, METH_NOARGS,
4595 "Ceiling of an Integral returns itself."},
4596 {"__round__", (PyCFunction)long_round, METH_VARARGS,
Mark Dickinson1124e712009-01-28 21:25:58 +00004597 "Rounding an Integral returns itself.\n"
4598 "Rounding with an ndigits argument also returns an integer."},
Guido van Rossum5d9113d2003-01-29 17:58:45 +00004599 {"__getnewargs__", (PyCFunction)long_getnewargs, METH_NOARGS},
Eric Smith8c663262007-08-25 02:26:07 +00004600 {"__format__", (PyCFunction)long__format__, METH_VARARGS},
Martin v. Löwis00709aa2008-06-04 14:18:43 +00004601 {"__sizeof__", (PyCFunction)long_sizeof, METH_NOARGS,
4602 "Returns size in memory, in bytes"},
Guido van Rossum5d9113d2003-01-29 17:58:45 +00004603 {NULL, NULL} /* sentinel */
4604};
4605
Guido van Rossumb43daf72007-08-01 18:08:08 +00004606static PyGetSetDef long_getset[] = {
Mark Dickinson6bf19002009-05-02 17:57:52 +00004607 {"real",
Guido van Rossumb43daf72007-08-01 18:08:08 +00004608 (getter)long_long, (setter)NULL,
4609 "the real part of a complex number",
4610 NULL},
Mark Dickinson6bf19002009-05-02 17:57:52 +00004611 {"imag",
4612 (getter)long_get0, (setter)NULL,
Guido van Rossumb43daf72007-08-01 18:08:08 +00004613 "the imaginary part of a complex number",
Mark Dickinson6bf19002009-05-02 17:57:52 +00004614 NULL},
4615 {"numerator",
Guido van Rossumb43daf72007-08-01 18:08:08 +00004616 (getter)long_long, (setter)NULL,
4617 "the numerator of a rational number in lowest terms",
4618 NULL},
Mark Dickinson6bf19002009-05-02 17:57:52 +00004619 {"denominator",
4620 (getter)long_get1, (setter)NULL,
Guido van Rossumb43daf72007-08-01 18:08:08 +00004621 "the denominator of a rational number in lowest terms",
Mark Dickinson6bf19002009-05-02 17:57:52 +00004622 NULL},
Guido van Rossumb43daf72007-08-01 18:08:08 +00004623 {NULL} /* Sentinel */
4624};
4625
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00004626PyDoc_STRVAR(long_doc,
Guido van Rossumddefaf32007-01-14 03:31:43 +00004627"int(x[, base]) -> integer\n\
Tim Peters6d6c1a32001-08-02 04:15:00 +00004628\n\
Guido van Rossumddefaf32007-01-14 03:31:43 +00004629Convert a string or number to an integer, if possible. A floating\n\
Tim Peters6d6c1a32001-08-02 04:15:00 +00004630point argument will be truncated towards zero (this does not include a\n\
4631string representation of a floating point number!) When converting a\n\
4632string, use the optional base. It is an error to supply a base when\n\
Martin v. Löwis14f8b4c2002-06-13 20:33:02 +00004633converting a non-string.");
Tim Peters6d6c1a32001-08-02 04:15:00 +00004634
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004635static PyNumberMethods long_as_number = {
Tim Peters9f688bf2000-07-07 15:53:28 +00004636 (binaryfunc) long_add, /*nb_add*/
4637 (binaryfunc) long_sub, /*nb_subtract*/
4638 (binaryfunc) long_mul, /*nb_multiply*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004639 long_mod, /*nb_remainder*/
4640 long_divmod, /*nb_divmod*/
4641 long_pow, /*nb_power*/
Tim Peters9f688bf2000-07-07 15:53:28 +00004642 (unaryfunc) long_neg, /*nb_negative*/
Guido van Rossumb43daf72007-08-01 18:08:08 +00004643 (unaryfunc) long_long, /*tp_positive*/
Tim Peters9f688bf2000-07-07 15:53:28 +00004644 (unaryfunc) long_abs, /*tp_absolute*/
Jack Diederich4dafcc42006-11-28 19:15:13 +00004645 (inquiry) long_bool, /*tp_bool*/
Tim Peters9f688bf2000-07-07 15:53:28 +00004646 (unaryfunc) long_invert, /*nb_invert*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004647 long_lshift, /*nb_lshift*/
Tim Peters9f688bf2000-07-07 15:53:28 +00004648 (binaryfunc) long_rshift, /*nb_rshift*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004649 long_and, /*nb_and*/
4650 long_xor, /*nb_xor*/
4651 long_or, /*nb_or*/
Guido van Rossumb43daf72007-08-01 18:08:08 +00004652 long_long, /*nb_int*/
Mark Dickinson8055afd2009-01-17 10:04:45 +00004653 0, /*nb_reserved*/
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004654 long_float, /*nb_float*/
Guido van Rossum4668b002001-08-08 05:00:18 +00004655 0, /* nb_inplace_add */
4656 0, /* nb_inplace_subtract */
4657 0, /* nb_inplace_multiply */
Guido van Rossum4668b002001-08-08 05:00:18 +00004658 0, /* nb_inplace_remainder */
4659 0, /* nb_inplace_power */
4660 0, /* nb_inplace_lshift */
4661 0, /* nb_inplace_rshift */
4662 0, /* nb_inplace_and */
4663 0, /* nb_inplace_xor */
4664 0, /* nb_inplace_or */
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004665 long_div, /* nb_floor_divide */
Guido van Rossum4668b002001-08-08 05:00:18 +00004666 long_true_divide, /* nb_true_divide */
4667 0, /* nb_inplace_floor_divide */
4668 0, /* nb_inplace_true_divide */
Thomas Wouters00ee7ba2006-08-21 19:07:27 +00004669 long_long, /* nb_index */
Guido van Rossumedcc38a1991-05-05 20:09:44 +00004670};
4671
Guido van Rossumc0b618a1997-05-02 03:12:38 +00004672PyTypeObject PyLong_Type = {
Martin v. Löwis9f2e3462007-07-21 17:22:18 +00004673 PyVarObject_HEAD_INIT(&PyType_Type, 0)
Guido van Rossumddefaf32007-01-14 03:31:43 +00004674 "int", /* tp_name */
Mark Dickinson5a74bf62009-02-15 11:04:38 +00004675 offsetof(PyLongObject, ob_digit), /* tp_basicsize */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004676 sizeof(digit), /* tp_itemsize */
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00004677 long_dealloc, /* tp_dealloc */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004678 0, /* tp_print */
4679 0, /* tp_getattr */
4680 0, /* tp_setattr */
Mark Dickinsone94c6792009-02-02 20:36:42 +00004681 0, /* tp_reserved */
Mark Dickinson2031d132009-09-17 00:17:48 +00004682 long_to_decimal_string, /* tp_repr */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004683 &long_as_number, /* tp_as_number */
4684 0, /* tp_as_sequence */
4685 0, /* tp_as_mapping */
4686 (hashfunc)long_hash, /* tp_hash */
Mark Dickinson5a74bf62009-02-15 11:04:38 +00004687 0, /* tp_call */
Mark Dickinson2031d132009-09-17 00:17:48 +00004688 long_to_decimal_string, /* tp_str */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004689 PyObject_GenericGetAttr, /* tp_getattro */
4690 0, /* tp_setattro */
4691 0, /* tp_as_buffer */
Thomas Wouters27d517b2007-02-25 20:39:11 +00004692 Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE |
4693 Py_TPFLAGS_LONG_SUBCLASS, /* tp_flags */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004694 long_doc, /* tp_doc */
4695 0, /* tp_traverse */
4696 0, /* tp_clear */
Guido van Rossum47b9ff62006-08-24 00:41:19 +00004697 long_richcompare, /* tp_richcompare */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004698 0, /* tp_weaklistoffset */
4699 0, /* tp_iter */
4700 0, /* tp_iternext */
Guido van Rossum5d9113d2003-01-29 17:58:45 +00004701 long_methods, /* tp_methods */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004702 0, /* tp_members */
Guido van Rossumb43daf72007-08-01 18:08:08 +00004703 long_getset, /* tp_getset */
Tim Peters6d6c1a32001-08-02 04:15:00 +00004704 0, /* tp_base */
4705 0, /* tp_dict */
4706 0, /* tp_descr_get */
4707 0, /* tp_descr_set */
4708 0, /* tp_dictoffset */
4709 0, /* tp_init */
4710 0, /* tp_alloc */
4711 long_new, /* tp_new */
Mark Dickinson5a74bf62009-02-15 11:04:38 +00004712 PyObject_Del, /* tp_free */
Guido van Rossumedcc38a1991-05-05 20:09:44 +00004713};
Guido van Rossumddefaf32007-01-14 03:31:43 +00004714
Mark Dickinsonbd792642009-03-18 20:06:12 +00004715static PyTypeObject Int_InfoType;
4716
4717PyDoc_STRVAR(int_info__doc__,
4718"sys.int_info\n\
4719\n\
4720A struct sequence that holds information about Python's\n\
4721internal representation of integers. The attributes are read only.");
4722
4723static PyStructSequence_Field int_info_fields[] = {
4724 {"bits_per_digit", "size of a digit in bits"},
4725 {"sizeof_digit", "size in bytes of the C type used to "
4726 "represent a digit"},
4727 {NULL, NULL}
4728};
4729
4730static PyStructSequence_Desc int_info_desc = {
4731 "sys.int_info", /* name */
4732 int_info__doc__, /* doc */
4733 int_info_fields, /* fields */
4734 2 /* number of fields */
4735};
4736
4737PyObject *
4738PyLong_GetInfo(void)
4739{
4740 PyObject* int_info;
4741 int field = 0;
4742 int_info = PyStructSequence_New(&Int_InfoType);
4743 if (int_info == NULL)
4744 return NULL;
Mark Dickinson0bdab682009-04-02 18:41:40 +00004745 PyStructSequence_SET_ITEM(int_info, field++,
4746 PyLong_FromLong(PyLong_SHIFT));
4747 PyStructSequence_SET_ITEM(int_info, field++,
4748 PyLong_FromLong(sizeof(digit)));
Mark Dickinsonbd792642009-03-18 20:06:12 +00004749 if (PyErr_Occurred()) {
4750 Py_CLEAR(int_info);
4751 return NULL;
4752 }
4753 return int_info;
4754}
4755
Guido van Rossumddefaf32007-01-14 03:31:43 +00004756int
4757_PyLong_Init(void)
4758{
4759#if NSMALLNEGINTS + NSMALLPOSINTS > 0
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004760 int ival, size;
Guido van Rossumddefaf32007-01-14 03:31:43 +00004761 PyLongObject *v = small_ints;
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004762
4763 for (ival = -NSMALLNEGINTS; ival < NSMALLPOSINTS; ival++, v++) {
4764 size = (ival < 0) ? -1 : ((ival == 0) ? 0 : 1);
4765 if (Py_TYPE(v) == &PyLong_Type) {
4766 /* The element is already initialized, most likely
4767 * the Python interpreter was initialized before.
4768 */
Christian Heimes48aa4b12008-02-01 16:56:30 +00004769 Py_ssize_t refcnt;
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004770 PyObject* op = (PyObject*)v;
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004771
Christian Heimes48aa4b12008-02-01 16:56:30 +00004772 refcnt = Py_REFCNT(op) < 0 ? 0 : Py_REFCNT(op);
4773 _Py_NewReference(op);
4774 /* _Py_NewReference sets the ref count to 1 but
4775 * the ref count might be larger. Set the refcnt
4776 * to the original refcnt + 1 */
4777 Py_REFCNT(op) = refcnt + 1;
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004778 assert(Py_SIZE(op) == size);
4779 assert(v->ob_digit[0] == abs(ival));
4780 }
4781 else {
4782 PyObject_INIT(v, &PyLong_Type);
4783 }
4784 Py_SIZE(v) = size;
4785 v->ob_digit[0] = abs(ival);
Guido van Rossumddefaf32007-01-14 03:31:43 +00004786 }
4787#endif
Mark Dickinsonbd792642009-03-18 20:06:12 +00004788 /* initialize int_info */
4789 if (Int_InfoType.tp_name == 0)
4790 PyStructSequence_InitType(&Int_InfoType, &int_info_desc);
4791
Guido van Rossumddefaf32007-01-14 03:31:43 +00004792 return 1;
4793}
4794
4795void
4796PyLong_Fini(void)
4797{
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004798 /* Integers are currently statically allocated. Py_DECREF is not
4799 needed, but Python must forget about the reference or multiple
4800 reinitializations will fail. */
Guido van Rossumddefaf32007-01-14 03:31:43 +00004801#if NSMALLNEGINTS + NSMALLPOSINTS > 0
Christian Heimesdfc12ed2008-01-31 15:16:38 +00004802 int i;
4803 PyLongObject *v = small_ints;
4804 for (i = 0; i < NSMALLNEGINTS + NSMALLPOSINTS; i++, v++) {
4805 _Py_DEC_REFTOTAL;
4806 _Py_ForgetReference((PyObject*)v);
4807 }
Guido van Rossumddefaf32007-01-14 03:31:43 +00004808#endif
4809}