14710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
24710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm/* Integer object interface */
34710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
44710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm/*
54710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyIntObject represents a (long) integer.  This is an immutable object;
64710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylman integer cannot change its value after creation.
74710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
84710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmThere are functions to create new integer objects, to test an object
94710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmfor integer-ness, and to get the integer value.  The latter functions
104710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmreturns -1 and sets errno to EBADF if the object is not an PyIntObject.
114710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmNone of the functions should be applied to nil objects.
124710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
134710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmThe type PyIntObject is (unfortunately) exposed here so we can declare
144710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm_Py_TrueStruct and _Py_ZeroStruct in boolobject.h; don't use this.
154710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm*/
164710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
174710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#ifndef Py_INTOBJECT_H
184710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#define Py_INTOBJECT_H
194710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#ifdef __cplusplus
204710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmextern "C" {
214710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#endif
224710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
234710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmtypedef struct {
244710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm    PyObject_HEAD
254710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm    long ob_ival;
264710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm} PyIntObject;
274710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
284710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_DATA(PyTypeObject) PyInt_Type;
294710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
304710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#define PyInt_Check(op) \
314710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm		 PyType_FastSubclass((op)->ob_type, Py_TPFLAGS_INT_SUBCLASS)
324710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#define PyInt_CheckExact(op) ((op)->ob_type == &PyInt_Type)
334710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
344710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(PyObject *) PyInt_FromString(char*, char**, int);
354710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#ifdef Py_USING_UNICODE
364710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(PyObject *) PyInt_FromUnicode(Py_UNICODE*, Py_ssize_t, int);
374710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#endif
384710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(PyObject *) PyInt_FromLong(long);
394710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(PyObject *) PyInt_FromSize_t(size_t);
404710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(PyObject *) PyInt_FromSsize_t(Py_ssize_t);
414710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(long) PyInt_AsLong(PyObject *);
424710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(Py_ssize_t) PyInt_AsSsize_t(PyObject *);
434710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(unsigned long) PyInt_AsUnsignedLongMask(PyObject *);
444710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#ifdef HAVE_LONG_LONG
454710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(unsigned PY_LONG_LONG) PyInt_AsUnsignedLongLongMask(PyObject *);
464710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#endif
474710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
484710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(long) PyInt_GetMax(void);
494710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
504710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm/* Macro, trading safety for speed */
514710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#define PyInt_AS_LONG(op) (((PyIntObject *)(op))->ob_ival)
524710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
534710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm/* These aren't really part of the Int object, but they're handy; the protos
544710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm * are necessary for systems that need the magic of PyAPI_FUNC and that want
554710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm * to have stropmodule as a dynamically loaded module instead of building it
564710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm * into the main Python shared library/DLL.  Guido thinks I'm weird for
574710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm * building it this way.  :-)  [cjh]
584710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm */
594710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(unsigned long) PyOS_strtoul(char *, char **, int);
604710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(long) PyOS_strtol(char *, char **, int);
614710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
624710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm/* free list api */
634710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(int) PyInt_ClearFreeList(void);
644710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
654710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm/* Convert an integer to the given base.  Returns a string.
664710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm   If base is 2, 8 or 16, add the proper prefix '0b', '0o' or '0x'.
674710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm   If newstyle is zero, then use the pre-2.6 behavior of octal having
684710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm   a leading "0" */
694710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(PyObject*) _PyInt_Format(PyIntObject* v, int base, int newstyle);
704710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
714710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm/* Format the object based on the format_spec, as defined in PEP 3101
724710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm   (Advanced String Formatting). */
734710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(PyObject *) _PyInt_FormatAdvanced(PyObject *obj,
744710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm					     char *format_spec,
754710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm					     Py_ssize_t format_spec_len);
764710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm
774710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#ifdef __cplusplus
784710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm}
794710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#endif
804710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#endif /* !Py_INTOBJECT_H */
81