Mercurial > cpython-lru_cache-weakref
annotate Include/longobject.h @ 58765:2ba7677bfa95 legacy-trunk
testCopysign was defined twice in test_math; combine the definitions
| author | Mark Dickinson <dickinsm@gmail.com> |
|---|---|
| date | Sat, 06 Feb 2010 23:11:25 +0000 |
| parents | 6295e16303a7 |
| children | d544873d62e9 |
| rev | line source |
|---|---|
|
1329
519c25039c6a
* Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents:
1257
diff
changeset
|
1 #ifndef Py_LONGOBJECT_H |
|
519c25039c6a
* Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents:
1257
diff
changeset
|
2 #define Py_LONGOBJECT_H |
|
519c25039c6a
* Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents:
1257
diff
changeset
|
3 #ifdef __cplusplus |
|
519c25039c6a
* Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents:
1257
diff
changeset
|
4 extern "C" { |
|
519c25039c6a
* Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents:
1257
diff
changeset
|
5 #endif |
|
519c25039c6a
* Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents:
1257
diff
changeset
|
6 |
| 230 | 7 |
| 8 /* Long (arbitrary precision) integer object interface */ | |
| 9 | |
|
2129
05360cd616ae
The great renaming, phase two: all header files have been updated to
Guido van Rossum <guido@python.org>
parents:
2058
diff
changeset
|
10 typedef struct _longobject PyLongObject; /* Revealed in longintrepr.h */ |
|
614
11e86270ed0d
Added typedef for longobject and declarations for long_{format,scan}.
Guido van Rossum <guido@python.org>
parents:
255
diff
changeset
|
11 |
|
24752
c1eb668525e1
Excise DL_EXPORT from Include.
Mark Hammond <mhammond@skippinet.com.au>
parents:
24210
diff
changeset
|
12 PyAPI_DATA(PyTypeObject) PyLong_Type; |
| 230 | 13 |
|
40908
d01bd37bf5ce
Variation of patch # 1624059 to speed up checking if an object is a subclass
Neal Norwitz <nnorwitz@gmail.com>
parents:
38301
diff
changeset
|
14 #define PyLong_Check(op) \ |
|
44350
26384b8180c7
#1629: Renamed Py_Size, Py_Type and Py_Refcnt to Py_SIZE, Py_TYPE and Py_REFCNT. Macros for b/w compatibility are available.
Christian Heimes <christian@cheimes.de>
parents:
42333
diff
changeset
|
15 PyType_FastSubclass(Py_TYPE(op), Py_TPFLAGS_LONG_SUBCLASS) |
|
26384b8180c7
#1629: Renamed Py_Size, Py_Type and Py_Refcnt to Py_SIZE, Py_TYPE and Py_REFCNT. Macros for b/w compatibility are available.
Christian Heimes <christian@cheimes.de>
parents:
42333
diff
changeset
|
16 #define PyLong_CheckExact(op) (Py_TYPE(op) == &PyLong_Type) |
| 230 | 17 |
|
24752
c1eb668525e1
Excise DL_EXPORT from Include.
Mark Hammond <mhammond@skippinet.com.au>
parents:
24210
diff
changeset
|
18 PyAPI_FUNC(PyObject *) PyLong_FromLong(long); |
|
c1eb668525e1
Excise DL_EXPORT from Include.
Mark Hammond <mhammond@skippinet.com.au>
parents:
24210
diff
changeset
|
19 PyAPI_FUNC(PyObject *) PyLong_FromUnsignedLong(unsigned long); |
|
c1eb668525e1
Excise DL_EXPORT from Include.
Mark Hammond <mhammond@skippinet.com.au>
parents:
24210
diff
changeset
|
20 PyAPI_FUNC(PyObject *) PyLong_FromDouble(double); |
|
44945
bbc719a8b58b
Backport of several functions from Python 3.0 to 2.6 including PyUnicode_FromString, PyUnicode_Format and PyLong_From/AsSsize_t. The functions are partly required for the backport of the bytearray type and _fileio module. They should also make it easier to port C to 3.0.
Christian Heimes <christian@cheimes.de>
parents:
44350
diff
changeset
|
21 PyAPI_FUNC(PyObject *) PyLong_FromSize_t(size_t); |
|
bbc719a8b58b
Backport of several functions from Python 3.0 to 2.6 including PyUnicode_FromString, PyUnicode_Format and PyLong_From/AsSsize_t. The functions are partly required for the backport of the bytearray type and _fileio module. They should also make it easier to port C to 3.0.
Christian Heimes <christian@cheimes.de>
parents:
44350
diff
changeset
|
22 PyAPI_FUNC(PyObject *) PyLong_FromSsize_t(Py_ssize_t); |
|
24752
c1eb668525e1
Excise DL_EXPORT from Include.
Mark Hammond <mhammond@skippinet.com.au>
parents:
24210
diff
changeset
|
23 PyAPI_FUNC(long) PyLong_AsLong(PyObject *); |
|
57851
28de83f17d08
Issue #7528: Backport PyLong_AsLongAndOverflow from py3k to trunk.
Mark Dickinson <dickinsm@gmail.com>
parents:
52233
diff
changeset
|
24 PyAPI_FUNC(long) PyLong_AsLongAndOverflow(PyObject *, int *); |
|
24752
c1eb668525e1
Excise DL_EXPORT from Include.
Mark Hammond <mhammond@skippinet.com.au>
parents:
24210
diff
changeset
|
25 PyAPI_FUNC(unsigned long) PyLong_AsUnsignedLong(PyObject *); |
|
28652
28a2975514cd
SF # 595026: support for masks in getargs.c.
Thomas Heller <theller@ctypes.org>
parents:
28437
diff
changeset
|
26 PyAPI_FUNC(unsigned long) PyLong_AsUnsignedLongMask(PyObject *); |
|
44945
bbc719a8b58b
Backport of several functions from Python 3.0 to 2.6 including PyUnicode_FromString, PyUnicode_Format and PyLong_From/AsSsize_t. The functions are partly required for the backport of the bytearray type and _fileio module. They should also make it easier to port C to 3.0.
Christian Heimes <christian@cheimes.de>
parents:
44350
diff
changeset
|
27 PyAPI_FUNC(Py_ssize_t) PyLong_AsSsize_t(PyObject *); |
|
52233
9b358eae532a
Issue #4258: Use 30-bit digits for Python longs, on 64-bit platforms.
Mark Dickinson <dickinsm@gmail.com>
parents:
47392
diff
changeset
|
28 PyAPI_FUNC(PyObject *) PyLong_GetInfo(void); |
|
19671
7df300d284c6
Introduce new private API function _PyLong_AsScaledDouble. Not used yet,
Tim Peters <tim.peters@gmail.com>
parents:
19550
diff
changeset
|
29 |
|
36501
7fdc639bc5b4
Merge ssize_t branch.
Martin v. Löwis <martin@v.loewis.de>
parents:
33540
diff
changeset
|
30 /* For use by intobject.c only */ |
|
44945
bbc719a8b58b
Backport of several functions from Python 3.0 to 2.6 including PyUnicode_FromString, PyUnicode_Format and PyLong_From/AsSsize_t. The functions are partly required for the backport of the bytearray type and _fileio module. They should also make it easier to port C to 3.0.
Christian Heimes <christian@cheimes.de>
parents:
44350
diff
changeset
|
31 #define _PyLong_AsSsize_t PyLong_AsSsize_t |
|
bbc719a8b58b
Backport of several functions from Python 3.0 to 2.6 including PyUnicode_FromString, PyUnicode_Format and PyLong_From/AsSsize_t. The functions are partly required for the backport of the bytearray type and _fileio module. They should also make it easier to port C to 3.0.
Christian Heimes <christian@cheimes.de>
parents:
44350
diff
changeset
|
32 #define _PyLong_FromSize_t PyLong_FromSize_t |
|
bbc719a8b58b
Backport of several functions from Python 3.0 to 2.6 including PyUnicode_FromString, PyUnicode_Format and PyLong_From/AsSsize_t. The functions are partly required for the backport of the bytearray type and _fileio module. They should also make it easier to port C to 3.0.
Christian Heimes <christian@cheimes.de>
parents:
44350
diff
changeset
|
33 #define _PyLong_FromSsize_t PyLong_FromSsize_t |
|
38301
dccbcbbd6720
A new table to help string->integer conversion was added yesterday to
Tim Peters <tim.peters@gmail.com>
parents:
36501
diff
changeset
|
34 PyAPI_DATA(int) _PyLong_DigitValue[256]; |
|
36501
7fdc639bc5b4
Merge ssize_t branch.
Martin v. Löwis <martin@v.loewis.de>
parents:
33540
diff
changeset
|
35 |
|
58085
27c946ff76a3
Refactor some longobject internals: PyLong_AsDouble and _PyLong_AsScaledDouble
Mark Dickinson <dickinsm@gmail.com>
parents:
57851
diff
changeset
|
36 /* _PyLong_Frexp returns a double x and an exponent e such that the |
|
27c946ff76a3
Refactor some longobject internals: PyLong_AsDouble and _PyLong_AsScaledDouble
Mark Dickinson <dickinsm@gmail.com>
parents:
57851
diff
changeset
|
37 true value is approximately equal to x * 2**e. e is >= 0. x is |
|
27c946ff76a3
Refactor some longobject internals: PyLong_AsDouble and _PyLong_AsScaledDouble
Mark Dickinson <dickinsm@gmail.com>
parents:
57851
diff
changeset
|
38 0.0 if and only if the input is 0 (in which case, e and x are both |
|
27c946ff76a3
Refactor some longobject internals: PyLong_AsDouble and _PyLong_AsScaledDouble
Mark Dickinson <dickinsm@gmail.com>
parents:
57851
diff
changeset
|
39 zeroes); otherwise, 0.5 <= abs(x) < 1.0. On overflow, which is |
|
27c946ff76a3
Refactor some longobject internals: PyLong_AsDouble and _PyLong_AsScaledDouble
Mark Dickinson <dickinsm@gmail.com>
parents:
57851
diff
changeset
|
40 possible if the number of bits doesn't fit into a Py_ssize_t, sets |
|
27c946ff76a3
Refactor some longobject internals: PyLong_AsDouble and _PyLong_AsScaledDouble
Mark Dickinson <dickinsm@gmail.com>
parents:
57851
diff
changeset
|
41 OverflowError and returns -1.0 for x, 0 for e. */ |
|
27c946ff76a3
Refactor some longobject internals: PyLong_AsDouble and _PyLong_AsScaledDouble
Mark Dickinson <dickinsm@gmail.com>
parents:
57851
diff
changeset
|
42 PyAPI_FUNC(double) _PyLong_Frexp(PyLongObject *a, Py_ssize_t *e); |
|
19671
7df300d284c6
Introduce new private API function _PyLong_AsScaledDouble. Not used yet,
Tim Peters <tim.peters@gmail.com>
parents:
19550
diff
changeset
|
43 |
|
24752
c1eb668525e1
Excise DL_EXPORT from Include.
Mark Hammond <mhammond@skippinet.com.au>
parents:
24210
diff
changeset
|
44 PyAPI_FUNC(double) PyLong_AsDouble(PyObject *); |
|
c1eb668525e1
Excise DL_EXPORT from Include.
Mark Hammond <mhammond@skippinet.com.au>
parents:
24210
diff
changeset
|
45 PyAPI_FUNC(PyObject *) PyLong_FromVoidPtr(void *); |
|
c1eb668525e1
Excise DL_EXPORT from Include.
Mark Hammond <mhammond@skippinet.com.au>
parents:
24210
diff
changeset
|
46 PyAPI_FUNC(void *) PyLong_AsVoidPtr(PyObject *); |
|
614
11e86270ed0d
Added typedef for longobject and declarations for long_{format,scan}.
Guido van Rossum <guido@python.org>
parents:
255
diff
changeset
|
47 |
|
8822
bd47ee068b83
Changes for BeOS, QNX and long long, by Chris Herborth.
Guido van Rossum <guido@python.org>
parents:
4870
diff
changeset
|
48 #ifdef HAVE_LONG_LONG |
|
28437
871da703e4c0
Rename LONG_LONG to PY_LONG_LONG. Fixes #710285.
Martin v. Löwis <martin@v.loewis.de>
parents:
27549
diff
changeset
|
49 PyAPI_FUNC(PyObject *) PyLong_FromLongLong(PY_LONG_LONG); |
|
871da703e4c0
Rename LONG_LONG to PY_LONG_LONG. Fixes #710285.
Martin v. Löwis <martin@v.loewis.de>
parents:
27549
diff
changeset
|
50 PyAPI_FUNC(PyObject *) PyLong_FromUnsignedLongLong(unsigned PY_LONG_LONG); |
|
871da703e4c0
Rename LONG_LONG to PY_LONG_LONG. Fixes #710285.
Martin v. Löwis <martin@v.loewis.de>
parents:
27549
diff
changeset
|
51 PyAPI_FUNC(PY_LONG_LONG) PyLong_AsLongLong(PyObject *); |
|
871da703e4c0
Rename LONG_LONG to PY_LONG_LONG. Fixes #710285.
Martin v. Löwis <martin@v.loewis.de>
parents:
27549
diff
changeset
|
52 PyAPI_FUNC(unsigned PY_LONG_LONG) PyLong_AsUnsignedLongLong(PyObject *); |
|
28652
28a2975514cd
SF # 595026: support for masks in getargs.c.
Thomas Heller <theller@ctypes.org>
parents:
28437
diff
changeset
|
53 PyAPI_FUNC(unsigned PY_LONG_LONG) PyLong_AsUnsignedLongLongMask(PyObject *); |
|
58581
6295e16303a7
Issue #7767: Add new C-API function PyLong_AsLongLongAndOverflow, a
Mark Dickinson <dickinsm@gmail.com>
parents:
58085
diff
changeset
|
54 PyAPI_FUNC(PY_LONG_LONG) PyLong_AsLongLongAndOverflow(PyObject *, int *); |
|
9044
d437b6683e24
Patch by Mark Hammond to support 64-bit ints on MS platforms.
Guido van Rossum <guido@python.org>
parents:
8822
diff
changeset
|
55 #endif /* HAVE_LONG_LONG */ |
|
8822
bd47ee068b83
Changes for BeOS, QNX and long long, by Chris Herborth.
Guido van Rossum <guido@python.org>
parents:
4870
diff
changeset
|
56 |
|
24752
c1eb668525e1
Excise DL_EXPORT from Include.
Mark Hammond <mhammond@skippinet.com.au>
parents:
24210
diff
changeset
|
57 PyAPI_FUNC(PyObject *) PyLong_FromString(char *, char **, int); |
|
19343
7257e87e0720
Patch #445762: Support --disable-unicode
Martin v. Löwis <martin@v.loewis.de>
parents:
18082
diff
changeset
|
58 #ifdef Py_USING_UNICODE |
|
36501
7fdc639bc5b4
Merge ssize_t branch.
Martin v. Löwis <martin@v.loewis.de>
parents:
33540
diff
changeset
|
59 PyAPI_FUNC(PyObject *) PyLong_FromUnicode(Py_UNICODE*, Py_ssize_t, int); |
|
19343
7257e87e0720
Patch #445762: Support --disable-unicode
Martin v. Löwis <martin@v.loewis.de>
parents:
18082
diff
changeset
|
60 #endif |
|
1329
519c25039c6a
* Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents:
1257
diff
changeset
|
61 |
|
27549
7fcdeeb16ec0
_PyLong_NumBits(): The definition of this was too specific to the quirky
Tim Peters <tim.peters@gmail.com>
parents:
27487
diff
changeset
|
62 /* _PyLong_Sign. Return 0 if v is 0, -1 if v < 0, +1 if v > 0. |
|
7fcdeeb16ec0
_PyLong_NumBits(): The definition of this was too specific to the quirky
Tim Peters <tim.peters@gmail.com>
parents:
27487
diff
changeset
|
63 v must not be NULL, and must be a normalized long. |
|
7fcdeeb16ec0
_PyLong_NumBits(): The definition of this was too specific to the quirky
Tim Peters <tim.peters@gmail.com>
parents:
27487
diff
changeset
|
64 There are no error cases. |
|
7fcdeeb16ec0
_PyLong_NumBits(): The definition of this was too specific to the quirky
Tim Peters <tim.peters@gmail.com>
parents:
27487
diff
changeset
|
65 */ |
|
7fcdeeb16ec0
_PyLong_NumBits(): The definition of this was too specific to the quirky
Tim Peters <tim.peters@gmail.com>
parents:
27487
diff
changeset
|
66 PyAPI_FUNC(int) _PyLong_Sign(PyObject *v); |
|
7fcdeeb16ec0
_PyLong_NumBits(): The definition of this was too specific to the quirky
Tim Peters <tim.peters@gmail.com>
parents:
27487
diff
changeset
|
67 |
|
7fcdeeb16ec0
_PyLong_NumBits(): The definition of this was too specific to the quirky
Tim Peters <tim.peters@gmail.com>
parents:
27487
diff
changeset
|
68 |
|
7fcdeeb16ec0
_PyLong_NumBits(): The definition of this was too specific to the quirky
Tim Peters <tim.peters@gmail.com>
parents:
27487
diff
changeset
|
69 /* _PyLong_NumBits. Return the number of bits needed to represent the |
|
7fcdeeb16ec0
_PyLong_NumBits(): The definition of this was too specific to the quirky
Tim Peters <tim.peters@gmail.com>
parents:
27487
diff
changeset
|
70 absolute value of a long. For example, this returns 1 for 1 and -1, 2 |
|
7fcdeeb16ec0
_PyLong_NumBits(): The definition of this was too specific to the quirky
Tim Peters <tim.peters@gmail.com>
parents:
27487
diff
changeset
|
71 for 2 and -2, and 2 for 3 and -3. It returns 0 for 0. |
|
27487
0904d878b8f1
Added new private API function _PyLong_NumBits. This will be used at the
Tim Peters <tim.peters@gmail.com>
parents:
24752
diff
changeset
|
72 v must not be NULL, and must be a normalized long. |
|
0904d878b8f1
Added new private API function _PyLong_NumBits. This will be used at the
Tim Peters <tim.peters@gmail.com>
parents:
24752
diff
changeset
|
73 (size_t)-1 is returned and OverflowError set if the true result doesn't |
|
0904d878b8f1
Added new private API function _PyLong_NumBits. This will be used at the
Tim Peters <tim.peters@gmail.com>
parents:
24752
diff
changeset
|
74 fit in a size_t. |
|
0904d878b8f1
Added new private API function _PyLong_NumBits. This will be used at the
Tim Peters <tim.peters@gmail.com>
parents:
24752
diff
changeset
|
75 */ |
|
0904d878b8f1
Added new private API function _PyLong_NumBits. This will be used at the
Tim Peters <tim.peters@gmail.com>
parents:
24752
diff
changeset
|
76 PyAPI_FUNC(size_t) _PyLong_NumBits(PyObject *v); |
|
0904d878b8f1
Added new private API function _PyLong_NumBits. This will be used at the
Tim Peters <tim.peters@gmail.com>
parents:
24752
diff
changeset
|
77 |
|
18082
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
78 /* _PyLong_FromByteArray: View the n unsigned bytes as a binary integer in |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
79 base 256, and return a Python long with the same numeric value. |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
80 If n is 0, the integer is 0. Else: |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
81 If little_endian is 1/true, bytes[n-1] is the MSB and bytes[0] the LSB; |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
82 else (little_endian is 0/false) bytes[0] is the MSB and bytes[n-1] the |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
83 LSB. |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
84 If is_signed is 0/false, view the bytes as a non-negative integer. |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
85 If is_signed is 1/true, view the bytes as a 2's-complement integer, |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
86 non-negative if bit 0x80 of the MSB is clear, negative if set. |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
87 Error returns: |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
88 + Return NULL with the appropriate exception set if there's not |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
89 enough memory to create the Python long. |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
90 */ |
|
24752
c1eb668525e1
Excise DL_EXPORT from Include.
Mark Hammond <mhammond@skippinet.com.au>
parents:
24210
diff
changeset
|
91 PyAPI_FUNC(PyObject *) _PyLong_FromByteArray( |
|
18082
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
92 const unsigned char* bytes, size_t n, |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
93 int little_endian, int is_signed); |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
94 |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
95 /* _PyLong_AsByteArray: Convert the least-significant 8*n bits of long |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
96 v to a base-256 integer, stored in array bytes. Normally return 0, |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
97 return -1 on error. |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
98 If little_endian is 1/true, store the MSB at bytes[n-1] and the LSB at |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
99 bytes[0]; else (little_endian is 0/false) store the MSB at bytes[0] and |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
100 the LSB at bytes[n-1]. |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
101 If is_signed is 0/false, it's an error if v < 0; else (v >= 0) n bytes |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
102 are filled and there's nothing special about bit 0x80 of the MSB. |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
103 If is_signed is 1/true, bytes is filled with the 2's-complement |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
104 representation of v's value. Bit 0x80 of the MSB is the sign bit. |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
105 Error returns (-1): |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
106 + is_signed is 0 and v < 0. TypeError is set in this case, and bytes |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
107 isn't altered. |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
108 + n isn't big enough to hold the full mathematical value of v. For |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
109 example, if is_signed is 0 and there are more digits in the v than |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
110 fit in n; or if is_signed is 1, v < 0, and n is just 1 bit shy of |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
111 being large enough to hold a sign bit. OverflowError is set in this |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
112 case, but bytes holds the least-signficant n bytes of the true value. |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
113 */ |
|
24752
c1eb668525e1
Excise DL_EXPORT from Include.
Mark Hammond <mhammond@skippinet.com.au>
parents:
24210
diff
changeset
|
114 PyAPI_FUNC(int) _PyLong_AsByteArray(PyLongObject* v, |
|
18082
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
115 unsigned char* bytes, size_t n, |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
116 int little_endian, int is_signed); |
|
dd09f11fa40d
Two new private longobject API functions,
Tim Peters <tim.peters@gmail.com>
parents:
14869
diff
changeset
|
117 |
|
45262
86906a5ceca6
Added PyNumber_ToBase and supporting routines _PyInt_Format and
Eric Smith <eric@trueblade.com>
parents:
44945
diff
changeset
|
118 /* _PyLong_Format: Convert the long to a string object with given base, |
|
86906a5ceca6
Added PyNumber_ToBase and supporting routines _PyInt_Format and
Eric Smith <eric@trueblade.com>
parents:
44945
diff
changeset
|
119 appending a base prefix of 0[box] if base is 2, 8 or 16. |
|
86906a5ceca6
Added PyNumber_ToBase and supporting routines _PyInt_Format and
Eric Smith <eric@trueblade.com>
parents:
44945
diff
changeset
|
120 Add a trailing "L" if addL is non-zero. |
|
86906a5ceca6
Added PyNumber_ToBase and supporting routines _PyInt_Format and
Eric Smith <eric@trueblade.com>
parents:
44945
diff
changeset
|
121 If newstyle is zero, then use the pre-2.6 behavior of octal having |
|
86906a5ceca6
Added PyNumber_ToBase and supporting routines _PyInt_Format and
Eric Smith <eric@trueblade.com>
parents:
44945
diff
changeset
|
122 a leading "0", instead of the prefix "0o" */ |
|
86906a5ceca6
Added PyNumber_ToBase and supporting routines _PyInt_Format and
Eric Smith <eric@trueblade.com>
parents:
44945
diff
changeset
|
123 PyAPI_FUNC(PyObject *) _PyLong_Format(PyObject *aa, int base, int addL, int newstyle); |
|
86906a5ceca6
Added PyNumber_ToBase and supporting routines _PyInt_Format and
Eric Smith <eric@trueblade.com>
parents:
44945
diff
changeset
|
124 |
|
47392
47ef9a806ce9
Refactor and clean up str.format() code (and helpers) in advance of optimizations.
Eric Smith <eric@trueblade.com>
parents:
45262
diff
changeset
|
125 /* Format the object based on the format_spec, as defined in PEP 3101 |
|
47ef9a806ce9
Refactor and clean up str.format() code (and helpers) in advance of optimizations.
Eric Smith <eric@trueblade.com>
parents:
45262
diff
changeset
|
126 (Advanced String Formatting). */ |
|
47ef9a806ce9
Refactor and clean up str.format() code (and helpers) in advance of optimizations.
Eric Smith <eric@trueblade.com>
parents:
45262
diff
changeset
|
127 PyAPI_FUNC(PyObject *) _PyLong_FormatAdvanced(PyObject *obj, |
|
47ef9a806ce9
Refactor and clean up str.format() code (and helpers) in advance of optimizations.
Eric Smith <eric@trueblade.com>
parents:
45262
diff
changeset
|
128 char *format_spec, |
|
47ef9a806ce9
Refactor and clean up str.format() code (and helpers) in advance of optimizations.
Eric Smith <eric@trueblade.com>
parents:
45262
diff
changeset
|
129 Py_ssize_t format_spec_len); |
|
47ef9a806ce9
Refactor and clean up str.format() code (and helpers) in advance of optimizations.
Eric Smith <eric@trueblade.com>
parents:
45262
diff
changeset
|
130 |
|
1329
519c25039c6a
* Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents:
1257
diff
changeset
|
131 #ifdef __cplusplus |
|
519c25039c6a
* Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents:
1257
diff
changeset
|
132 } |
|
519c25039c6a
* Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents:
1257
diff
changeset
|
133 #endif |
|
519c25039c6a
* Added support for X11 modules.
Guido van Rossum <guido@python.org>
parents:
1257
diff
changeset
|
134 #endif /* !Py_LONGOBJECT_H */ |
