数字协议 ¶

int PyNumber_Check ( PyObject * o ) ¶

属于稳定 ABI (应用程序二进制接口) .

返回 1 if the object o provides numeric protocols, and false otherwise. This function always succeeds.

3.8 版改变：返回 1 if o is an index integer.

PyObject * PyNumber_Add ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the result of adding o1 and o2 ，或 NULL on failure. This is the equivalent of the Python expression o1 + o2 .

PyObject * PyNumber_Subtract ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the result of subtracting o2 from o1 ，或 NULL on failure. This is the equivalent of the Python expression o1 - o2 .

PyObject * PyNumber_Multiply ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the result of multiplying o1 and o2 ，或 NULL on failure. This is the equivalent of the Python expression o1 * o2 .

PyObject * PyNumber_MatrixMultiply ( PyObject * o1 , PyObject * o2 ) ¶

返回值：新引用。 属于稳定 ABI (应用程序二进制接口) since version 3.7.

Returns the result of matrix multiplication on o1 and o2 ，或 NULL on failure. This is the equivalent of the Python expression o1 @ o2 .

Added in version 3.5.

PyObject * PyNumber_FloorDivide ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Return the floor of o1 divided by o2 ，或 NULL on failure. This is the equivalent of the Python expression o1 // o2 .

PyObject * PyNumber_TrueDivide ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Return a reasonable approximation for the mathematical value of o1 divided by o2 ，或 NULL on failure. The return value is “approximate” because binary floating-point numbers are approximate; it is not possible to represent all real numbers in base two. This function can return a floating-point value when passed two integers. This is the equivalent of the Python expression o1 / o2 .

PyObject * PyNumber_Remainder ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the remainder of dividing o1 by o2 ，或 NULL on failure. This is the equivalent of the Python expression o1 % o2 .

PyObject * PyNumber_Divmod ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
见内置函数 divmod() 。返回 NULL on failure. This is the equivalent of the Python expression divmod(o1, o2) .

PyObject * PyNumber_Power ( PyObject * o1 , PyObject * o2 , PyObject * o3 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
见内置函数 pow() 。返回 NULL on failure. This is the equivalent of the Python expression pow(o1, o2, o3) ，其中 o3 is optional. If o3 is to be ignored, pass Py_None in its place (passing NULL for o3 would cause an illegal memory access).

PyObject * PyNumber_Negative ( PyObject * o ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the negation of o 当成功时，或 NULL on failure. This is the equivalent of the Python expression -o .

PyObject * PyNumber_Positive ( PyObject * o ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
返回 o 当成功时，或 NULL on failure. This is the equivalent of the Python expression +o .

PyObject * PyNumber_Absolute ( PyObject * o ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the absolute value of o ，或 NULL on failure. This is the equivalent of the Python expression abs(o) .

PyObject * PyNumber_Invert ( PyObject * o ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the bitwise negation of o 当成功时，或 NULL on failure. This is the equivalent of the Python expression ~o .

PyObject * PyNumber_Lshift ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the result of left shifting o1 by o2 当成功时，或 NULL on failure. This is the equivalent of the Python expression o1 << o2 .

PyObject * PyNumber_Rshift ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the result of right shifting o1 by o2 当成功时，或 NULL on failure. This is the equivalent of the Python expression o1 >> o2 .

PyObject * PyNumber_And ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the “bitwise and” of o1 and o2 on success and NULL on failure. This is the equivalent of the Python expression o1 & o2 .

PyObject * PyNumber_Xor ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the “bitwise exclusive or” of o1 by o2 当成功时，或 NULL on failure. This is the equivalent of the Python expression o1 ^ o2 .

PyObject * PyNumber_Or ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the “bitwise or” of o1 and o2 当成功时，或 NULL on failure. This is the equivalent of the Python expression o1 | o2 .

PyObject * PyNumber_InPlaceAdd ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the result of adding o1 and o2 ，或 NULL on failure. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 += o2 .

PyObject * PyNumber_InPlaceSubtract ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the result of subtracting o2 from o1 ，或 NULL on failure. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 -= o2 .

PyObject * PyNumber_InPlaceMultiply ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the result of multiplying o1 and o2 ，或 NULL on failure. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 *= o2 .

PyObject * PyNumber_InPlaceMatrixMultiply ( PyObject * o1 , PyObject * o2 ) ¶

返回值：新引用。 属于稳定 ABI (应用程序二进制接口) since version 3.7.

Returns the result of matrix multiplication on o1 and o2 ，或 NULL on failure. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 @= o2 .

Added in version 3.5.

PyObject * PyNumber_InPlaceFloorDivide ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the mathematical floor of dividing o1 by o2 ，或 NULL on failure. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 //= o2 .

PyObject * PyNumber_InPlaceTrueDivide ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Return a reasonable approximation for the mathematical value of o1 divided by o2 ，或 NULL on failure. The return value is “approximate” because binary floating-point numbers are approximate; it is not possible to represent all real numbers in base two. This function can return a floating-point value when passed two integers. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 /= o2 .

PyObject * PyNumber_InPlaceRemainder ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the remainder of dividing o1 by o2 ，或 NULL on failure. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 %= o2 .

PyObject * PyNumber_InPlacePower ( PyObject * o1 , PyObject * o2 , PyObject * o3 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
见内置函数 pow() 。返回 NULL on failure. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 **= o2 when o3 is Py_None , or an in-place variant of pow(o1, o2, o3) otherwise. If o3 is to be ignored, pass Py_None in its place (passing NULL for o3 would cause an illegal memory access).

PyObject * PyNumber_InPlaceLshift ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the result of left shifting o1 by o2 当成功时，或 NULL on failure. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 <<= o2 .

PyObject * PyNumber_InPlaceRshift ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the result of right shifting o1 by o2 当成功时，或 NULL on failure. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 >>= o2 .

PyObject * PyNumber_InPlaceAnd ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the “bitwise and” of o1 and o2 on success and NULL on failure. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 &= o2 .

PyObject * PyNumber_InPlaceXor ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the “bitwise exclusive or” of o1 by o2 当成功时，或 NULL on failure. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 ^= o2 .

PyObject * PyNumber_InPlaceOr ( PyObject * o1 , PyObject * o2 ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
Returns the “bitwise or” of o1 and o2 当成功时，或 NULL on failure. The operation is done in-place 当 o1 supports it. This is the equivalent of the Python statement o1 |= o2 .

PyObject * PyNumber_Long ( PyObject * o ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
返回 o converted to an integer object on success, or NULL on failure. This is the equivalent of the Python expression int(o) .

PyObject * PyNumber_Float ( PyObject * o ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
返回 o converted to a float object on success, or NULL on failure. This is the equivalent of the Python expression float(o) .

PyObject * PyNumber_Index ( PyObject * o ) ¶

返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .

返回 o converted to a Python int on success or NULL 采用 TypeError 引发异常当故障时。

3.10 版改变： The result always has exact type int . Previously, the result could have been an instance of a subclass of int .

PyObject * PyNumber_ToBase ( PyObject * n , int base ) ¶: 返回值：新引用。 属于稳定 ABI (应用程序二进制接口) .
返回整数 n converted to base base as a string. The base argument must be one of 2, 8, 10, or 16. For base 2, 8, or 16, the returned string is prefixed with a base marker of '0b' , '0o' ，或 '0x' , respectively. If n is not a Python int, it is converted with PyNumber_Index() 首先。

Py_ssize_t PyNumber_AsSsize_t ( PyObject * o , PyObject * exc ) ¶

属于稳定 ABI (应用程序二进制接口) .

返回 o converted to a Py_ssize_t value if o can be interpreted as an integer. If the call fails, an exception is raised and -1 被返回。

若 o can be converted to a Python int but the attempt to convert to a Py_ssize_t value would raise an OverflowError , then the exc argument is the type of exception that will be raised (usually IndexError or OverflowError )。若 exc is NULL , then the exception is cleared and the value is clipped to PY_SSIZE_T_MIN for a negative integer or PY_SSIZE_T_MAX for a positive integer.

int PyIndex_Check ( PyObject * o ) ¶: 属于稳定 ABI (应用程序二进制接口) since version 3.8.
返回 1 if o is an index integer (has the nb_index slot of the tp_as_number structure filled in), and 0 otherwise. This function always succeeds.

数字协议 ¶

上一话题

下一话题

本页