source: trunk/essentials/dev-lang/python/Include/longobject.h@ 3437

Last change on this file since 3437 was 3225, checked in by bird, 19 years ago

Python 2.5

File size: 4.7 KB
Line 
1#ifndef Py_LONGOBJECT_H
2#define Py_LONGOBJECT_H
3#ifdef __cplusplus
4extern "C" {
5#endif
6
7
8/* Long (arbitrary precision) integer object interface */
9
10typedef struct _longobject PyLongObject; /* Revealed in longintrepr.h */
11
12PyAPI_DATA(PyTypeObject) PyLong_Type;
13
14#define PyLong_Check(op) PyObject_TypeCheck(op, &PyLong_Type)
15#define PyLong_CheckExact(op) ((op)->ob_type == &PyLong_Type)
16
17PyAPI_FUNC(PyObject *) PyLong_FromLong(long);
18PyAPI_FUNC(PyObject *) PyLong_FromUnsignedLong(unsigned long);
19PyAPI_FUNC(PyObject *) PyLong_FromDouble(double);
20PyAPI_FUNC(long) PyLong_AsLong(PyObject *);
21PyAPI_FUNC(unsigned long) PyLong_AsUnsignedLong(PyObject *);
22PyAPI_FUNC(unsigned long) PyLong_AsUnsignedLongMask(PyObject *);
23
24/* For use by intobject.c only */
25PyAPI_FUNC(Py_ssize_t) _PyLong_AsSsize_t(PyObject *);
26PyAPI_FUNC(PyObject *) _PyLong_FromSize_t(size_t);
27PyAPI_FUNC(PyObject *) _PyLong_FromSsize_t(Py_ssize_t);
28PyAPI_DATA(int) _PyLong_DigitValue[256];
29
30/* _PyLong_AsScaledDouble returns a double x and an exponent e such that
31 the true value is approximately equal to x * 2**(SHIFT*e). e is >= 0.
32 x is 0.0 if and only if the input is 0 (in which case, e and x are both
33 zeroes). Overflow is impossible. Note that the exponent returned must
34 be multiplied by SHIFT! There may not be enough room in an int to store
35 e*SHIFT directly. */
36PyAPI_FUNC(double) _PyLong_AsScaledDouble(PyObject *vv, int *e);
37
38PyAPI_FUNC(double) PyLong_AsDouble(PyObject *);
39PyAPI_FUNC(PyObject *) PyLong_FromVoidPtr(void *);
40PyAPI_FUNC(void *) PyLong_AsVoidPtr(PyObject *);
41
42#ifdef HAVE_LONG_LONG
43PyAPI_FUNC(PyObject *) PyLong_FromLongLong(PY_LONG_LONG);
44PyAPI_FUNC(PyObject *) PyLong_FromUnsignedLongLong(unsigned PY_LONG_LONG);
45PyAPI_FUNC(PY_LONG_LONG) PyLong_AsLongLong(PyObject *);
46PyAPI_FUNC(unsigned PY_LONG_LONG) PyLong_AsUnsignedLongLong(PyObject *);
47PyAPI_FUNC(unsigned PY_LONG_LONG) PyLong_AsUnsignedLongLongMask(PyObject *);
48#endif /* HAVE_LONG_LONG */
49
50PyAPI_FUNC(PyObject *) PyLong_FromString(char *, char **, int);
51#ifdef Py_USING_UNICODE
52PyAPI_FUNC(PyObject *) PyLong_FromUnicode(Py_UNICODE*, Py_ssize_t, int);
53#endif
54
55/* _PyLong_Sign. Return 0 if v is 0, -1 if v < 0, +1 if v > 0.
56 v must not be NULL, and must be a normalized long.
57 There are no error cases.
58*/
59PyAPI_FUNC(int) _PyLong_Sign(PyObject *v);
60
61
62/* _PyLong_NumBits. Return the number of bits needed to represent the
63 absolute value of a long. For example, this returns 1 for 1 and -1, 2
64 for 2 and -2, and 2 for 3 and -3. It returns 0 for 0.
65 v must not be NULL, and must be a normalized long.
66 (size_t)-1 is returned and OverflowError set if the true result doesn't
67 fit in a size_t.
68*/
69PyAPI_FUNC(size_t) _PyLong_NumBits(PyObject *v);
70
71/* _PyLong_FromByteArray: View the n unsigned bytes as a binary integer in