blob: 6e36a2f318715581508d5a4027fe7e1ee9bc8412 [file] [log] [blame]
Guido van Rossumf70e43a1991-02-19 12:39:46 +00001
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002/* Float object interface */
3
4/*
Guido van Rossumcaa63801995-01-12 11:45:45 +00005PyFloatObject represents a (double precision) floating point number.
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00006*/
7
Fred Drakeea9cb5a2000-07-09 00:20:36 +00008#ifndef Py_FLOATOBJECT_H
9#define Py_FLOATOBJECT_H
10#ifdef __cplusplus
11extern "C" {
12#endif
13
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000014typedef struct {
Fred Drakeea9cb5a2000-07-09 00:20:36 +000015 PyObject_HEAD
16 double ob_fval;
Guido van Rossumcaa63801995-01-12 11:45:45 +000017} PyFloatObject;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000018
Guido van Rossum051ab121995-02-27 10:17:52 +000019extern DL_IMPORT(PyTypeObject) PyFloat_Type;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000020
Guido van Rossumcaa63801995-01-12 11:45:45 +000021#define PyFloat_Check(op) ((op)->ob_type == &PyFloat_Type)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000022
Tim Peters72f98e92001-05-08 15:19:57 +000023/* Return Python float from string PyObject. Second argument ignored on
24 input, and, if non-NULL, NULL is stored into *junk (this tried to serve a
25 purpose once but can't be made to work as intended). */
26extern DL_IMPORT(PyObject *) PyFloat_FromString(PyObject*, char** junk);
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000027
Tim Peters72f98e92001-05-08 15:19:57 +000028/* Return Python float from C double. */
29extern DL_IMPORT(PyObject *) PyFloat_FromDouble(double);
30
31/* Extract C double from Python float. The macro version trades safety for
32 speed. */
33extern DL_IMPORT(double) PyFloat_AsDouble(PyObject *);
Guido van Rossum2981bc71997-08-02 02:40:58 +000034#define PyFloat_AS_DOUBLE(op) (((PyFloatObject *)(op))->ob_fval)
Guido van Rossuma3309961993-07-28 09:05:47 +000035
Tim Peters72f98e92001-05-08 15:19:57 +000036/* Write repr(v) into the char buffer argument, followed by null byte. The
37 buffer must be "big enough"; >= 100 is very safe.
38 PyFloat_AsReprString(buf, x) strives to print enough digits so that
39 PyFloat_FromString(buf) then reproduces x exactly. */
40extern DL_IMPORT(void) PyFloat_AsReprString(char*, PyFloatObject *v);
41
42/* Write str(v) into the char buffer argument, followed by null byte. The
43 buffer must be "big enough"; >= 100 is very safe. Note that it's
44 unusual to be able to get back the float you started with from
45 PyFloat_AsString's result -- use PyFloat_AsReprString() if you want to
46 preserve precision across conversions. */
47extern DL_IMPORT(void) PyFloat_AsString(char*, PyFloatObject *v);
48
Guido van Rossuma3309961993-07-28 09:05:47 +000049#ifdef __cplusplus
50}
51#endif
52#endif /* !Py_FLOATOBJECT_H */