Числовой протокол

int PyNumber_Check(PyObject *o)

Входит в Стабильный ABI.

Возвращает 1, если объект o поддерживает числовые протоколы, и false в противном случае. Эта функция всегда завершается успешно.

Изменено в версии 3.8: Возвращает 1, если o является целым числом с индексным протоколом.

PyObject *PyNumber_Add(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает результат сложения o1 и o2 или NULL в случае ошибки. Эквивалентно выражению Python o1 + o2.

PyObject *PyNumber_Subtract(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает результат вычитания o2 из o1 или NULL в случае ошибки. Эквивалентно выражению Python o1 - o2.

PyObject *PyNumber_Multiply(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает результат умножения o1 и o2 или NULL в случае ошибки. Эквивалентно выражению Python o1 * o2.

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

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI начиная с версии 3.7.

Возвращает результат умножения матриц o1 и o2 или NULL в случае ошибки. Эквивалентно выражению Python o1 @ o2.

Добавлено в версии 3.5.

PyObject *PyNumber_FloorDivide(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает результат деления o1 на o2 с округлением вниз или NULL в случае ошибки. Эквивалентно выражению Python o1 // o2.

PyObject *PyNumber_TrueDivide(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает разумное приближение математического значения частного o1 и o2 или NULL в случае ошибки. Возвращаемое значение является «приближённым», поскольку числа с плавающей точкой в двоичной системе являются приближёнными; представить все действительные числа в двоичной системе невозможно. Эта функция может вернуть значение с плавающей точкой, если ей переданы два целых числа. Эквивалентно выражению Python o1 / o2.

PyObject *PyNumber_Remainder(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает остаток от деления o1 на o2 или NULL в случае ошибки. Эквивалентно выражению Python o1 % o2.

PyObject *PyNumber_Divmod(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

См. встроенную функцию divmod(). Возвращает NULL в случае ошибки. Эквивалентно выражению Python divmod(o1, o2).

PyObject *PyNumber_Power(PyObject *o1, PyObject *o2, PyObject *o3)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

См. встроенную функцию pow(). Возвращает NULL в случае ошибки. Эквивалентно выражению Python pow(o1, o2, o3), где o3 является необязательным. Чтобы не учитывать o3, передайте вместо него Py_None (передача NULL для o3 приведёт к недопустимому доступу к памяти).

PyObject *PyNumber_Negative(PyObject *o)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

В случае успеха возвращает противоположное значение o или NULL в случае ошибки. Эквивалентно выражению Python -o.

PyObject *PyNumber_Positive(PyObject *o)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

В случае успеха возвращает o или NULL в случае ошибки. Эквивалентно выражению Python +o.

PyObject *PyNumber_Absolute(PyObject *o)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает абсолютное значение o или NULL в случае ошибки. Эквивалентно выражению Python abs(o).

PyObject *PyNumber_Invert(PyObject *o)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

В случае успеха возвращает побитовое отрицание o или NULL в случае ошибки. Эквивалентно выражению Python ~o.

PyObject *PyNumber_Lshift(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

В случае успеха возвращает результат сдвига o1 влево на o2 разрядов или NULL в случае ошибки. Эквивалентно выражению Python o1 << o2.

PyObject *PyNumber_Rshift(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

В случае успеха возвращает результат сдвига o1 вправо на o2 разрядов или NULL в случае ошибки. Эквивалентно выражению Python o1 >> o2.

PyObject *PyNumber_And(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

В случае успеха возвращает результат побитовой операции «И» для o1 и o2, а в случае ошибки — NULL. Эквивалентно выражению Python o1 & o2.

PyObject *PyNumber_Xor(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

В случае успеха возвращает результат побитового исключающего ИЛИ o1 и o2 или NULL в случае ошибки. Эквивалентно выражению Python o1 ^ o2.

PyObject *PyNumber_Or(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

В случае успеха возвращает результат побитовой операции «ИЛИ» для o1 и o2 или NULL в случае ошибки. Эквивалентно выражению Python o1 | o2.

PyObject *PyNumber_InPlaceAdd(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает результат сложения o1 и o2 или NULL в случае ошибки. Если o1 поддерживает эту операцию, она выполняется на месте. Эквивалентно инструкции Python o1 += o2.

PyObject *PyNumber_InPlaceSubtract(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает результат вычитания o2 из o1 или NULL в случае ошибки. Если o1 поддерживает эту операцию, она выполняется на месте. Эквивалентно инструкции Python o1 -= o2.

PyObject *PyNumber_InPlaceMultiply(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает результат умножения o1 и o2 или NULL в случае ошибки. Если o1 поддерживает эту операцию, она выполняется на месте. Эквивалентно инструкции Python o1 *= o2.

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

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI начиная с версии 3.7.

Возвращает результат умножения матриц o1 и o2 или NULL в случае ошибки. Если o1 поддерживает эту операцию, она выполняется на месте. Эквивалентно инструкции Python o1 @= o2.

Добавлено в версии 3.5.

PyObject *PyNumber_InPlaceFloorDivide(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает результат деления o1 на o2 с округлением вниз или NULL в случае ошибки. Если o1 поддерживает эту операцию, она выполняется на месте. Эквивалентно инструкции Python o1 //= o2.

PyObject *PyNumber_InPlaceTrueDivide(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает разумное приближение математического значения частного o1 и o2 или NULL в случае ошибки. Возвращаемое значение является «приближённым», поскольку числа с плавающей точкой в двоичной системе являются приближёнными; представить все действительные числа в двоичной системе невозможно. Эта функция может вернуть значение с плавающей точкой, если ей переданы два целых числа. Если o1 поддерживает эту операцию, она выполняется на месте. Эквивалентно инструкции Python o1 /= o2.

PyObject *PyNumber_InPlaceRemainder(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Входит в Стабильный ABI.

Возвращает остаток от деления o1 на o2 или NULL в случае ошибки. Если o1 поддерживает эту операцию, она выполняется на месте. Эквивалентно инструкции Python o1 %= o2.

PyObject *PyNumber_InPlacePower(PyObject *o1, PyObject *o2, PyObject *o3)

Возвращаемое значение: новая ссылка. Часть стабильного ABI.

См. встроенную функцию pow(). В случае ошибки возвращает NULL. Операция выполняется на месте, если o1 поддерживает это. Это эквивалент инструкции Python o1 **= o2, если o3 — Py_None, или её варианта с выполнением на месте в противном случае: pow(o1, o2, o3). Если o3 следует игнорировать, передайте вместо него Py_None (передача NULL для o3 приведёт к недопустимому доступу к памяти).

PyObject *PyNumber_InPlaceLshift(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Часть стабильного ABI.

В случае успеха возвращает результат сдвига o1 влево на o2 бит, а в случае ошибки — NULL. Операция выполняется на месте, если o1 поддерживает это. Это эквивалент инструкции Python o1 <<= o2.

PyObject *PyNumber_InPlaceRshift(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Часть стабильного ABI.

В случае успеха возвращает результат сдвига o1 вправо на o2 бит, а в случае ошибки — NULL. Операция выполняется на месте, если o1 поддерживает это. Это эквивалент инструкции Python o1 >>= o2.

PyObject *PyNumber_InPlaceAnd(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Часть стабильного ABI.

В случае успеха возвращает результат побитовой операции «И» над o1 и o2, а в случае ошибки — NULL. Операция выполняется на месте, если o1 поддерживает это. Это эквивалент инструкции Python o1 &= o2.

PyObject *PyNumber_InPlaceXor(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Часть стабильного ABI.

В случае успеха возвращает результат побитовой операции «исключающее ИЛИ» над o1 и o2, а в случае ошибки — NULL. Операция выполняется на месте, если o1 поддерживает это. Это эквивалент инструкции Python o1 ^= o2.

PyObject *PyNumber_InPlaceOr(PyObject *o1, PyObject *o2)

Возвращаемое значение: новая ссылка. Часть стабильного ABI.

В случае успеха возвращает результат побитовой операции «ИЛИ» над o1 и o2, а в случае ошибки — NULL. Операция выполняется на месте, если o1 поддерживает это. Это эквивалент инструкции Python o1 |= o2.

PyObject *PyNumber_Long(PyObject *o)

Возвращаемое значение: новая ссылка. Часть стабильного ABI.

В случае успеха возвращает o, преобразованный в целочисленный объект, а в случае ошибки — NULL. Это эквивалент выражения Python int(o).

PyObject *PyNumber_Float(PyObject *o)

Возвращаемое значение: новая ссылка. Часть стабильного ABI.

В случае успеха возвращает o, преобразованный в объект с плавающей точкой, а в случае ошибки — NULL. Это эквивалент выражения Python float(o).

PyObject *PyNumber_Index(PyObject *o)

Возвращаемое значение: новая ссылка. Часть стабильного ABI.

В случае успеха возвращает o, преобразованный в целое число Python, а в случае ошибки — NULL и возбуждает исключение TypeError.

Изменено в версии 3.10: Результат всегда имеет точный тип int. Ранее результат мог быть экземпляром подкласса int.

PyObject *PyNumber_ToBase(PyObject *n, int base)

Возвращаемое значение: новая ссылка. Часть стабильного ABI.

Возвращает целое число n, преобразованное в строку в системе счисления с основанием base. Аргумент base должен иметь значение 2, 8, 10 или 16. Для оснований 2, 8 и 16 перед строкой добавляется соответствующий префикс '0b', '0o' или '0x'. Если n не является целым числом Python, сначала оно преобразуется с помощью PyNumber_Index().

Py_ssize_t PyNumber_AsSsize_t(PyObject *o, PyObject *exc)

Часть стабильного ABI.

Если o можно интерпретировать как целое число, возвращает его преобразованное значение типа Py_ssize_t. Если вызов завершается неудачей, возбуждается исключение и возвращается -1.

Если o можно преобразовать в целое число Python, но попытка преобразовать его в значение типа Py_ssize_t привела бы к исключению OverflowError, аргумент exc задаёт тип исключения, которое будет возбуждено (обычно IndexError или OverflowError). Если exc равен NULL, исключение очищается, а значение ограничивается значением PY_SSIZE_T_MIN для отрицательного целого числа или PY_SSIZE_T_MAX для положительного целого числа.

int PyIndex_Check(PyObject *o)

Часть стабильного ABI начиная с версии 3.8.

Возвращает 1, если o является целым числом для индексации (в структуре tp_as_number заполнен слот nb_index), и 0 в противном случае. Эта функция всегда завершается успешно.