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