浮點數(Floating-Point)物件

type PyFloatObject

這個 PyObject 的子型別代表一個 Python 浮點數物件。

PyTypeObject PyFloat_Type
穩定 ABI 的一部分.

這個 PyTypeObject 的實例代表 Python 浮點數型別。這與 Python 層中的 float 物件相同。

int PyFloat_Check(PyObject *p)

如果其引數是 PyFloatObjectPyFloatObject 的子型別,則回傳 true。這個函式不會失敗。

int PyFloat_CheckExact(PyObject *p)

如果其引數是 PyFloatObject,但不是 PyFloatObject 的子型別,則回傳 true。這個函式不會失敗。

PyObject *PyFloat_FromString(PyObject *str)
回傳值:新的參照。穩定 ABI 的一部分.

建立一個基於字串值 strPyFloatObject 物件,失敗時回傳 NULL

PyObject *PyFloat_FromDouble(double v)
回傳值:新的參照。穩定 ABI 的一部分.

建立一個來自 vPyFloatObject 物件,失敗時回傳 NULL

double PyFloat_AsDouble(PyObject *pyfloat)
穩定 ABI 的一部分.

回傳 pyfloat 內容的 C double 表示形式。如果 pyfloat 不是 Python 浮點數物件,但具有 __float__() 方法,則會先呼叫此方法將 pyfloat 轉換為浮點數。如果未定義 __float__(),則會用後備方法 __index__()。此方法在失敗時回傳 -1.0,因此應該呼叫 PyErr_Occurred() 來檢查錯誤。

在 3.8 版的變更: 請使用 __index__()(如果可用)。

double PyFloat_AS_DOUBLE(PyObject *pyfloat)

回傳 pyfloat 內容的 C double 表示形式,但不進行錯誤檢查。

PyObject *PyFloat_GetInfo(void)
回傳值:新的參照。穩定 ABI 的一部分.

回傳一個 structseq 實例,其中包含有關浮點數的精度、最小值和最大值的資訊。它是對標頭檔 float.h 的簡單封裝。

double PyFloat_GetMax()
穩定 ABI 的一部分.

將可表示的最大有限浮點數 DBL_MAX 作為 C double 回傳。

double PyFloat_GetMin()
穩定 ABI 的一部分.

將最小的正規化浮點數 DBL_MIN 作為 C double 回傳。

Py_INFINITY

這個巨集會展開為一型別為 double 的常數運算式,表示正無窮大。

在大多數平台上,這相當於 C11 標準 <math.h> 標頭檔中的 INFINITY 巨集。

Py_NAN

這個巨集會展開為一型別為 double 的常數運算式,表示安靜型 NaN (qNaN) 值。

在大多數平台上,這相當於 C11 標準 <math.h> 標頭檔中的 NAN 巨集。

Py_HUGE_VAL

INFINITY 等價。

在 3.14 版之後被棄用: 這個巨集已被軟性棄用

Py_MATH_E

math.e 常數的定義(對 double 型別而言是準確的)。

Py_MATH_El

高精度(long double)定義的 e 常數。

Py_MATH_PI

math.pi 常數的定義(對 double 型別而言是準確的)。

Py_MATH_PIl

高精度(long double)定義的 pi 常數。

Py_MATH_TAU

math.tau 常數的定義(對 double 型別而言是準確的)。

在 3.6 版被加入.

Py_RETURN_NAN

從函式回傳 math.nan

在大多數平台上,這相當於