Номер Протокол¶
-
int PyNumber_Check(PyObject *o)¶
- Часть Стабильный ABI.
Возвращает
1
, если объект o предоставляет числовые протоколы, и false в противном случае. Эта функция всегда успешна.Изменено в версии 3.8: Возвращает
1
, если o - целое число с индексом.
-
PyObject *PyNumber_Add(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает результат сложения o1 и o2, или
NULL
при неудаче. Это эквивалентно выражениюo1 + o2
в Python.
-
PyObject *PyNumber_Subtract(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает результат вычитания o2 из o1, или
NULL
при неудаче. Это эквивалентно выражениюo1 - o2
в Python.
-
PyObject *PyNumber_Multiply(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает результат умножения o1 и o2, или
NULL
при неудаче. Это эквивалентно выражениюo1 * o2
в Python.
-
PyObject *PyNumber_MatrixMultiply(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI с версии 3.7.
Возвращает результат умножения матриц o1 и o2, или
NULL
при неудаче. Это эквивалентно выражениюo1 @ o2
в Python.Added in version 3.5.
-
PyObject *PyNumber_FloorDivide(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает значение o1, деленное на o2, или
NULL
в случае неудачи. Это эквивалентно выражениюo1 // o2
в Python.
-
PyObject *PyNumber_TrueDivide(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает разумное приближенное математическое значение o1, деленное на o2, или
NULL
при неудаче. Возвращаемое значение является «приблизительным», потому что двоичные числа с плавающей точкой являются приблизительными; невозможно представить все действительные числа в основании два. Эта функция может возвращать значение с плавающей точкой, если ей переданы два целых числа. Это эквивалентно выражениюo1 / o2
в Python.
-
PyObject *PyNumber_Remainder(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает остаток от деления o1 на o2 или
NULL
при неудаче. Это эквивалентно выражениюo1 % o2
в Python.
-
PyObject *PyNumber_Divmod(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
См. встроенную функцию
divmod()
. При неудаче возвращаетNULL
. Это эквивалентно выражениюdivmod(o1, o2)
в Python.
-
PyObject *PyNumber_Power(PyObject *o1, PyObject *o2, PyObject *o3)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
См. встроенную функцию
pow()
. При неудаче возвращаетNULL
. Это эквивалентно выражению Pythonpow(o1, o2, o3)
, где o3 необязательно. Если o3 необходимо игнорировать, передайте вместо негоPy_None
(передачаNULL
вместо o3 приведет к незаконному доступу к памяти).
-
PyObject *PyNumber_Negative(PyObject *o)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает отрицание o в случае успеха или
NULL
в случае неудачи. Это эквивалентно выражению-o
в Python.
-
PyObject *PyNumber_Positive(PyObject *o)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает o в случае успеха или
NULL
в случае неудачи. Это эквивалентно выражению+o
в Python.
-
PyObject *PyNumber_Absolute(PyObject *o)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает абсолютное значение o, или
NULL
в случае неудачи. Это эквивалентно выражениюabs(o)
в Python.
-
PyObject *PyNumber_Invert(PyObject *o)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает побитовое отрицание o в случае успеха или
NULL
в случае неудачи. Это эквивалентно выражению~o
в Python.
-
PyObject *PyNumber_Lshift(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает результат сдвига влево o1 на o2 в случае успеха, или
NULL
в случае неудачи. Это эквивалентно выражениюo1 << o2
в Python.
-
PyObject *PyNumber_Rshift(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает результат правого сдвига o1 на o2 в случае успеха или
NULL
в случае неудачи. Это эквивалентно выражениюo1 >> o2
в Python.
-
PyObject *PyNumber_And(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает «побитовое и» из o1 и o2 в случае успеха и
NULL
в случае неудачи. Это эквивалентно выражениюo1 & o2
в Python.
-
PyObject *PyNumber_Xor(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает «побитовое исключительное или» из o1 в o2 при успехе или
NULL
при неудаче. Это эквивалентно выражениюo1 ^ o2
в Python.
-
PyObject *PyNumber_Or(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает «побитовое или» из o1 и o2 в случае успеха, или
NULL
в случае неудачи. Это эквивалентно выражениюo1 | o2
в Python.
-
PyObject *PyNumber_InPlaceAdd(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает результат сложения o1 и o2, или
NULL
при неудаче. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно выражениюo1 += o2
в языке Python.
-
PyObject *PyNumber_InPlaceSubtract(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает результат вычитания o2 из o1, или
NULL
при неудаче. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно выражениюo1 -= o2
в языке Python.
-
PyObject *PyNumber_InPlaceMultiply(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает результат умножения o1 и o2, или
NULL
при неудаче. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно выражениюo1 *= o2
в Python.
-
PyObject *PyNumber_InPlaceMatrixMultiply(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI с версии 3.7.
Возвращает результат умножения матриц o1 и o2, или
NULL
при неудаче. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно выражениюo1 @= o2
в языке Python.Added in version 3.5.
-
PyObject *PyNumber_InPlaceFloorDivide(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает математическое значение деления o1 на o2, или
NULL
при неудаче. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно выражениюo1 //= o2
в языке Python.
-
PyObject *PyNumber_InPlaceTrueDivide(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает разумное приближенное математическое значение o1, деленное на o2, или
NULL
при неудаче. Возвращаемое значение является «приблизительным», потому что двоичные числа с плавающей точкой являются приблизительными; невозможно представить все действительные числа в основании два. Эта функция может возвращать значение с плавающей точкой, если ей переданы два целых числа. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно выражениюo1 /= o2
в Python.
-
PyObject *PyNumber_InPlaceRemainder(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает остаток от деления o1 на o2, или
NULL
при неудаче. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно выражениюo1 %= o2
в языке Python.
-
PyObject *PyNumber_InPlacePower(PyObject *o1, PyObject *o2, PyObject *o3)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
См. встроенную функцию
pow()
. ВозвращаетNULL
при неудаче. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно Python-операторуo1 **= o2
, если o3 равноPy_None
, или in-place вариантуpow(o1, o2, o3)
в противном случае. Если o3 необходимо игнорировать, передайте вместо негоPy_None
(передачаNULL
для o3 приведет к незаконному обращению к памяти).
-
PyObject *PyNumber_InPlaceLshift(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает результат сдвига влево o1 на o2 в случае успеха, или
NULL
в случае неудачи. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно выражениюo1 <<= o2
в языке Python.
-
PyObject *PyNumber_InPlaceRshift(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает результат сдвига вправо o1 на o2 в случае успеха или
NULL
в случае неудачи. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно выражениюo1 >>= o2
в языке Python.
-
PyObject *PyNumber_InPlaceAnd(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает «побитовое и» из o1 и o2 в случае успеха и
NULL
в случае неудачи. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно выражениюo1 &= o2
в Python.
-
PyObject *PyNumber_InPlaceXor(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает «побитовое эксклюзивное или» из o1 в o2 в случае успеха, или
NULL
в случае неудачи. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно выражениюo1 ^= o2
в языке Python.
-
PyObject *PyNumber_InPlaceOr(PyObject *o1, PyObject *o2)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает «побитовое или» из o1 и o2 в случае успеха, или
NULL
в случае неудачи. Операция выполняется in-place, если o1 поддерживает ее. Это эквивалентно выражениюo1 |= o2
в языке Python.
-
PyObject *PyNumber_Long(PyObject *o)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает o, преобразованное в целочисленный объект в случае успеха, или
NULL
в случае неудачи. Это эквивалентно выражениюint(o)
в Python.
-
PyObject *PyNumber_Float(PyObject *o)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает o, преобразованное в объект float в случае успеха, или
NULL
в случае неудачи. Это эквивалентно выражениюfloat(o)
в Python.
-
PyObject *PyNumber_Index(PyObject *o)¶
- Возвращаемое значение: Новая ссылка. Часть Стабильный ABI.
Возвращает o, преобразованное в Python int, в случае успеха или
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 int, оно сначала преобразуется с помощьюPyNumber_Index()
.
-
Py_ssize_t PyNumber_AsSsize_t(PyObject *o, PyObject *exc)¶
- Часть Стабильный ABI.
Возвращает o, преобразованное в значение
Py_ssize_t
, если o может быть интерпретировано как целое число. Если вызов не удался, возбуждается исключение и возвращается-1
.Если o может быть преобразовано в Python int, но попытка преобразования в значение
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 является индексным целым числом (заполнен слотnb_index
структурыtp_as_number
), и0
в противном случае. Эта функция всегда успешна.