# 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: 2022-10-25 19:47+0200\n"

"PO-Revision-Date: 2021-08-01 20:17+0200\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.10.3\n"

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

msgid "Capsules"

msgstr "Cápsulas"

#: ../Doc/c-api/capsule.rst:10

msgid ""

"Refer to :ref:`using-capsules` for more information on using these objects."

msgstr ""

"Consulta :ref:`using-capsules` para obtener más información sobre el uso de "

"estos objetos."

#: ../Doc/c-api/capsule.rst:17

#, fuzzy

msgid ""

"This subtype of :c:type:`PyObject` represents an opaque value, useful for C "

"extension modules who need to pass an opaque value (as a :c:expr:`void*` "

"pointer) through Python code to other C code. It is often used to make a C "

"function pointer defined in one module available to other modules, so the "

"regular import mechanism can be used to access C APIs defined in dynamically "

"loaded modules."

msgstr ""

"Este subtipo de :c:type:`PyObject` representa un valor opaco, útil para los "

"módulos de extensión C que necesitan pasar un valor opaco (como un puntero :"

"c:type:`void*`) a través del código Python a otro código C . A menudo se usa "

"para hacer que un puntero de función C definido en un módulo esté disponible "

"para otros módulos, por lo que el mecanismo de importación regular se puede "

"usar para acceder a las API C definidas en módulos cargados dinámicamente."

#: ../Doc/c-api/capsule.rst:27

msgid "The type of a destructor callback for a capsule. Defined as::"

msgstr ""

"El tipo de devolución de llamada de un destructor para una cápsula. Definido "

"como::"

#: ../Doc/c-api/capsule.rst:31

msgid ""

"See :c:func:`PyCapsule_New` for the semantics of PyCapsule_Destructor "

"callbacks."

msgstr ""

"Consulte :c:func:`PyCapsule_New` para conocer la semántica de las "

"devoluciones de llamada de `PyCapsule_Destructor`."

#: ../Doc/c-api/capsule.rst:37

msgid ""

"Return true if its argument is a :c:type:`PyCapsule`. This function always "

"succeeds."

msgstr ""

"Retorna verdadero si su argumento es a :c:type:`PyCapsule`. Esta función "

"siempre finaliza con éxito."

#: ../Doc/c-api/capsule.rst:43

msgid ""

"Create a :c:type:`PyCapsule` encapsulating the *pointer*. The *pointer* "

"argument may not be ``NULL``."

msgstr ""

"Crea un :c:type:`PyCapsule` encapsulando el *pointer*. El argumento "

"*pointer* puede no ser ``NULL``."

#: ../Doc/c-api/capsule.rst:46

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

msgstr "En caso de falla, establece una excepción y retorna ``NULL``."

#: ../Doc/c-api/capsule.rst:48

msgid ""

"The *name* string may either be ``NULL`` or a pointer to a valid C string. "

"If non-``NULL``, this string must outlive the capsule. (Though it is "

"permitted to free it inside the *destructor*.)"

msgstr ""

"La cadena de caracteres *name* puede ser ``NULL`` o un puntero a una cadena "

"C válida. Si no es ``NULL``, esta cadena de caracteres debe sobrevivir a la "

"cápsula. (Aunque está permitido liberarlo dentro del *destructor*)."

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

msgid ""

"If the *destructor* argument is not ``NULL``, it will be called with the "

"capsule as its argument when it is destroyed."

msgstr ""

"Si el argumento *destructor* no es ``NULL``, se llamará con la cápsula como "

"argumento cuando se destruya."

#: ../Doc/c-api/capsule.rst:55

msgid ""

"If this capsule will be stored as an attribute of a module, the *name* "

"should be specified as ``modulename.attributename``. This will enable other "

"modules to import the capsule using :c:func:`PyCapsule_Import`."

msgstr ""

"Si esta cápsula se almacenará como un atributo de un módulo, el nombre "

"*name* debe especificarse como ``modulename.attributename``. Esto permitirá "

"que otros módulos importen la cápsula usando :c:func:`PyCapsule_Import`."

#: ../Doc/c-api/capsule.rst:62

msgid ""

"Retrieve the *pointer* stored in the capsule. On failure, set an exception "

"and return ``NULL``."

msgstr ""

"Recupera el *pointer* almacenado en la cápsula. En caso de falla, establece "

"una excepción y retorna ``NULL``."

#: ../Doc/c-api/capsule.rst:65

msgid ""

"The *name* parameter must compare exactly to the name stored in the capsule. "

"If the name stored in the capsule is ``NULL``, the *name* passed in must "

"also be ``NULL``. Python uses the C function :c:func:`strcmp` to compare "

"capsule names."

msgstr ""

"El parámetro *name* debe compararse exactamente con el nombre almacenado en "

"la cápsula. Si el nombre almacenado en la cápsula es ``NULL``, el *name* "

"pasado también debe ser ``NULL``. Python usa la función C :c:func:`strcmp` "

"para comparar nombres de cápsulas."

#: ../Doc/c-api/capsule.rst:73

msgid ""

"Return the current destructor stored in the capsule. On failure, set an "

"exception and return ``NULL``."

msgstr ""

"Retorna el destructor actual almacenado en la cápsula. En caso de falla, "

"establece una excepción y retorna ``NULL``."

#: ../Doc/c-api/capsule.rst:76

msgid ""

"It is legal for a capsule to have a ``NULL`` destructor. This makes a "

"``NULL`` return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :"

"c:func:`PyErr_Occurred` to disambiguate."

msgstr ""

"Es legal que una cápsula tenga un destructor ``NULL``. Esto hace que un "

"código de retorno ``NULL`` sea algo ambiguo; use :c:func:`PyCapsule_IsValid` "

"o :c:func:`PyErr_Occurred` para desambiguar."

#: ../Doc/c-api/capsule.rst:83

msgid ""

"Return the current context stored in the capsule. On failure, set an "

"exception and return ``NULL``."

msgstr ""

"Retorna el contexto actual almacenado en la cápsula. En caso de falla, "

"establece una excepción y retorna ``NULL``."

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

msgid ""

"It is legal for a capsule to have a ``NULL`` context. This makes a ``NULL`` "

"return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:"

"`PyErr_Occurred` to disambiguate."

msgstr ""

"Es legal que una cápsula tenga un contexto ``NULL``. Esto hace que un código "

"de retorno ``NULL`` sea algo ambiguo; use :c:func:`PyCapsule_IsValid` o :c:"

"func:`PyErr_Occurred` para desambiguar."

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

msgid ""

"Return the current name stored in the capsule. On failure, set an exception "

"and return ``NULL``."

msgstr ""

"Retorna el nombre actual almacenado en la cápsula. En caso de falla, "

"establece una excepción y retorna ``NULL``."

#: ../Doc/c-api/capsule.rst:96

msgid ""

"It is legal for a capsule to have a ``NULL`` name. This makes a ``NULL`` "

"return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:"

"`PyErr_Occurred` to disambiguate."

msgstr ""

"Es legal que una cápsula tenga un nombre ``NULL``. Esto hace que un código "

"de retorno ``NULL`` sea algo ambiguo; use :c:func:`PyCapsule_IsValid` o :c:"

"func:`PyErr_Occurred` para desambiguar."

#: ../Doc/c-api/capsule.rst:103

#, fuzzy

msgid ""

"Import a pointer to a C object from a capsule attribute in a module. The "

"*name* parameter should specify the full name to the attribute, as in "

"``module.attribute``. The *name* stored in the capsule must match this "

"string exactly."

msgstr ""

"Importa un puntero a un objeto C desde un atributo cápsula en un módulo. El "

"parámetro *name* debe especificar el nombre completo del atributo, como en "

"``module.attribute``. El nombre *name* almacenado en la cápsula debe "

"coincidir exactamente con esta cadena de caracteres. Si *no_block* es "

"verdadero, importa el módulo sin bloquear (usando :c:func:"

"`PyImport_ImportModuleNoBlock`). Si *no_block* es falso, importa el módulo "

"convencionalmente (usando :c:func:`PyImport_ImportModule`)."

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

msgid ""

"Return the capsule's internal *pointer* on success. On failure, set an "

"exception and return ``NULL``."

msgstr ""

"Retorna el puntero *pointer* interno de la cápsula en caso de éxito. En caso "

"de falla, establece una excepción y retorna ``NULL``."

#: ../Doc/c-api/capsule.rst:111

msgid "*no_block* has no effect anymore."

msgstr ""

#: ../Doc/c-api/capsule.rst:117

msgid ""

"Determines whether or not *capsule* is a valid capsule. A valid capsule is "

"non-``NULL``, passes :c:func:`PyCapsule_CheckExact`, has a non-``NULL`` "

"pointer stored in it, and its internal name matches the *name* parameter. "

"(See :c:func:`PyCapsule_GetPointer` for information on how capsule names are "

"compared.)"

msgstr ""

"Determina si *capsule* es o no una cápsula válida. Una cápsula válida no es "

"``NULL``, pasa :c:func:`PyCapsule_CheckExact`, tiene un puntero no ``NULL`` "

"almacenado y su nombre interno coincide con el parámetro *name*. (Consulte :"

"c:func:`PyCapsule_GetPointer` para obtener información sobre cómo se "

"comparan los nombres de las cápsulas)."

#: ../Doc/c-api/capsule.rst:123

msgid ""

"In other words, if :c:func:`PyCapsule_IsValid` returns a true value, calls "

"to any of the accessors (any function starting with :c:func:`PyCapsule_Get`) "

"are guaranteed to succeed."

msgstr ""

"En otras palabras, si :c:func:`PyCapsule_IsValid` retorna un valor "

"verdadero, las llamadas a cualquiera de las funciones de acceso (cualquier "

"función que comience con :c:func:`PyCapsule_Get`) tienen éxito."

#: ../Doc/c-api/capsule.rst:127

msgid ""

"Return a nonzero value if the object is valid and matches the name passed "

"in. Return ``0`` otherwise. This function will not fail."

msgstr ""

"Retorna un valor distinto de cero si el objeto es válido y coincide con el "

"nombre pasado. Retorna ``0`` de lo contrario. Esta función no fallará."

#: ../Doc/c-api/capsule.rst:133

msgid "Set the context pointer inside *capsule* to *context*."

msgstr "Establece el puntero de contexto dentro de *capsule* a *context*."

#: ../Doc/c-api/capsule.rst:135 ../Doc/c-api/capsule.rst:142

#: ../Doc/c-api/capsule.rst:151 ../Doc/c-api/capsule.rst:159

msgid ""

"Return ``0`` on success. Return nonzero and set an exception on failure."

msgstr ""

"Retorna ``0`` en caso de éxito. Retorna distinto de cero y establece una "

"excepción en caso de error."

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

msgid "Set the destructor inside *capsule* to *destructor*."

msgstr "Establece el destructor dentro de *capsule* en *destructor*."

#: ../Doc/c-api/capsule.rst:147

msgid ""

"Set the name inside *capsule* to *name*. If non-``NULL``, the name must "

"outlive the capsule. If the previous *name* stored in the capsule was not "

"``NULL``, no attempt is made to free it."

msgstr ""

"Establece el nombre dentro de *capsule* a *name*. Si no es ``NULL``, el "

"nombre debe sobrevivir a la cápsula. Si el *name* anterior almacenado en la "

"cápsula no era ``NULL``, no se intenta liberarlo."

#: ../Doc/c-api/capsule.rst:156

msgid ""

"Set the void pointer inside *capsule* to *pointer*. The pointer may not be "

"``NULL``."

msgstr ""

"Establece el puntero vacío dentro de *capsule* a *pointer*. El puntero puede "

"no ser ``NULL``."