# Protocolo de números

int `PyNumber_Check`(PyObject *o)

  Retorna `1` si el objeto o proporciona protocolos numéricos, y falso en caso contrario. Esta función siempre tiene éxito.

  Distinto en la versión 3.8: Retorna `1` si o es un índice entero.

PyObject* `PyNumber_Add`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resultado de agregar o1 y o2, o `NULL` en caso de falla. Este es el equivalente de la expresión de Python `o1 + o2`.

PyObject* `PyNumber_Subtract`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resultado de restar o2 de o1, o `NULL` en caso de falla. Este es el equivalente de la expresión de Python `o1 - o2`.

PyObject* `PyNumber_Multiply`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resultado de multiplicar o1 y o2, o `NULL` en caso de error. Este es el equivalente de la expresión de Python `o1 * o2`.

PyObject* `PyNumber_MatrixMultiply`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resultado de la multiplicación de matrices en o1 y o2, o `NULL` en caso de falla. Este es el equivalente de la expresión de Python `o1 @ o2`.

  Nuevo en la versión 3.5.

PyObject* `PyNumber_FloorDivide`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el piso (floor) de o1 dividido por o2, o `NULL` en caso de falla. Esto es equivalente a la división «clásica» de enteros.

PyObject* `PyNumber_TrueDivide`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna una aproximación razonable para el valor matemático de o1 dividido por o2 o `NULL` en caso de falla. El valor de retorno es «aproximado» porque los números binarios de punto flotante son aproximados; No es posible representar todos los números reales en la base dos. Esta función puede retornar un valor de punto flotante cuando se pasan dos enteros.

PyObject* `PyNumber_Remainder`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resto de dividir o1 entre o2 o `NULL` en caso de error. Este es el equivalente de la expresión de Python `o1% o2`.

PyObject* `PyNumber_Divmod`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Vea la función incorporada `divmod()`. Retorna `NULL` en caso de falla. Este es el equivalente de la expresión de Python `divmod (o1, o2)`.

PyObject* `PyNumber_Power`(PyObject *o1, PyObject *o2, PyObject *o3)
  Return value: New reference.

  Consulte la función incorporada `pow()`. Retorna `NULL` en caso de falla. Este es el equivalente de la expresión de Python `pow(o1, o2, o3)`, donde o3 es opcional. Si se ignora o3, pase `Py_None` en su lugar (pasar `NULL` por o3 provocaría un acceso ilegal a la memoria).

PyObject* `PyNumber_Negative`(PyObject *o)
  Return value: New reference.

  Retorna la negación de o en caso de éxito o `NULL` en caso de error. Este es el equivalente de la expresión de Python `-o`.

PyObject* `PyNumber_Positive`(PyObject *o)
  Return value: New reference.

  Retorna o en caso de éxito o `NULL` en caso de error. Este es el equivalente de la expresión de Python `+o`.

PyObject* `PyNumber_Absolute`(PyObject *o)
  Return value: New reference.

  Retorna el valor absoluto de o o `NULL` en caso de error. Este es el equivalente de la expresión de Python `abs(o)`.

PyObject* `PyNumber_Invert`(PyObject *o)
  Return value: New reference.

  Retorna la negación bit a bit de o en caso de éxito o `NULL` en caso de error. Este es el equivalente de la expresión de Python `~o`.

PyObject* `PyNumber_Lshift`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resultado del desplazamiento a la izquierda o1 por o2 en caso de éxito o `NULL` en caso de error. Este es el equivalente de la expresión de Python `o1 << o2`.

PyObject* `PyNumber_Rshift`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resultado del desplazamiento a la derecha o1 por o2 en caso de éxito o `NULL` en caso de error. Este es el equivalente de la expresión de Python `o1 >> o2`.

PyObject* `PyNumber_And`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el «bit a bit y» (bitwise and) de o1 y o2 en caso de éxito y `NULL` en caso de error. Este es el equivalente de la expresión de Python `o1 & o2`.

PyObject* `PyNumber_Xor`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el «bit a bit o exclusivo» (bitwise exclusive or) de o1 por o2 en caso de éxito, o `NULL` en caso de error. Este es el equivalente de la expresión de Python `o1 ^ o2`.

PyObject* `PyNumber_Or`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el «bit a bit o» (bitwise or) de o1 y o2 en caso de éxito, o `NULL` en caso de error. Este es el equivalente de la expresión de Python `o1 | o2`.

PyObject* `PyNumber_InPlaceAdd`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resultado de agregar o1 y o2, o `NULL` en caso de falla. La operación se realiza en su lugar (in-place) cuando o1 lo admite. Este es el equivalente de la declaración de Python `o1 += o2`.

PyObject* `PyNumber_InPlaceSubtract`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resultado de restar o2 de o1, o `NULL` en caso de falla. La operación se realiza en su lugar (in-place) cuando o1 lo admite. Este es el equivalente de la declaración de Python `o1 -= o2`.

PyObject* `PyNumber_InPlaceMultiply`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resultado de multiplicar o1 y o2, o `NULL` en caso de error. La operación se realiza en su lugar (in-place) cuando o1 lo admite. Este es el equivalente de la declaración de Python `o1 *= o2`.

PyObject* `PyNumber_InPlaceMatrixMultiply`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resultado de la multiplicación de matrices en o1 y o2, o `NULL` en caso de falla. La operación se realiza en su lugar (in-place) cuando o1 lo admite. Este es el equivalente de la declaración de Python `o1 @= o2`.

  Nuevo en la versión 3.5.

PyObject* `PyNumber_InPlaceFloorDivide`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el piso matemático de dividir o1 por o2, o `NULL` en caso de falla. La operación se realiza en su lugar (in-place) cuando o1 lo admite. Este es el equivalente de la declaración de Python `o1 //= o2`.

PyObject* `PyNumber_InPlaceTrueDivide`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna una aproximación razonable para el valor matemático de o1 dividido por o2 o `NULL` en caso de falla. El valor de retorno es «aproximado» porque los números binarios de coma flotante son aproximados; No es posible representar todos los números reales en la base dos. Esta función puede retornar un valor de punto flotante cuando se pasan dos enteros. La operación se realiza en su lugar (in-place) cuando o1 lo admite.

PyObject* `PyNumber_InPlaceRemainder`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resto de dividir o1 entre o2 o `NULL` en caso de error. La operación se realiza en su lugar (in-place) cuando o1 lo admite. Este es el equivalente de la declaración de Python `o1%= o2`.

PyObject* `PyNumber_InPlacePower`(PyObject *o1, PyObject *o2, PyObject *o3)
  Return value: New reference.

  Consulte la función incorporada `pow()`. Retorna `NULL` en caso de falla. La operación se realiza en su lugar (in-place) cuando o1 lo admite. Este es el equivalente de la declaración de Python `o1 **= o2` cuando o3 es `Py_None`, o una variante en su lugar (in-place) de `pow (o1, o2, o3)` de lo contrario. Si se ignora o3, pase `Py_None` en su lugar (pasar `NULL` para o3 provocaría un acceso ilegal a la memoria).

PyObject* `PyNumber_InPlaceLshift`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resultado del desplazamiento a la izquierda o1 por o2 en caso de éxito o `NULL` en caso de error. La operación se realiza en su sitio (in-place) cuando o1 lo admite. Este es el equivalente de la declaración de Python `o1 <<= o2`.

PyObject* `PyNumber_InPlaceRshift`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el resultado del desplazamiento a la derecha o1 por o2 en caso de éxito o `NULL` en caso de error. La operación se realiza en su lugar (in-place) cuando o1 lo admite. Este es el equivalente de la declaración de Python `o1 >>= o2`.

PyObject* `PyNumber_InPlaceAnd`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el «bit a bit y» (bitwise and) de o1 y o2 en caso de éxito y `NULL` en caso de error. La operación se realiza en su lugar (in-place) cuando o1 lo admite. Este es el equivalente de la declaración de Python `o1 &= o2`.

PyObject* `PyNumber_InPlaceXor`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el «bit a bit o exclusivo» (bitwise exclusive or) de o1 por o2 en caso de éxito, o `NULL` en caso de error. La operación se realiza en su lugar (in-place) cuando o1 lo admite. Este es el equivalente de la declaración de Python `o1 ^= o2`.

PyObject* `PyNumber_InPlaceOr`(PyObject *o1, PyObject *o2)
  Return value: New reference.

  Retorna el «bit a bit o» (bitwise or) de o1 y o2 en caso de éxito, o `NULL` en caso de error. La operación se realiza en su lugar in-place cuando o1 lo admite. Este es el equivalente de la declaración de Python `o1 |= o2`.

PyObject* `PyNumber_Long`(PyObject *o)
  Return value: New reference.

  Retorna el o convertido a un objeto entero en caso de éxito, o `NULL` en caso de error. Este es el equivalente de la expresión de Python `int(o)`.

PyObject* `PyNumber_Float`(PyObject *o)
  Return value: New reference.

  Retorna el o convertido a un objeto flotante en caso de éxito o `NULL` en caso de error. Este es el equivalente de la expresión de Python `float(o)`.

PyObject* `PyNumber_Index`(PyObject *o)
  Return value: New reference.

  Retorna el o convertido aun entero de Python (int) en caso de éxito o `NULL` con una excepción `TypeError` generada en caso de error.

PyObject* `PyNumber_ToBase`(PyObject *n, int base)
  Return value: New reference.

  Retorna el entero n convertido a base base como una cadena de caracteres. El argumento base debe ser uno de 2, 8, 10 o 16. Para la base 2, 8 o 16, la cadena retornada está prefijada con un marcador base de `'0b'`”, `'0o'` o `'0x'`, respectivamente. Si n no es un entero (int) Python, primero se convierte con `PyNumber_Index()`.

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

  Retorna o convertido a un valor `Py_ssize_t` si o puede interpretarse como un entero. Si la llamada falla, se genera una excepción y se retorna `-1`.

  Si o se puede convertir a un entero Python (int) pero el intento de convertir a un valor `Py_ssize_t` generaría un `OverflowError`, entonces el argumento exc es el tipo de excepción que se generará (generalmente `IndexError` o `OverflowError`). Si exc es `NULL`, la excepción se borra y el valor se recorta a `PY_SSIZE_T_MIN` para un entero negativo o `PY_SSIZE_T_MAX` para un entero positivo.

int `PyIndex_Check`(PyObject *o)

  Retorna `1` si o es un entero índice (tiene el espacio `nb_index` de la estructura `tp_as_number` rellenado) y `0` en caso contrario. Esta función siempre tiene éxito.