Green shading in the line number column means the source is part of the translation unit, red means it is conditionally excluded. Highlighted line numbers link to the translation unit page. Highlighted macros link to the macro page.
1: 2: /* Float object interface */ 3: 4: /* 5: PyFloatObject represents a (double precision) floating point number. 6: */ 7: 8: #ifndef Py_FLOATOBJECT_H 9: #define Py_FLOATOBJECT_H 10: #ifdef __cplusplus 11: extern "C" { 12: #endif 13: 14: #ifndef Py_LIMITED_API 15: typedef struct { 16: PyObject_HEAD 17: double ob_fval; 18: } PyFloatObject; 19: #endif 20: 21: PyAPI_DATA(PyTypeObject) PyFloat_Type; 22: 23: #define PyFloat_Check(op) PyObject_TypeCheck(op, &PyFloat_Type) 24: #define PyFloat_CheckExact(op) (Py_TYPE(op) == &PyFloat_Type) 25: 26: #ifdef Py_NAN 27: #define Py_RETURN_NAN return PyFloat_FromDouble(Py_NAN) 28: #endif 29: 30: #define Py_RETURN_INF(sign) do \ 31: if (copysign(1., sign) == 1.) { \ 32: return PyFloat_FromDouble(Py_HUGE_VAL); \ 33: } else { \ 34: return PyFloat_FromDouble(-Py_HUGE_VAL); \ 35: } while(0) 36: 37: PyAPI_FUNC(double) PyFloat_GetMax(void); 38: PyAPI_FUNC(double) PyFloat_GetMin(void); 39: PyAPI_FUNC(PyObject *) PyFloat_GetInfo(void); 40: 41: /* Return Python float from string PyObject. */ 42: PyAPI_FUNC(PyObject *) PyFloat_FromString(PyObject*); 43: 44: /* Return Python float from C double. */ 45: PyAPI_FUNC(PyObject *) PyFloat_FromDouble(double); 46: 47: /* Extract C double from Python float. The macro version trades safety for 48: speed. */ 49: PyAPI_FUNC(double) PyFloat_AsDouble(PyObject *); 50: #ifndef Py_LIMITED_API 51: #define PyFloat_AS_DOUBLE(op) (((PyFloatObject *)(op))->ob_fval) 52: #endif 53: 54: #ifndef Py_LIMITED_API 55: /* _PyFloat_{Pack,Unpack}{4,8} 56: * 57: * The struct and pickle (at least) modules need an efficient platform- 58: * independent way to store floating-point values as byte strings. 59: * The Pack routines produce a string from a C double, and the Unpack 60: * routines produce a C double from such a string. The suffix (4 or 8) 61: * specifies the number of bytes in the string. 62: * 63: * On platforms that appear to use (see _PyFloat_Init()) IEEE-754 formats 64: * these functions work by copying bits. On other platforms, the formats the 65: * 4- byte format is identical to the IEEE-754 single precision format, and 66: * the 8-byte format to the IEEE-754 double precision format, although the 67: * packing of INFs and NaNs (if such things exist on the platform) isn't 68: * handled correctly, and attempting to unpack a string containing an IEEE 69: * INF or NaN will raise an exception. 70: * 71: * On non-IEEE platforms with more precision, or larger dynamic range, than 72: * 754 supports, not all values can be packed; on non-IEEE platforms with less 73: * precision, or smaller dynamic range, not all values can be unpacked. What 74: * happens in such cases is partly accidental (alas). 75: */ 76: 77: /* The pack routines write 2, 4 or 8 bytes, starting at p. le is a bool 78: * argument, true if you want the string in little-endian format (exponent 79: * last, at p+1, p+3 or p+7), false if you want big-endian format (exponent 80: * first, at p). 81: * Return value: 0 if all is OK, -1 if error (and an exception is 82: * set, most likely OverflowError). 83: * There are two problems on non-IEEE platforms: 84: * 1): What this does is undefined if x is a NaN or infinity. 85: * 2): -0.0 and +0.0 produce the same string. 86: */ 87: PyAPI_FUNC(int) _PyFloat_Pack2(double x, unsigned char *p, int le); 88: PyAPI_FUNC(int) _PyFloat_Pack4(double x, unsigned char *p, int le); 89: PyAPI_FUNC(int) _PyFloat_Pack8(double x, unsigned char *p, int le); 90: 91: /* Needed for the old way for marshal to store a floating point number. 92: Returns the string length copied into p, -1 on error. 93: */ 94: PyAPI_FUNC(int) _PyFloat_Repr(double x, char *p, size_t len); 95: 96: /* Used to get the important decimal digits of a double */ 97: PyAPI_FUNC(int) _PyFloat_Digits(char *buf, double v, int *signum); 98: PyAPI_FUNC(void) _PyFloat_DigitsInit(void); 99: 100: /* The unpack routines read 2, 4 or 8 bytes, starting at p. le is a bool 101: * argument, true if the string is in little-endian format (exponent 102: * last, at p+1, p+3 or p+7), false if big-endian (exponent first, at p). 103: * Return value: The unpacked double. On error, this is -1.0 and 104: * PyErr_Occurred() is true (and an exception is set, most likely 105: * OverflowError). Note that on a non-IEEE platform this will refuse 106: * to unpack a string that represents a NaN or infinity. 107: */ 108: PyAPI_FUNC(double) _PyFloat_Unpack2(const unsigned char *p, int le); 109: PyAPI_FUNC(double) _PyFloat_Unpack4(const unsigned char *p, int le); 110: PyAPI_FUNC(double) _PyFloat_Unpack8(const unsigned char *p, int le); 111: 112: /* free list api */ 113: PyAPI_FUNC(int) PyFloat_ClearFreeList(void); 114: 115: PyAPI_FUNC(void) _PyFloat_DebugMallocStats(FILE* out); 116: 117: /* Format the object based on the format_spec, as defined in PEP 3101 118: (Advanced String Formatting). */ 119: PyAPI_FUNC(int) _PyFloat_FormatAdvancedWriter( 120: _PyUnicodeWriter *writer, 121: PyObject *obj, 122: PyObject *format_spec, 123: Py_ssize_t start, 124: Py_ssize_t end); 125: #endif /* Py_LIMITED_API */ 126: 127: #ifdef __cplusplus 128: } 129: #endif 130: #endif /* !Py_FLOATOBJECT_H */ 131: