summaryrefslogtreecommitdiff
path: root/Include/floatobject.h
diff options
context:
space:
mode:
authorTim Peters <tim.peters@gmail.com>2001-05-08 15:19:57 +0000
committerTim Peters <tim.peters@gmail.com>2001-05-08 15:19:57 +0000
commit72f98e9b838ce73142e3bb89c4c7fde3266d475e (patch)
treeee5028c0b885ff1d7bd6d0efb5d842de50efcec6 /Include/floatobject.h
parent569c09c013b9fd88dd5f815a91ab1af4026d8a86 (diff)
downloadcpython-git-72f98e9b838ce73142e3bb89c4c7fde3266d475e.tar.gz
SF bug #422177: Results from .pyc differs from .py
Store floats and doubles to full precision in marshal. Test that floats read from .pyc/.pyo closely match those read from .py. Declare PyFloat_AsString() in floatobject header file. Add new PyFloat_AsReprString() API function. Document the functions declared in floatobject.h.
Diffstat (limited to 'Include/floatobject.h')
-rw-r--r--Include/floatobject.h25
1 files changed, 22 insertions, 3 deletions
diff --git a/Include/floatobject.h b/Include/floatobject.h
index 1d0b50a620..6e36a2f318 100644
--- a/Include/floatobject.h
+++ b/Include/floatobject.h
@@ -20,13 +20,32 @@ extern DL_IMPORT(PyTypeObject) PyFloat_Type;
#define PyFloat_Check(op) ((op)->ob_type == &PyFloat_Type)
-extern DL_IMPORT(PyObject *) PyFloat_FromString(PyObject*, char**);
+/* Return Python float from string PyObject. Second argument ignored on
+ input, and, if non-NULL, NULL is stored into *junk (this tried to serve a
+ purpose once but can't be made to work as intended). */
+extern DL_IMPORT(PyObject *) PyFloat_FromString(PyObject*, char** junk);
+
+/* Return Python float from C double. */
extern DL_IMPORT(PyObject *) PyFloat_FromDouble(double);
-extern DL_IMPORT(double) PyFloat_AsDouble(PyObject *);
-/* Macro, trading safety for speed */
+/* Extract C double from Python float. The macro version trades safety for
+ speed. */
+extern DL_IMPORT(double) PyFloat_AsDouble(PyObject *);
#define PyFloat_AS_DOUBLE(op) (((PyFloatObject *)(op))->ob_fval)
+/* Write repr(v) into the char buffer argument, followed by null byte. The
+ buffer must be "big enough"; >= 100 is very safe.
+ PyFloat_AsReprString(buf, x) strives to print enough digits so that
+ PyFloat_FromString(buf) then reproduces x exactly. */
+extern DL_IMPORT(void) PyFloat_AsReprString(char*, PyFloatObject *v);
+
+/* Write str(v) into the char buffer argument, followed by null byte. The
+ buffer must be "big enough"; >= 100 is very safe. Note that it's
+ unusual to be able to get back the float you started with from
+ PyFloat_AsString's result -- use PyFloat_AsReprString() if you want to
+ preserve precision across conversions. */
+extern DL_IMPORT(void) PyFloat_AsString(char*, PyFloatObject *v);
+
#ifdef __cplusplus
}
#endif