# Copyright (C) 2001-2020, Python Software Foundation

# This file is distributed under the same license as the Python package.

# Maintained by the python-doc-es workteam.

# docs-es@python.org /

# https://mail.python.org/mailman3/lists/docs-es.python.org/

# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to

# get the list of volunteers

#

msgid ""

msgstr ""

"Project-Id-Version: Python 3.8\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-02-26 18:44-0300\n"

"PO-Revision-Date: 2025-10-14 01:44-0600\n"

"Last-Translator: Cristián Maureira-Fredes <cmaureirafredes@gmail.com>\n"

"Language: es\n"

"Language-Team: python-doc-es\n"

"Plural-Forms: nplurals=2; plural=(n != 1);\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=utf-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Generated-By: Babel 2.18.0\n"

#: ../Doc/c-api/long.rst:6

msgid "Integer Objects"

msgstr "Objetos enteros"

#: ../Doc/c-api/long.rst:11

msgid ""

"All integers are implemented as \"long\" integer objects of arbitrary size."

msgstr ""

"Todos los enteros se implementan como objetos enteros \"largos\" (*long*) de "

"tamaño arbitrario."

#: ../Doc/c-api/long.rst:13

msgid ""

"On error, most ``PyLong_As*`` APIs return ``(return type)-1`` which cannot "

"be distinguished from a number. Use :c:func:`PyErr_Occurred` to "

"disambiguate."

msgstr ""

"En caso de error, la mayoría de las API ``PyLong_As*`` retornan ``(tipo de "

"retorno) -1`` que no se puede distinguir de un número. Use :c:func:"

"`PyErr_Occurred` para desambiguar."

#: ../Doc/c-api/long.rst:18

msgid "This subtype of :c:type:`PyObject` represents a Python integer object."

msgstr ""

"Este subtipo de :c:type:`PyObject` representa un objeto entero de Python."

#: ../Doc/c-api/long.rst:23

msgid ""

"This instance of :c:type:`PyTypeObject` represents the Python integer type. "

"This is the same object as :class:`int` in the Python layer."

msgstr ""

"Esta instancia de :c:type:`PyTypeObject` representa el tipo entero de "

"Python. Este es el mismo objeto que :class:`int` en la capa de Python."

#: ../Doc/c-api/long.rst:29

msgid ""

"Return true if its argument is a :c:type:`PyLongObject` or a subtype of :c:"

"type:`PyLongObject`. This function always succeeds."

msgstr ""

"Retorna verdadero si su argumento es un :c:type:`PyLongObject` o un subtipo "

"de :c:type:`PyLongObject`. Esta función siempre finaliza con éxito."

#: ../Doc/c-api/long.rst:35

msgid ""

"Return true if its argument is a :c:type:`PyLongObject`, but not a subtype "

"of :c:type:`PyLongObject`. This function always succeeds."

msgstr ""

"Retorna verdadero si su argumento es un :c:type:`PyLongObject`, pero no un "

"subtipo de :c:type:`PyLongObject`. Esta función siempre finaliza con éxito."

#: ../Doc/c-api/long.rst:41

msgid ""

"Return a new :c:type:`PyLongObject` object from *v*, or ``NULL`` on failure."

msgstr ""

"Retorna un objeto :c:type:`PyLongObject` nuevo desde *v*, o ``NULL`` en caso "

"de error."

#: ../Doc/c-api/long.rst:45

#, fuzzy

msgid ""

"CPython keeps an array of integer objects for all integers between ``-5`` "

"and ``256``. When you create an int in that range you actually just get "

"back a reference to the existing object."

msgstr ""

"La implementación actual mantiene un arreglo de objetos enteros para todos "

"los enteros entre ``-5`` y ``256``. Cuando crea un *int* en ese rango, en "

"realidad solo obtiene una referencia al objeto existente."

#: ../Doc/c-api/long.rst:52

msgid ""

"Return a new :c:type:`PyLongObject` object from a C :c:expr:`unsigned long`, "

"or ``NULL`` on failure."

msgstr ""

"Retorna un objeto :c:type:`PyLongObject` nuevo desde un C :c:expr:`unsigned "

"long`, o ``NULL`` en caso de error."

#: ../Doc/c-api/long.rst:58

msgid ""

"Return a new :c:type:`PyLongObject` object from a C :c:type:`Py_ssize_t`, or "

"``NULL`` on failure."

msgstr ""

"Retorna un objeto :c:type:`PyLongObject` nuevo desde un C :c:type:"

"`Py_ssize_t`, o ``NULL`` en caso de error."

#: ../Doc/c-api/long.rst:64

msgid ""

"Return a new :c:type:`PyLongObject` object from a C :c:type:`size_t`, or "

"``NULL`` on failure."

msgstr ""

"Retorna un objeto :c:type:`PyLongObject` nuevo desde un C :c:type:`size_t`, "

"o ``NULL`` en caso de error."

#: ../Doc/c-api/long.rst:70

msgid ""

"Return a new :c:type:`PyLongObject` object from a C :c:expr:`long long`, or "

"``NULL`` on failure."

msgstr ""

"Retorna un objeto :c:type:`PyLongObject` nuevo desde un C :c:expr:`long "

"long`, o ``NULL`` en caso de error."

#: ../Doc/c-api/long.rst:77

#, fuzzy

msgid ""

"Return a new :c:type:`PyLongObject` object from a signed C :c:expr:`int32_t` "

"or :c:expr:`int64_t`, or ``NULL`` with an exception set on failure."

msgstr ""

"Retorna un objeto :c:type:`PyLongObject` nuevo desde un C :c:type:`size_t`, "

"o ``NULL`` en caso de error."

#: ../Doc/c-api/long.rst:86

msgid ""

"Return a new :c:type:`PyLongObject` object from a C :c:expr:`unsigned long "

"long`, or ``NULL`` on failure."

msgstr ""

"Retorna un objeto :c:type:`PyLongObject` nuevo desde un C :c:expr:`unsigned "

"long long`, o ``NULL`` en caso de error."

#: ../Doc/c-api/long.rst:93

#, fuzzy

msgid ""

"Return a new :c:type:`PyLongObject` object from an unsigned C :c:expr:"

"`uint32_t` or :c:expr:`uint64_t`, or ``NULL`` with an exception set on "

"failure."

msgstr ""

"Retorna un objeto :c:type:`PyLongObject` nuevo desde un C :c:expr:`unsigned "

"long`, o ``NULL`` en caso de error."

#: ../Doc/c-api/long.rst:102

msgid ""

"Return a new :c:type:`PyLongObject` object from the integer part of *v*, or "

"``NULL`` on failure."

msgstr ""

"Retorna un nuevo objeto :c:type:`PyLongObject` de la parte entera de *v*, o "

"``NULL`` en caso de error."

#: ../Doc/c-api/long.rst:108

msgid ""

"Return a new :c:type:`PyLongObject` based on the string value in *str*, "

"which is interpreted according to the radix in *base*, or ``NULL`` on "

"failure. If *pend* is non-``NULL``, *\\*pend* will point to the end of "

"*str* on success or to the first character that could not be processed on "

"error. If *base* is ``0``, *str* is interpreted using the :ref:`integers` "

"definition; in this case, leading zeros in a non-zero decimal number raises "

"a :exc:`ValueError`. If *base* is not ``0``, it must be between ``2`` and "

"``36``, inclusive. Leading and trailing whitespace and single underscores "

"after a base specifier and between digits are ignored. If there are no "

"digits or *str* is not NULL-terminated following the digits and trailing "

"whitespace, :exc:`ValueError` will be raised."

msgstr ""

"Retorna un nuevo :c:type:`PyLongObject` basado en el valor de cadena de "

"caracteres en *str*, que se interpreta de acuerdo con la raíz en *base*, o "

"``NULL`` en caso de error. Si *pend* no es ``NULL``, *\\*pend* apuntará al "

"final de *str* en caso de éxito o al primer carácter que no se pudo procesar "

"en caso de error. Si *base* es ``0``, *str* se interpreta utilizando la "

"definición :ref:`integers`; en este caso, los ceros a la izquierda en un "

"número decimal distinto de cero lanzan un :exc:`ValueError`. Si *base* no es "

"``0``, debe estar entre ``2`` y ``36``, inclusive. Se ignoran los espacios "

"iniciales y finales y los guiones bajos individuales después de un "

"especificador base y entre dígitos. Si no hay dígitos o *str* no termina en "

"NULL después de los dígitos y los espacios finales, se lanzará :exc:"

"`ValueError`."

#: ../Doc/c-api/long.rst:119

msgid ""

":c:func:`PyLong_AsNativeBytes()` and :c:func:`PyLong_FromNativeBytes()` "

"functions can be used to convert a :c:type:`PyLongObject` to/from an array "

"of bytes in base ``256``."

msgstr ""

#: ../Doc/c-api/long.rst:126

msgid ""

"Convert a sequence of Unicode digits in the string *u* to a Python integer "

"value."

msgstr ""

"Convierte una secuencia de dígitos Unicode en la cadena de caracteres *u* en "

"un valor entero de Python."

#: ../Doc/c-api/long.rst:134

msgid ""

"Create a Python integer from the pointer *p*. The pointer value can be "

"retrieved from the resulting value using :c:func:`PyLong_AsVoidPtr`."

msgstr ""

"Crea un entero de Python desde el puntero *p*. El valor del puntero se puede "

"recuperar del valor resultante usando :c:func:`PyLong_AsVoidPtr`."

#: ../Doc/c-api/long.rst:140

msgid ""

"Create a Python integer from the value contained in the first *n_bytes* of "

"*buffer*, interpreted as a two's-complement signed number."

msgstr ""

"Crea un entero de Python desde el valor contenido en los primeros *n_bytes* "

"de *buffer*, interpretado como un número con signo del complemento a dos."

#: ../Doc/c-api/long.rst:143

msgid ""

"*flags* are as for :c:func:`PyLong_AsNativeBytes`. Passing ``-1`` will "

"select the native endian that CPython was compiled with and assume that the "

"most-significant bit is a sign bit. Passing "

"``Py_ASNATIVEBYTES_UNSIGNED_BUFFER`` will produce the same result as "

"calling :c:func:`PyLong_FromUnsignedNativeBytes`. Other flags are ignored."

msgstr ""

"*flags* son los mismos que para :c:func:`PyLong_AsNativeBytes`. Al pasar "

"``-1`` seleccionará el endian nativo con el que CPython fue compilado y "

"asumirá que el bit más significativo es un bit de signo. Al pasar "

"``Py_ASNATIVEBYTES_UNSIGNED_BUFFER`` producirá el mismo resultado que llamar "

"a :c:func:`PyLong_FromUnsignedNativeBytes`. Otros indicadores se ignoran."

#: ../Doc/c-api/long.rst:154

msgid ""

"Create a Python integer from the value contained in the first *n_bytes* of "

"*buffer*, interpreted as an unsigned number."

msgstr ""

"Crea un entero de Python desde el valor contenido en los primeros *n_bytes* "

"de *buffer*, interpretado como un número sin signo."

#: ../Doc/c-api/long.rst:157

msgid ""

"*flags* are as for :c:func:`PyLong_AsNativeBytes`. Passing ``-1`` will "

"select the native endian that CPython was compiled with and assume that the "

"most-significant bit is not a sign bit. Flags other than endian are ignored."

msgstr ""

"*flags* son los mismos que para :c:func:`PyLong_AsNativeBytes`. Al pasar "

"``-1`` seleccionará el endian nativo con el que CPython fue compilado y "

"asumirá que el bit más significativo no es un bit con signo. Los indicadores "

"que no sean endian se ignoran."

#: ../Doc/c-api/long.rst:170 ../Doc/c-api/long.rst:206

msgid ""

"Return a C :c:expr:`long` representation of *obj*. If *obj* is not an "

"instance of :c:type:`PyLongObject`, first call its :meth:`~object.__index__` "

"method (if present) to convert it to a :c:type:`PyLongObject`."

msgstr ""

"Retorna una representación C :c:expr:`long` de *obj*. Si *obj* no es una "

"instancia de :c:type:`PyLongObject`, primero llama a su método :meth:"

"`~object.__index__` (si está presente) para convertirlo en un :c:type:"

"`PyLongObject`."

#: ../Doc/c-api/long.rst:174

msgid ""

"Raise :exc:`OverflowError` if the value of *obj* is out of range for a :c:"

"expr:`long`."

msgstr ""

"Lanza :exc:`OverflowError` si el valor de *obj* está fuera de rango para un :"

"c:expr:`long`."

#: ../Doc/c-api/long.rst:177 ../Doc/c-api/long.rst:215

#: ../Doc/c-api/long.rst:236 ../Doc/c-api/long.rst:256

#: ../Doc/c-api/long.rst:279

msgid "Returns ``-1`` on error. Use :c:func:`PyErr_Occurred` to disambiguate."

msgstr ""

"Retorna ``-1`` en caso de error. Use :c:func:`PyErr_Occurred` para "

"desambiguar."

#: ../Doc/c-api/long.rst:179 ../Doc/c-api/long.rst:217

#: ../Doc/c-api/long.rst:238 ../Doc/c-api/long.rst:260

#: ../Doc/c-api/long.rst:344 ../Doc/c-api/long.rst:364

msgid "Use :meth:`~object.__index__` if available."

msgstr "Use :meth:`~object.__index__` si está disponible."

#: ../Doc/c-api/long.rst:182 ../Doc/c-api/long.rst:220

#: ../Doc/c-api/long.rst:241 ../Doc/c-api/long.rst:263

#: ../Doc/c-api/long.rst:347 ../Doc/c-api/long.rst:367

msgid "This function will no longer use :meth:`~object.__int__`."

msgstr "Esta función no usará más :meth:`~object.__int__`."

#: ../Doc/c-api/long.rst:189

msgid ""

"A :term:`soft deprecated` alias. Exactly equivalent to the preferred "

"``PyLong_AsLong``. In particular, it can fail with :exc:`OverflowError` or "

"another exception."

msgstr ""

"Un alias :term:`soft deprecated`. Equivalente exacto al ``PyLong_AsLong`` "

"preferido. En particular, puede fallar con :exc:`OverflowError` u otra "

"excepción."

#: ../Doc/c-api/long.rst:193

msgid "The function is soft deprecated."

msgstr "La función está deprecada de forma suave."

#: ../Doc/c-api/long.rst:198

msgid ""

"Similar to :c:func:`PyLong_AsLong`, but store the result in a C :c:expr:"

"`int` instead of a C :c:expr:`long`."

msgstr ""

"Similar a :c:func:`PyLong_AsLong`, pero almacena el resultado en un C :c:"

"expr:`int` en lugar de un C :c:expr:`long`."

#: ../Doc/c-api/long.rst:210

msgid ""

"If the value of *obj* is greater than :c:macro:`LONG_MAX` or less than :c:"

"macro:`LONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, and "

"return ``-1``; otherwise, set *\\*overflow* to ``0``. If any other "

"exception occurs set *\\*overflow* to ``0`` and return ``-1`` as usual."

msgstr ""

"Si el valor de *obj* es mayor que :c:macro:`LONG_MAX` o menor que :c:macro:"

"`LONG_MIN`, establece *\\*overflow* en ``1`` o ``-1``, respectivamente, y "

"retorna ``-1``; de lo contrario, establece *\\*overflow* en ``0``. Si se "

"produce alguna otra excepción, configura *\\*overflow* en ``0`` y retorna "

"``-1`` como de costumbre."

#: ../Doc/c-api/long.rst:229 ../Doc/c-api/long.rst:247

msgid ""

"Return a C :c:expr:`long long` representation of *obj*. If *obj* is not an "

"instance of :c:type:`PyLongObject`, first call its :meth:`~object.__index__` "

"method (if present) to convert it to a :c:type:`PyLongObject`."

msgstr ""

"Retorna una representación C :c:expr:`long long` de *obj*. Si *obj* no es "

"una instancia de :c:type:`PyLongObject`, primero llame a su método :meth:"

"`~object.__index__` (si está presente) para convertirlo en un :c:type:"

"`PyLongObject`."

#: ../Doc/c-api/long.rst:233

msgid ""

"Raise :exc:`OverflowError` if the value of *obj* is out of range for a :c:"

"expr:`long long`."

msgstr ""

"Lanza :exc:`OverflowError` si el valor de *obj* está fuera de rango para un :"

"c:expr:`long long`."

#: ../Doc/c-api/long.rst:251

msgid ""

"If the value of *obj* is greater than :c:macro:`LLONG_MAX` or less than :c:"

"macro:`LLONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, and "

"return ``-1``; otherwise, set *\\*overflow* to ``0``. If any other "

"exception occurs set *\\*overflow* to ``0`` and return ``-1`` as usual."

msgstr ""

"Si el valor de *obj* es mayor que :c:macro:`LLONG_MAX` o menor que :c:macro:"

"`LLONG_MIN`, establece *\\*overflow* en ``1`` o ``-1``, respectivamente, y "

"retorna ``-1``; de lo contrario, establece *\\*overflow* en ``0``. Si se "

"produce alguna otra excepción, configura *\\*overflow* en ``0`` y retorna "

"``-1`` como de costumbre."

#: ../Doc/c-api/long.rst:273

msgid ""

"Return a C :c:type:`Py_ssize_t` representation of *pylong*. *pylong* must "

"be an instance of :c:type:`PyLongObject`."

msgstr ""

"Retorna una representación de C :c:type:`Py_ssize_t` de *pylong*. *pylong* "

"debe ser una instancia de :c:type:`PyLongObject`."

#: ../Doc/c-api/long.rst:276

msgid ""

"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:"

"type:`Py_ssize_t`."

msgstr ""

"Lanza :exc:`OverflowError` si el valor de *pylong* está fuera de rango para "

"un :c:type:`Py_ssize_t`."

#: ../Doc/c-api/long.rst:288

msgid ""

"Return a C :c:expr:`unsigned long` representation of *pylong*. *pylong* "

"must be an instance of :c:type:`PyLongObject`."

msgstr ""

"Retorna una representación de C :c:expr:`unsigned long` de *pylong*. "

"*pylong* debe ser una instancia de :c:type:`PyLongObject`."

#: ../Doc/c-api/long.rst:291

msgid ""

"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:"

"expr:`unsigned long`."

msgstr ""

"Lanza :exc:`OverflowError` si el valor de *pylong* está fuera de rango para "

"un :c:expr:`unsigned long`."

#: ../Doc/c-api/long.rst:294

msgid ""

"Returns ``(unsigned long)-1`` on error. Use :c:func:`PyErr_Occurred` to "

"disambiguate."

msgstr ""

"Retorna ``(unsigned long)-1`` en caso de error. Use :c:func:`PyErr_Occurred` "

"para desambiguar."

#: ../Doc/c-api/long.rst:304

msgid ""

"Return a C :c:type:`size_t` representation of *pylong*. *pylong* must be an "

"instance of :c:type:`PyLongObject`."

msgstr ""

"Retorna una representación de C :c:type:`size_t` de *pylong*. *pylong* debe "

"ser una instancia de :c:type:`PyLongObject`."

#: ../Doc/c-api/long.rst:307

msgid ""

"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:"

"type:`size_t`."

msgstr ""

"Lanza :exc:`OverflowError` si el valor de *pylong* está fuera de rango para "

"un :c:type:`size_t`."

#: ../Doc/c-api/long.rst:310

msgid ""

"Returns ``(size_t)-1`` on error. Use :c:func:`PyErr_Occurred` to "

"disambiguate."

msgstr ""

"Retorna ``(size_t) -1`` en caso de error. Use :c:func:`PyErr_Occurred` para "

"desambiguar."

#: ../Doc/c-api/long.rst:319

msgid ""

"Return a C :c:expr:`unsigned long long` representation of *pylong*. "

"*pylong* must be an instance of :c:type:`PyLongObject`."

msgstr ""

"Retorna una representación de C :c:expr:`unsigned long long` de *pylong*. "

"*pylong* debe ser una instancia de :c:type:`PyLongObject`."

#: ../Doc/c-api/long.rst:322

msgid ""

"Raise :exc:`OverflowError` if the value of *pylong* is out of range for an :"

"c:expr:`unsigned long long`."

msgstr ""

"Lanza :exc:`OverflowError` si el valor de *pylong* está fuera de rango para "

"un :c:expr:`unsigned long long`."

#: ../Doc/c-api/long.rst:325

msgid ""

"Returns ``(unsigned long long)-1`` on error. Use :c:func:`PyErr_Occurred` to "

"disambiguate."

msgstr ""

"Retorna ``(unsigned long long) -1`` en caso de error. Use :c:func:"

"`PyErr_Occurred` para desambiguar."

#: ../Doc/c-api/long.rst:328

msgid ""

"A negative *pylong* now raises :exc:`OverflowError`, not :exc:`TypeError`."

msgstr ""

"Ahora un *pylong* negativo lanza un :exc:`OverflowError`, no :exc:"

"`TypeError`."

#: ../Doc/c-api/long.rst:334

msgid ""

"Return a C :c:expr:`unsigned long` representation of *obj*. If *obj* is not "

"an instance of :c:type:`PyLongObject`, first call its :meth:`~object."

"__index__` method (if present) to convert it to a :c:type:`PyLongObject`."

msgstr ""

"Retorna una representación C :c:expr:`unsigned long` de *obj*. Si *obj* no "

"es una instancia de :c:type:`PyLongObject`, primero llame a su método :meth:"

"`~object.__index__` (si está presente) para convertirlo en un :c:type:"

"`PyLongObject`."

#: ../Doc/c-api/long.rst:338

msgid ""

"If the value of *obj* is out of range for an :c:expr:`unsigned long`, return "

"the reduction of that value modulo ``ULONG_MAX + 1``."

msgstr ""

"Si el valor de *obj* está fuera del rango para :c:expr:`unsigned long`, "

"retorna la reducción de ese valor módulo ``ULONG_MAX + 1``."

#: ../Doc/c-api/long.rst:341

msgid ""

"Returns ``(unsigned long)-1`` on error. Use :c:func:`PyErr_Occurred` to "

"disambiguate."

msgstr ""

"Retorna ``(unsigned long)-1`` en caso de error. Use :c:func:`PyErr_Occurred` "

"para desambiguar."

#: ../Doc/c-api/long.rst:353

msgid ""

"Return a C :c:expr:`unsigned long long` representation of *obj*. If *obj* "

"is not an instance of :c:type:`PyLongObject`, first call its :meth:`~object."

"__index__` method (if present) to convert it to a :c:type:`PyLongObject`."

msgstr ""

"Retorna una representación C :c:expr:`unsigned long long` de *obj*. Si *obj* "

"no es una instancia de :c:type:`PyLongObject`, primero llame a su método :"

"meth:`~object.__index__` (si está presente) para convertirlo en un :c:type:"

"`PyLongObject`."

#: ../Doc/c-api/long.rst:358

msgid ""

"If the value of *obj* is out of range for an :c:expr:`unsigned long long`, "

"return the reduction of that value modulo ``ULLONG_MAX + 1``."

msgstr ""

"Si el valor de *obj* está fuera del rango para :c:expr:`unsigned long long`, "

"retorna la reducción de ese valor módulo ``ULLONG_MAX + 1``."

#: ../Doc/c-api/long.rst:361

msgid ""

"Returns ``(unsigned long long)-1`` on error. Use :c:func:`PyErr_Occurred` "

"to disambiguate."

msgstr ""

"Retorna ``(unsigned long long) -1`` por error. Use :c:func:`PyErr_Occurred` "

"para desambiguar."

#: ../Doc/c-api/long.rst:374

msgid ""

"Set *\\*value* to a signed C :c:expr:`int32_t` or :c:expr:`int64_t` "

"representation of *obj*."

msgstr ""

#: ../Doc/c-api/long.rst:377 ../Doc/c-api/long.rst:397

#, fuzzy

msgid ""

"If *obj* is not an instance of :c:type:`PyLongObject`, first call its :meth:"

"`~object.__index__` method (if present) to convert it to a :c:type:"

"`PyLongObject`."

msgstr ""

"Retorna una representación C :c:expr:`long` de *obj*. Si *obj* no es una "

"instancia de :c:type:`PyLongObject`, primero llama a su método :meth:"

"`~object.__index__` (si está presente) para convertirlo en un :c:type:"

"`PyLongObject`."

#: ../Doc/c-api/long.rst:381 ../Doc/c-api/long.rst:402

msgid "If the *obj* value is out of range, raise an :exc:`OverflowError`."

msgstr ""

#: ../Doc/c-api/long.rst:383 ../Doc/c-api/long.rst:404

msgid ""

"Set *\\*value* and return ``0`` on success. Set an exception and return "

"``-1`` on error."

msgstr ""

#: ../Doc/c-api/long.rst:386 ../Doc/c-api/long.rst:407

msgid "*value* must not be ``NULL``."

msgstr ""

#: ../Doc/c-api/long.rst:394

msgid ""

"Set *\\*value* to an unsigned C :c:expr:`uint32_t` or :c:expr:`uint64_t` "

"representation of *obj*."

msgstr ""

#: ../Doc/c-api/long.rst:401

msgid "If *obj* is negative, raise a :exc:`ValueError`."

msgstr ""

#: ../Doc/c-api/long.rst:414

msgid ""

"Return a C :c:expr:`double` representation of *pylong*. *pylong* must be an "

"instance of :c:type:`PyLongObject`."

msgstr ""

"Retorna una representación de C :c:expr:`double` de *pylong*. *pylong* debe "

"ser una instancia de :c:type:`PyLongObject`."

#: ../Doc/c-api/long.rst:417

msgid ""

"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:"

"expr:`double`."

msgstr ""

"Lanza :exc:`OverflowError` si el valor de *pylong* está fuera de rango para "

"un :c:expr:`double`."

#: ../Doc/c-api/long.rst:420

msgid ""

"Returns ``-1.0`` on error. Use :c:func:`PyErr_Occurred` to disambiguate."

msgstr ""

"Retorna ``-1.0`` en caso de error. Use :c:func:`PyErr_Occurred` para "

"desambiguar."

#: ../Doc/c-api/long.rst:425

msgid ""

"Convert a Python integer *pylong* to a C :c:expr:`void` pointer. If *pylong* "

"cannot be converted, an :exc:`OverflowError` will be raised. This is only "

"assured to produce a usable :c:expr:`void` pointer for values created with :"

"c:func:`PyLong_FromVoidPtr`."

msgstr ""

"Convierte un entero Python *pylong* en un puntero C :c:expr:`void`. Si "

"*pylong* no se puede convertir, se lanzará un :exc:`OverflowError`. Esto "

"solo se garantiza para producir un puntero utilizable :c:expr:`void` para "

"valores creados con :c:func:`PyLong_FromVoidPtr`."

#: ../Doc/c-api/long.rst:430

msgid ""

"Returns ``NULL`` on error. Use :c:func:`PyErr_Occurred` to disambiguate."

msgstr ""

"Retorna ``NULL`` en caso de error. Use :c:func:`PyErr_Occurred` para "

"desambiguar."

#: ../Doc/c-api/long.rst:435

msgid ""

"Copy the Python integer value *pylong* to a native *buffer* of size "

"*n_bytes*. The *flags* can be set to ``-1`` to behave similarly to a C cast, "

"or to values documented below to control the behavior."

msgstr ""

"Copia el valor entero de Python *pylong* a un *buffer* nativo de tamaño "

"*n_bytes*. Los *flags* pueden establecerse en ``-1`` para un comportamiento "

"similar a una conversión de C, o en los valores documentados a continuación "

"para controlar el comportamiento."

#: ../Doc/c-api/long.rst:439

msgid ""

"Returns ``-1`` with an exception raised on error. This may happen if "

"*pylong* cannot be interpreted as an integer, or if *pylong* was negative "

"and the ``Py_ASNATIVEBYTES_REJECT_NEGATIVE`` flag was set."

msgstr ""

"Retorna ``-1`` con una excepción lanzada en caso de error. Esto puede "

"ocurrir si *pylong* no se puede interpretar como un entero, o si *pylong* "

"era negativo y se configuró el indicador "

"``Py_ASNATIVEBYTES_REJECT_NEGATIVE``."

#: ../Doc/c-api/long.rst:443

msgid ""

"Otherwise, returns the number of bytes required to store the value. If this "

"is equal to or less than *n_bytes*, the entire value was copied. All "

"*n_bytes* of the buffer are written: large buffers are padded with zeroes."

msgstr ""

"De lo contrario, retorna el número de bytes necesarios para almacenar el "

"valor. Si es igual o menor que *n_bytes*, se copió el valor completo. Se "

"escriben todos los *n_bytes* del búfer: los búferes grandes se rellenan con "

"ceros."

#: ../Doc/c-api/long.rst:448

#, fuzzy

msgid ""

"If the returned value is greater than *n_bytes*, the value was truncated: as "

"many of the lowest bits of the value as could fit are written, and the "

"higher bits are ignored. This matches the typical behavior of a C-style "

"downcast."

msgstr ""

"Si el valor que se retorna es mayor que *n_bytes*, se trunca el valor: se "

"escriben todos los bits más bajos que quepan y se ignoran los bits más "

"altos. Esto coincide con el comportamiento típico de una conversión "

"descendente de estilo C."

#: ../Doc/c-api/long.rst:455

msgid ""

"Overflow is not considered an error. If the returned value is larger than "

"*n_bytes*, most significant bits were discarded."

msgstr ""

"El desbordamiento no se considera un error. Si el valor que se retorna es "

"mayor que *n_bytes*, se descartan los bits más significativos."

#: ../Doc/c-api/long.rst:458

msgid "``0`` will never be returned."

msgstr "``0`` nunca será retornado."

#: ../Doc/c-api/long.rst:460

msgid "Values are always copied as two's-complement."

msgstr "Los valores siempre se copian como complemento a dos."

#: ../Doc/c-api/long.rst:462

msgid "Usage example::"

msgstr "Ejemplo de uso::"

#: ../Doc/c-api/long.rst:464

#, python-brace-format

msgid ""

"int32_t value;\n"

"Py_ssize_t bytes = PyLong_AsNativeBytes(pylong, &value, sizeof(value), -1);\n"

"if (bytes < 0) {\n"

" // Failed. A Python exception was set with the reason.\n"

" return NULL;\n"

"}\n"

"else if (bytes <= (Py_ssize_t)sizeof(value)) {\n"

" // Success!\n"

"}\n"

"else {\n"

" // Overflow occurred, but 'value' contains the truncated\n"

" // lowest bits of pylong.\n"

"}"

msgstr ""

"int32_t value;\n"

"Py_ssize_t bytes = PyLong_AsNativeBytes(pylong, &value, sizeof(value), -1);\n"

"if (bytes < 0) {\n"

" // Error. Se estableció una excepción de Python con el motivo.\n"

" return NULL;\n"

"}\n"

"else if (bytes <= (Py_ssize_t)sizeof(value)) {\n"

" // ¡Éxito!\n"

"}\n"

"else {\n"

" // Se produjo un desbordamiento, pero 'value' contiene\n"

" // los bits más bajos truncados de pylong.\n"

"}"

#: ../Doc/c-api/long.rst:478

msgid ""

"Passing zero to *n_bytes* will return the size of a buffer that would be "

"large enough to hold the value. This may be larger than technically "

"necessary, but not unreasonably so. If *n_bytes=0*, *buffer* may be ``NULL``."

msgstr ""

"Al pasar cero a *n_bytes* retornará el tamaño de un búfer lo suficientemente "

"grande como para contener el valor. Este tamaño puede ser mayor de lo "

"técnicamente necesario, pero no excesivamente grande. Si *n_bytes=0*, "

"*buffer* puede ser ``NULL``."

#: ../Doc/c-api/long.rst:485

msgid ""

"Passing *n_bytes=0* to this function is not an accurate way to determine the "

"bit length of the value."

msgstr ""

"Al pasar *n_bytes=0* a esta función no es una forma precisa de determinar la "

"longitud en bits del valor."

#: ../Doc/c-api/long.rst:488

msgid ""

"To get at the entire Python value of an unknown size, the function can be "

"called twice: first to determine the buffer size, then to fill it::"

msgstr ""

"Para obtener el valor completo de Python de un tamaño desconocido, la "

"función se puede llamar dos veces: primero para determinar el tamaño del "

"búfer y luego para llenarlo::"

#: ../Doc/c-api/long.rst:491

#, python-brace-format

msgid ""

"// Ask how much space we need.\n"

"Py_ssize_t expected = PyLong_AsNativeBytes(pylong, NULL, 0, -1);\n"

"if (expected < 0) {\n"

" // Failed. A Python exception was set with the reason.\n"

" return NULL;\n"

"}\n"

"assert(expected != 0); // Impossible per the API definition.\n"

"uint8_t *bignum = malloc(expected);\n"

"if (!bignum) {\n"

" PyErr_SetString(PyExc_MemoryError, \"bignum malloc failed.\");\n"

" return NULL;\n"

"}\n"

"// Safely get the entire value.\n"

"Py_ssize_t bytes = PyLong_AsNativeBytes(pylong, bignum, expected, -1);\n"

"if (bytes < 0) { // Exception has been set.\n"

" free(bignum);\n"

" return NULL;\n"

"}\n"

"else if (bytes > expected) { // This should not be possible.\n"

" PyErr_SetString(PyExc_RuntimeError,\n"

" \"Unexpected bignum truncation after a size check.\");\n"

" free(bignum);\n"

" return NULL;\n"

"}\n"

"// The expected success given the above pre-check.\n"

"// ... use bignum ...\n"

"free(bignum);"

msgstr ""

"// Pide cuánto espacio necesitamos.\n"

"Py_ssize_t expected = PyLong_AsNativeBytes(pylong, NULL, 0, -1);\n"

"if (expected < 0) {\n"

" // Error. Se estableció una excepción de Python con el motivo.\n"

" return NULL;\n"

"}\n"

"assert(expected != 0); // Imposible según la definición de la API.\n"

"uint8_t *bignum = malloc(expected);\n"

"if (!bignum) {\n"

" PyErr_SetString(PyExc_MemoryError, \"bignum malloc failed.\");\n"

" return NULL;\n"

"}\n"

"// Obtiene el valor completo de forma segura.\n"

"Py_ssize_t bytes = PyLong_AsNativeBytes(pylong, bignum, expected, -1);\n"

"if (bytes < 0) { // Se configuró una excepción.\n"

" free(bignum);\n"

" return NULL;\n"

"}\n"

"else if (bytes > expected) { // Esto no debería ser posible.\n"

" PyErr_SetString(PyExc_RuntimeError,\n"

" \"Unexpected bignum truncation after a size check.\");\n"

" free(bignum);\n"

" return NULL;\n"

"}\n"

"// El éxito esperado dada la comprobación previa.\n"

"// ... use bignum ...\n"

"free(bignum);"

#: ../Doc/c-api/long.rst:519

#, fuzzy

msgid ""

"*flags* is either ``-1`` (``Py_ASNATIVEBYTES_DEFAULTS``) to select defaults "

"that behave most like a C cast, or a combination of the other flags in the "

"table below. Note that ``-1`` cannot be combined with other flags."

msgstr ""

"*flags* es ``-1`` (``Py_ASNATIVEBYTES_DEFAULTS``) para seleccionar valores "

"predeterminados que se comportan de forma similar a una conversión de C, o "

"una combinación de los demás indicadores de la tabla a continuación. Tenga "

"en cuenta que ``-1`` no se puede combinar con otros indicadores."

#: ../Doc/c-api/long.rst:524

msgid ""

"Currently, ``-1`` corresponds to ``Py_ASNATIVEBYTES_NATIVE_ENDIAN | "

"Py_ASNATIVEBYTES_UNSIGNED_BUFFER``."

msgstr ""

"Actualmente, ``-1`` corresponde a ``Py_ASNATIVEBYTES_NATIVE_ENDIAN | "

"Py_ASNATIVEBYTES_UNSIGNED_BUFFER``."

#: ../Doc/c-api/long.rst:530

msgid "Flag"

msgstr "Indicador"

#: ../Doc/c-api/long.rst:530

msgid "Value"

msgstr "Valor"

#: ../Doc/c-api/long.rst:532

msgid "``-1``"

msgstr "``-1``"

#: ../Doc/c-api/long.rst:533

msgid "``0``"

msgstr "``0``"

#: ../Doc/c-api/long.rst:534

msgid "``1``"

msgstr "``1``"

#: ../Doc/c-api/long.rst:535

msgid "``3``"

msgstr "``3``"

#: ../Doc/c-api/long.rst:536

msgid "``4``"

msgstr "``4``"

#: ../Doc/c-api/long.rst:537

msgid "``8``"

msgstr "``8``"

#: ../Doc/c-api/long.rst:538

msgid "``16``"

msgstr "``16``"

#: ../Doc/c-api/long.rst:541

msgid ""

"Specifying ``Py_ASNATIVEBYTES_NATIVE_ENDIAN`` will override any other endian "

"flags. Passing ``2`` is reserved."

msgstr ""

"Especificar ``Py_ASNATIVEBYTES_NATIVE_ENDIAN`` redefinirá cualquier otro "

"indicador endian. Pasar ``2`` está reservado."

#: ../Doc/c-api/long.rst:544

msgid ""

"By default, sufficient buffer will be requested to include a sign bit. For "

"example, when converting 128 with *n_bytes=1*, the function will return 2 "

"(or more) in order to store a zero sign bit."

msgstr ""

"Por defecto, se solicitará búfer suficiente para incluir un bit de signo. "

"Por ejemplo, al convertir 128 con *n_bytes=1*, la función retornará 2 (o "

"más) para almacenar un bit de signo cero."

#: ../Doc/c-api/long.rst:548

msgid ""

"If ``Py_ASNATIVEBYTES_UNSIGNED_BUFFER`` is specified, a zero sign bit will "

"be omitted from size calculations. This allows, for example, 128 to fit in a "

"single-byte buffer. If the destination buffer is later treated as signed, a "

"positive input value may become negative. Note that the flag does not affect "

"handling of negative values: for those, space for a sign bit is always "

"requested."

msgstr ""

"Si se especifica ``Py_ASNATIVEBYTES_UNSIGNED_BUFFER``, se omitirá el bit de "

"signo cero en los cálculos de tamaño. Esto permite, por ejemplo, que quepa "

"128 en un búfer de un solo byte. Si el búfer de destino se trata "

"posteriormente como con signo, un valor de entrada positivo puede volverse "

"negativo. Tenga en cuenta que este indicador no afecta el manejo de valores "

"negativos: para ellos, siempre se solicita espacio para un bit de signo."

#: ../Doc/c-api/long.rst:555

msgid ""

"Specifying ``Py_ASNATIVEBYTES_REJECT_NEGATIVE`` causes an exception to be "

"set if *pylong* is negative. Without this flag, negative values will be "

"copied provided there is enough space for at least one sign bit, regardless "

"of whether ``Py_ASNATIVEBYTES_UNSIGNED_BUFFER`` was specified."

msgstr ""

"Especificar ``Py_ASNATIVEBYTES_REJECT_NEGATIVE``, se establece una excepción "

"si *pylong* es negativo. Sin este indicador, se copiarán los valores "

"negativos siempre que haya suficiente espacio para al menos un bit de signo, "

"independientemente de si se especificó ``Py_ASNATIVEBYTES_UNSIGNED_BUFFER``."

#: ../Doc/c-api/long.rst:560

msgid ""

"If ``Py_ASNATIVEBYTES_ALLOW_INDEX`` is specified and a non-integer value is "

"passed, its :meth:`~object.__index__` method will be called first. This may "

"result in Python code executing and other threads being allowed to run, "

"which could cause changes to other objects or values in use. When *flags* is "

"``-1``, this option is not set, and non-integer values will raise :exc:"

"`TypeError`."

msgstr ""

"Si se especifica ``Py_ASNATIVEBYTES_ALLOW_INDEX`` y se pasa un valor "

"distinto de un entero, se llamará primero a su método :meth:`~object."

"__index__`. Esto puede resultar la ejecución de código Python y la ejecución "

"de otros subprocesos, lo que podría causar cambios en otros objetos o "

"valores en uso. Cuando *flags* es ``-1``, esta opción no se establece y los "

"valores distintos de un entero lanzarán :exc:`TypeError`."

#: ../Doc/c-api/long.rst:569

msgid ""

"With the default *flags* (``-1``, or *UNSIGNED_BUFFER* without "

"*REJECT_NEGATIVE*), multiple Python integers can map to a single value "

"without overflow. For example, both ``255`` and ``-1`` fit a single-byte "

"buffer and set all its bits. This matches typical C cast behavior."

msgstr ""

"Con los *flags* predeterminados (``-1`` o *UNSIGNED_BUFFER* sin "

"*REJECT_NEGATIVE*), varios enteros de Python pueden asignarse a un único "

"valor sin desbordamiento. Por ejemplo, tanto ``255`` como ``-1`` se ajustan "

"a un búfer de un solo byte y configuran todos sus bits. Esto coincide con el "

"comportamiento típico de conversión de C."

#: ../Doc/c-api/long.rst:580

msgid "Get the sign of the integer object *obj*."

msgstr ""

#: ../Doc/c-api/long.rst:582

msgid ""

"On success, set *\\*sign* to the integer sign (0, -1 or +1 for zero, "

"negative or positive integer, respectively) and return 0."

msgstr ""

#: ../Doc/c-api/long.rst:585

msgid ""

"On failure, return -1 with an exception set. This function always succeeds "

"if *obj* is a :c:type:`PyLongObject` or its subtype."

msgstr ""

#: ../Doc/c-api/long.rst:593

msgid "Check if the integer object *obj* is positive (``obj > 0``)."

msgstr ""

#: ../Doc/c-api/long.rst:595

msgid ""

"If *obj* is an instance of :c:type:`PyLongObject` or its subtype, return "

"``1`` when it's positive and ``0`` otherwise. Else set an exception and "

"return ``-1``."

msgstr ""

#: ../Doc/c-api/long.rst:604

msgid "Check if the integer object *obj* is negative (``obj < 0``)."

msgstr ""

#: ../Doc/c-api/long.rst:606

msgid ""

"If *obj* is an instance of :c:type:`PyLongObject` or its subtype, return "

"``1`` when it's negative and ``0`` otherwise. Else set an exception and "

"return ``-1``."

msgstr ""

#: ../Doc/c-api/long.rst:615

msgid "Check if the integer object *obj* is zero."

msgstr ""

#: ../Doc/c-api/long.rst:617

msgid ""

"If *obj* is an instance of :c:type:`PyLongObject` or its subtype, return "

"``1`` when it's zero and ``0`` otherwise. Else set an exception and return "

"``-1``."

msgstr ""

#: ../Doc/c-api/long.rst:626

msgid ""

"On success, return a read only :term:`named tuple`, that holds information "

"about Python's internal representation of integers. See :data:`sys.int_info` "

"for description of individual fields."

msgstr ""

"En caso de éxito, retorna una :term:`named tuple` de solo lectura, que "

"contiene información sobre la representación interna de enteros en Python. "

"Consulte :data:`sys.int_info` para obtener una descripción de cada campo."

#: ../Doc/c-api/long.rst:630

msgid "On failure, return ``NULL`` with an exception set."

msgstr "En caso de error, retorna ``NULL`` con una excepción configurada."

#: ../Doc/c-api/long.rst:637

msgid "Return 1 if *op* is compact, 0 otherwise."

msgstr "Retorna 1 si *op* es compacto, 0 en caso contrario."

#: ../Doc/c-api/long.rst:639

msgid ""

"This function makes it possible for performance-critical code to implement a "

"“fast path” for small integers. For compact values use :c:func:"

"`PyUnstable_Long_CompactValue`; for others fall back to a :c:func:"

"`PyLong_As* <PyLong_AsSize_t>` function or :c:func:`PyLong_AsNativeBytes`."

msgstr ""

"Esta función permite que el código de rendimiento crítico implemente una "

"“ruta rápida” para enteros pequeños. Para valores compactos, utilice :c:func:"

"`PyUnstable_Long_CompactValue`; para otros, utilice una función :c:func:"

"`PyLong_As* <PyLong_AsSize_t>` o :c:func:`PyLong_AsNativeBytes`."

#: ../Doc/c-api/long.rst:645

msgid "The speedup is expected to be negligible for most users."

msgstr ""

"Se espera que la aceleración sea insignificante para la mayoría de los "

"usuarios."

#: ../Doc/c-api/long.rst:647

msgid ""

"Exactly what values are considered compact is an implementation detail and "

"is subject to change."

msgstr ""

"Exactamente qué valores se consideran compactos es un detalle de "

"implementación y está sujeto a cambios."

#: ../Doc/c-api/long.rst:655

msgid ""

"If *op* is compact, as determined by :c:func:`PyUnstable_Long_IsCompact`, "

"return its value."