1 2/* Integer object interface */ 3 4/* 5PyIntObject represents a (long) integer. This is an immutable object; 6an integer cannot change its value after creation. 7 8There are functions to create new integer objects, to test an object 9for integer-ness, and to get the integer value. The latter functions 10returns -1 and sets errno to EBADF if the object is not an PyIntObject. 11None of the functions should be applied to nil objects. 12 13The type PyIntObject is (unfortunately) exposed here so we can declare 14_Py_TrueStruct and _Py_ZeroStruct in boolobject.h; don't use this. 15*/ 16 17#ifndef Py_INTOBJECT_H 18#define Py_INTOBJECT_H 19#ifdef __cplusplus 20extern "C" { 21#endif 22 23typedef struct { 24 PyObject_HEAD 25 long ob_ival; 26} PyIntObject; 27 28PyAPI_DATA(PyTypeObject) PyInt_Type; 29 30#define PyInt_Check(op) \ 31 PyType_FastSubclass((op)->ob_type, Py_TPFLAGS_INT_SUBCLASS) 32#define PyInt_CheckExact(op) ((op)->ob_type == &PyInt_Type) 33 34PyAPI_FUNC(PyObject *) PyInt_FromString(char*, char**, int); 35#ifdef Py_USING_UNICODE 36PyAPI_FUNC(PyObject *) PyInt_FromUnicode(Py_UNICODE*, Py_ssize_t, int); 37#endif 38PyAPI_FUNC(PyObject *) PyInt_FromLong(long); 39PyAPI_FUNC(PyObject *) PyInt_FromSize_t(size_t); 40PyAPI_FUNC(PyObject *) PyInt_FromSsize_t(Py_ssize_t); 41PyAPI_FUNC(long) PyInt_AsLong(PyObject *); 42PyAPI_FUNC(Py_ssize_t) PyInt_AsSsize_t(PyObject *); 43PyAPI_FUNC(int) _PyInt_AsInt(PyObject *); 44PyAPI_FUNC(unsigned long) PyInt_AsUnsignedLongMask(PyObject *); 45#ifdef HAVE_LONG_LONG 46PyAPI_FUNC(unsigned PY_LONG_LONG) PyInt_AsUnsignedLongLongMask(PyObject *); 47#endif 48 49PyAPI_FUNC(long) PyInt_GetMax(void); 50 51/* Macro, trading safety for speed */ 52#define PyInt_AS_LONG(op) (((PyIntObject *)(op))->ob_ival) 53 54/* These aren't really part of the Int object, but they're handy; the protos 55 * are necessary for systems that need the magic of PyAPI_FUNC and that want 56 * to have stropmodule as a dynamically loaded module instead of building it 57 * into the main Python shared library/DLL. Guido thinks I'm weird for 58 * building it this way. :-) [cjh] 59 */ 60PyAPI_FUNC(unsigned long) PyOS_strtoul(char *, char **, int); 61PyAPI_FUNC(long) PyOS_strtol(char *, char **, int); 62 63/* free list api */ 64PyAPI_FUNC(int) PyInt_ClearFreeList(void); 65 66/* Convert an integer to the given base. Returns a string. 67 If base is 2, 8 or 16, add the proper prefix '0b', '0o' or '0x'. 68 If newstyle is zero, then use the pre-2.6 behavior of octal having 69 a leading "0" */ 70PyAPI_FUNC(PyObject*) _PyInt_Format(PyIntObject* v, int base, int newstyle); 71 72/* Format the object based on the format_spec, as defined in PEP 3101 73 (Advanced String Formatting). */ 74PyAPI_FUNC(PyObject *) _PyInt_FormatAdvanced(PyObject *obj, 75 char *format_spec, 76 Py_ssize_t format_spec_len); 77 78#ifdef __cplusplus 79} 80#endif 81#endif /* !Py_INTOBJECT_H */ 82