Number Protocol - Python 2.7.18 documentation 编辑
- int
PyNumber_Check(PyObject *o) Returns
1if the object o provides numeric protocols, and false otherwise. This function always succeeds.
- PyObject*
PyNumber_Add(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the result of adding o1 and o2, or NULL on failure. This is the equivalent of the Python expression
o1 + o2.
- PyObject*
PyNumber_Subtract(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the result of subtracting o2 from o1, or NULL on failure. This is the equivalent of the Python expression
o1 - o2.
- PyObject*
PyNumber_Multiply(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the result of multiplying o1 and o2, or NULL on failure. This is the equivalent of the Python expression
o1 * o2.
- PyObject*
PyNumber_Divide(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the result of dividing o1 by o2, or NULL on failure. This is the equivalent of the Python expression
o1 / o2.
- PyObject*
PyNumber_FloorDivide(PyObject *o1, PyObject *o2) - Return value: New reference.
Return the floor of o1 divided by o2, or NULL on failure. This is equivalent to the “classic” division of integers.
New in version 2.2.
- PyObject*
PyNumber_TrueDivide(PyObject *o1, PyObject *o2) - Return value: New reference.
Return a reasonable approximation for the mathematical value of o1 divided by o2, or 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.
New in version 2.2.
- PyObject*
PyNumber_Remainder(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the remainder of dividing o1 by o2, or NULL on failure. This is the equivalent of the Python expression
o1 % o2.
- PyObject*
PyNumber_Divmod(PyObject *o1, PyObject *o2) - Return value: New reference.
See the built-in function
divmod(). Returns NULL on failure. This is the equivalent of the Python expressiondivmod(o1, o2).
- PyObject*
PyNumber_Power(PyObject *o1, PyObject *o2, PyObject *o3) - Return value: New reference.
See the built-in function
pow(). Returns NULL on failure. This is the equivalent of the Python expressionpow(o1, o2, o3), where o3 is optional. If o3 is to be ignored, passPy_Nonein its place (passing NULL for o3 would cause an illegal memory access).
- PyObject*
PyNumber_Negative(PyObject *o) - Return value: New reference.
Returns the negation of o on success, or NULL on failure. This is the equivalent of the Python expression
-o.
- PyObject*
PyNumber_Positive(PyObject *o) - Return value: New reference.
Returns o on success, or NULL on failure. This is the equivalent of the Python expression
+o.
- PyObject*
PyNumber_Absolute(PyObject *o) - Return value: New reference.
Returns the absolute value of o, or NULL on failure. This is the equivalent of the Python expression
abs(o).
- PyObject*
PyNumber_Invert(PyObject *o) - Return value: New reference.
Returns the bitwise negation of o on success, or NULL on failure. This is the equivalent of the Python expression
~o.
- PyObject*
PyNumber_Lshift(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the result of left shifting o1 by o2 on success, or NULL on failure. This is the equivalent of the Python expression
o1 << o2.
- PyObject*
PyNumber_Rshift(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the result of right shifting o1 by o2 on success, or NULL on failure. This is the equivalent of the Python expression
o1 >> o2.
- PyObject*
PyNumber_And(PyObject *o1, PyObject *o2) - Return value: New reference.
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) - Return value: New reference.
Returns the “bitwise exclusive or” of o1 by o2 on success, or NULL on failure. This is the equivalent of the Python expression
o1 ^ o2.
- PyObject*
PyNumber_Or(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the “bitwise or” of o1 and o2 on success, or NULL on failure. This is the equivalent of the Python expression
o1 | o2.
- PyObject*
PyNumber_InPlaceAdd(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the result of adding o1 and o2, or NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python statement
o1 += o2.
- PyObject*
PyNumber_InPlaceSubtract(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the result of subtracting o2 from o1, or NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python statement
o1 -= o2.
- PyObject*
PyNumber_InPlaceMultiply(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the result of multiplying o1 and o2, or NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python statement
o1 *= o2.
- PyObject*
PyNumber_InPlaceDivide(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the result of dividing o1 by o2, or NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python statement
o1 /= o2.
- PyObject*
PyNumber_InPlaceFloorDivide(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the mathematical floor of dividing o1 by o2, or NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python statement
o1 //= o2.New in version 2.2.
- PyObject*
PyNumber_InPlaceTrueDivide(PyObject *o1, PyObject *o2) - Return value: New reference.
Return a reasonable approximation for the mathematical value of o1 divided by o2, or 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 when o1 supports it.
New in version 2.2.
- PyObject*
PyNumber_InPlaceRemainder(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the remainder of dividing o1 by o2, or NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python statement
o1 %= o2.
- PyObject*
PyNumber_InPlacePower(PyObject *o1, PyObject *o2, PyObject *o3) - Return value: New reference.
See the built-in function
pow(). Returns NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python statemento1 **= o2when o3 isPy_None, or an in-place variant ofpow(o1, o2, o3)otherwise. If o3 is to be ignored, passPy_Nonein its place (passing NULL for o3 would cause an illegal memory access).
- PyObject*
PyNumber_InPlaceLshift(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the result of left shifting o1 by o2 on success, or NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python statement
o1 <<= o2.
- PyObject*
PyNumber_InPlaceRshift(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the result of right shifting o1 by o2 on success, or NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python statement
o1 >>= o2.
- PyObject*
PyNumber_InPlaceAnd(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the “bitwise and” of o1 and o2 on success and NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python statement
o1 &= o2.
- PyObject*
PyNumber_InPlaceXor(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the “bitwise exclusive or” of o1 by o2 on success, or NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python statement
o1 ^= o2.
- PyObject*
PyNumber_InPlaceOr(PyObject *o1, PyObject *o2) - Return value: New reference.
Returns the “bitwise or” of o1 and o2 on success, or NULL on failure. The operation is done in-place when o1 supports it. This is the equivalent of the Python statement
o1 |= o2.
- int
PyNumber_Coerce(PyObject **p1, PyObject **p2) This function takes the addresses of two variables of type
PyObject*. If the objects pointed to by*p1and*p2have the same type, increment their reference count and return0(success). If the objects can be converted to a common numeric type, replace*p1and*p2by their converted value (with ‘new’ reference counts), and return0. If no conversion is possible, or if some other error occurs, return-1(failure) and don’t increment the reference counts. The callPyNumber_Coerce(&o1, &o2)is equivalent to the Python statemento1, o2 = coerce(o1, o2).
- int
PyNumber_CoerceEx(PyObject **p1, PyObject **p2) This function is similar to
PyNumber_Coerce(), except that it returns1when the conversion is not possible and when no error is raised. Reference counts are still not increased in this case.
- PyObject*
PyNumber_Int(PyObject *o) - Return value: New reference.
Returns the o converted to an integer object on success, or NULL on failure. If the argument is outside the integer range a long object will be returned instead. This is the equivalent of the Python expression
int(o).
- PyObject*
PyNumber_Long(PyObject *o) - Return value: New reference.
Returns the o converted to a long integer object on success, or NULL on failure. This is the equivalent of the Python expression
long(o).
- PyObject*
PyNumber_Float(PyObject *o) - Return value: New reference.
Returns the 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) Returns the o converted to a Python int or long on success or NULL with a
TypeErrorexception raised on failure.New in version 2.5.
- PyObject*
PyNumber_ToBase(PyObject *n, int base) Returns the integer n converted to base as a string with a base marker of
'0b','0o', or'0x'if applicable. When base is not 2, 8, 10, or 16, the format is'x#num'where x is the base. If n is not an int object, it is converted withPyNumber_Index()first.New in version 2.6.
- Py_ssize_t
PyNumber_AsSsize_t(PyObject *o, PyObject *exc) Returns o converted to a Py_ssize_t value if o can be interpreted as an integer. If o can be converted to a Python int or long 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 (usuallyIndexErrororOverflowError). If 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.New in version 2.5.
- int
PyIndex_Check(PyObject *o) Returns
1if o is an index integer (has the nb_index slot of the tp_as_number structure filled in), and0otherwise.New in version 2.5.
如果你对这篇内容有疑问，欢迎到本站社区发帖提问 参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱，如果其他用户或者作者回复了您的评论，将不能在第一时间通知您！
发布评论