diff --git a/c-api/function.po b/c-api/function.po index 8cc916bc04..be33ef241d 100644 --- a/c-api/function.po +++ b/c-api/function.po @@ -12,7 +12,7 @@ msgstr "" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-11-21 16:38-0300\n" "PO-Revision-Date: 2021-12-09 10:29+0800\n" -"Last-Translator: Rodrigo Tobar \n" +"Last-Translator: Erick G. Islas-Osuna \n" "Language: es\n" "Language-Team: python-doc-es\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" @@ -36,22 +36,22 @@ msgstr "La estructura C utilizada para las funciones." #: ../Doc/c-api/function.rst:22 msgid "" "This is an instance of :c:type:`PyTypeObject` and represents the Python " -"function type. It is exposed to Python programmers as ``types." -"FunctionType``." +"function type. It is exposed to Python programmers as " +"``types.FunctionType``." msgstr "" "Esta es una instancia de :c:type:`PyTypeObject` y representa el tipo función " -"de Python. Está expuesto a los programadores de Python como ``types." -"FunctionType``." +"de Python. Está expuesto a los programadores de Python como " +"``types.FunctionType``." #: ../Doc/c-api/function.rst:28 msgid "" -"Return true if *o* is a function object (has type :c:data:" -"`PyFunction_Type`). The parameter must not be ``NULL``. This function " -"always succeeds." +"Return true if *o* is a function object (has " +"type :c:data:`PyFunction_Type`). The parameter must not be ``NULL``. This " +"function always succeeds." msgstr "" -"Retorna verdadero si *o* es un objeto función (tiene tipo :c:data:" -"`PyFunction_Type`). El parámetro no debe ser ``NULL``. Esta función siempre " -"finaliza con éxito." +"Retorna verdadero si *o* es un objeto función (tiene " +"tipo :c:data:`PyFunction_Type`). El parámetro no debe ser ``NULL``. Esta " +"función siempre finaliza con éxito." #: ../Doc/c-api/function.rst:34 msgid "" @@ -64,31 +64,32 @@ msgstr "" "la función." #: ../Doc/c-api/function.rst:37 -#, fuzzy msgid "" -"The function's docstring and name are retrieved from the code object. :attr:" -"`~function.__module__` is retrieved from *globals*. The argument defaults, " -"annotations and closure are set to ``NULL``. :attr:`~function.__qualname__` " -"is set to the same value as the code object's :attr:`~codeobject." -"co_qualname` field." +"The function's docstring and name are retrieved from the code " +"object. :attr:`~function.__module__` is retrieved from *globals*. The " +"argument defaults, annotations and closure are set to " +"``NULL``. :attr:`~function.__qualname__` is set to the same value as the " +"code object's :attr:`~codeobject.co_qualname` field." msgstr "" -"El docstring y el nombre de la función se obtiene del objeto código. " -"*__module__* se obtiene de *globals *. El argumento *defaults*, " -"*annotations* y *closure* se establecen en ``NULL``. *__qualname__* se " -"establece en el mismo valor que el nombre de la función." +"El docstring y el nombre de la función se obtienen del objeto " +"código. :attr:`~function.__module__` se obtiene de *globals*. Los argumentos " +"por defecto, anotaciones y clausura se establecen en " +"``NULL``. :attr:`~function.__qualname__` se establece en el mismo valor que " +"el campo :attr:`~codeobject.co_qualname` del objeto código." #: ../Doc/c-api/function.rst:46 -#, fuzzy msgid "" -"As :c:func:`PyFunction_New`, but also allows setting the function object's :" -"attr:`~function.__qualname__` attribute. *qualname* should be a unicode " -"object or ``NULL``; if ``NULL``, the :attr:`!__qualname__` attribute is set " -"to the same value as the code object's :attr:`~codeobject.co_qualname` field." +"As :c:func:`PyFunction_New`, but also allows setting the function " +"object's :attr:`~function.__qualname__` attribute. *qualname* should be a " +"unicode object or ``NULL``; if ``NULL``, the :attr:`!__qualname__` attribute " +"is set to the same value as the code " +"object's :attr:`~codeobject.co_qualname` field." msgstr "" -"Como :c:func:`PyFunction_New`, pero también permite configurar el atributo " -"``__qualname__`` del objeto función. *qualname* debe ser un objeto unicode o " -"``NULL``; si es ``NULL``, el atributo ``__qualname__`` se establece en el " -"mismo valor que su atributo ``__name__``." +"Como :c:func:`PyFunction_New`, pero también permite configurar el " +"atributo :attr:`~function.__qualname__` del objeto función. *qualname* debe " +"ser un objeto unicode o ``NULL``; si es ``NULL``, el atributo :attr:`!" +"__qualname__` se establece en el mismo valor que el " +"campo :attr:`~codeobject.co_qualname` del objeto código." #: ../Doc/c-api/function.rst:57 msgid "Return the code object associated with the function object *op*." @@ -99,24 +100,23 @@ msgid "Return the globals dictionary associated with the function object *op*." msgstr "Retorna el diccionario global asociado con el objeto función *op*." #: ../Doc/c-api/function.rst:67 -#, fuzzy msgid "" "Return a :term:`borrowed reference` to the :attr:`~function.__module__` " "attribute of the :ref:`function object ` *op*. It can be " "*NULL*." msgstr "" -"Retorna una referencia tomada (:term:`borrowed reference`) al atributo " -"*__module__* del objeto función *op*. Puede ser *NULL*." +"Retorna una :term:`referencia prestada` al " +"atributo :attr:`~function.__module__` del :ref:`objeto función ` *op*. Puede ser *NULL*." #: ../Doc/c-api/function.rst:71 -#, fuzzy msgid "" "This is normally a :class:`string ` containing the module name, but can " "be set to any other object by Python code." msgstr "" -"Éste es normalmente una cadena de caracteres que contiene el nombre del " -"módulo, pero se puede establecer en cualquier otro objeto mediante código " -"Python." +"Esto es normalmente una :class:`cadena de caracteres ` que contiene el " +"nombre del módulo, pero se puede establecer en cualquier otro objeto " +"mediante código Python." #: ../Doc/c-api/function.rst:77 msgid "" @@ -141,13 +141,15 @@ msgstr "Lanza :exc:`SystemError` y retorna ``-1`` en caso de error." #: ../Doc/c-api/function.rst:91 msgid "Set the vectorcall field of a given function object *func*." -msgstr "" +msgstr "Establece el campo vectorcall de un objeto función dado *func*." #: ../Doc/c-api/function.rst:93 msgid "" "Warning: extensions using this API must preserve the behavior of the " "unaltered (default) vectorcall function!" msgstr "" +"Advertencia: ¡las extensiones que usan esta API deben preservar el " +"comportamiento de la función vectorcall inalterada (por defecto)!" #: ../Doc/c-api/function.rst:100 msgid "" @@ -188,14 +190,22 @@ msgid "" "case of error (e.g. no more watcher IDs available), return ``-1`` and set an " "exception." msgstr "" +"Registra *callback* como un observador de función para el intérprete actual. " +"Retorna un ID que puede pasarse a :c:func:`PyFunction_ClearWatcher`. En caso " +"de error (por ejemplo, no hay más IDs de observador disponibles), retorna " +"``-1`` y establece una excepción." #: ../Doc/c-api/function.rst:138 msgid "" -"Clear watcher identified by *watcher_id* previously returned from :c:func:" -"`PyFunction_AddWatcher` for the current interpreter. Return ``0`` on " -"success, or ``-1`` and set an exception on error (e.g. if the given " -"*watcher_id* was never registered.)" +"Clear watcher identified by *watcher_id* previously returned " +"from :c:func:`PyFunction_AddWatcher` for the current interpreter. Return " +"``0`` on success, or ``-1`` and set an exception on error (e.g. if the " +"given *watcher_id* was never registered.)" msgstr "" +"Limpia el observador identificado por *watcher_id* previamente retornado " +"de :c:func:`PyFunction_AddWatcher` para el intérprete actual. Retorna ``0`` " +"en caso de éxito, o ``-1`` y establece una excepción en caso de error (por " +"ejemplo, si el *watcher_id* dado nunca fue registrado)." #: ../Doc/c-api/function.rst:148 msgid "" @@ -204,24 +214,34 @@ msgid "" "``PyFunction_EVENT_MODIFY_CODE`` - ``PyFunction_EVENT_MODIFY_DEFAULTS`` - " "``PyFunction_EVENT_MODIFY_KWDEFAULTS``" msgstr "" +"Enumeración de posibles eventos de observador de función: - " +"``PyFunction_EVENT_CREATE`` - ``PyFunction_EVENT_DESTROY`` - " +"``PyFunction_EVENT_MODIFY_CODE`` - ``PyFunction_EVENT_MODIFY_DEFAULTS`` - " +"``PyFunction_EVENT_MODIFY_KWDEFAULTS``" #: ../Doc/c-api/function.rst:160 msgid "Type of a function watcher callback function." -msgstr "" +msgstr "Tipo de una función callback de observador de función." #: ../Doc/c-api/function.rst:162 msgid "" "If *event* is ``PyFunction_EVENT_CREATE`` or ``PyFunction_EVENT_DESTROY`` " -"then *new_value* will be ``NULL``. Otherwise, *new_value* will hold a :term:" -"`borrowed reference` to the new value that is about to be stored in *func* " -"for the attribute that is being modified." +"then *new_value* will be ``NULL``. Otherwise, *new_value* will hold " +"a :term:`borrowed reference` to the new value that is about to be stored in " +"*func* for the attribute that is being modified." msgstr "" +"Si *event* es ``PyFunction_EVENT_CREATE`` o ``PyFunction_EVENT_DESTROY`` " +"entonces *new_value* será ``NULL``. De lo contrario, *new_value* mantendrá " +"una :term:`referencia prestada` al nuevo valor que está a punto de " +"almacenarse en *func* para el atributo que se está modificando." #: ../Doc/c-api/function.rst:167 msgid "" "The callback may inspect but must not modify *func*; doing so could have " "unpredictable effects, including infinite recursion." msgstr "" +"El callback puede inspeccionar pero no debe modificar *func*; hacerlo podría " +"tener efectos impredecibles, incluyendo recursión infinita." #: ../Doc/c-api/function.rst:170 msgid "" @@ -234,6 +254,15 @@ msgid "" "behavior depending on optimization decisions, it does not change the " "semantics of the Python code being executed." msgstr "" +"Si *event* es ``PyFunction_EVENT_CREATE``, entonces el callback se invoca " +"después de que `func` haya sido completamente inicializada. De lo contrario, " +"el callback se invoca antes de que tenga lugar la modificación a *func*, por " +"lo que el estado previo de *func* puede ser inspeccionado. Se permite al " +"tiempo de ejecución optimizar la creación de objetos función cuando sea " +"posible. En tales casos no se emitirá ningún evento. Aunque esto crea la " +"posibilidad de una diferencia observable del comportamiento del tiempo de " +"ejecución dependiendo de las decisiones de optimización, no cambia la " +"semántica del código Python que se está ejecutando." #: ../Doc/c-api/function.rst:179 msgid "" @@ -242,13 +271,21 @@ msgid "" "it from being freed at this time. When the resurrected object is destroyed " "later, any watcher callbacks active at that time will be called again." msgstr "" +"Si *event* es ``PyFunction_EVENT_DESTROY``, tomar una referencia en el " +"callback a la función a punto de ser destruida la resucitará, evitando que " +"sea liberada en este momento. Cuando el objeto resucitado sea destruido más " +"tarde, cualquier callback observador activo en ese momento será llamado de " +"nuevo." #: ../Doc/c-api/function.rst:184 msgid "" "If the callback sets an exception, it must return ``-1``; this exception " -"will be printed as an unraisable exception using :c:func:" -"`PyErr_WriteUnraisable`. Otherwise it should return ``0``." +"will be printed as an unraisable exception " +"using :c:func:`PyErr_WriteUnraisable`. Otherwise it should return ``0``." msgstr "" +"Si el callback establece una excepción, debe retornar ``-1``; esta excepción " +"se imprimirá como una excepción no lanzable " +"usando :c:func:`PyErr_WriteUnraisable`. De lo contrario debe retornar ``0``." #: ../Doc/c-api/function.rst:188 msgid "" @@ -258,16 +295,20 @@ msgid "" "exception unless it saves and clears the exception state first, and restores " "it before returning." msgstr "" +"Puede haber ya una excepción pendiente establecida al entrar al callback. En " +"este caso, el callback debe retornar ``0`` con la misma excepción aún " +"establecida. Esto significa que el callback no puede llamar a ninguna otra " +"API que pueda establecer una excepción a menos que guarde y borre el estado " +"de la excepción primero, y lo restaure antes de retornar." #: ../Doc/c-api/function.rst:8 msgid "object" -msgstr "" +msgstr "objeto" #: ../Doc/c-api/function.rst:8 -#, fuzzy msgid "function" -msgstr "Objetos función" +msgstr "función" #: ../Doc/c-api/function.rst:20 msgid "MethodType (in module types)" -msgstr "" +msgstr "MethodType (en module types)" diff --git a/dictionaries/c-api_function.txt b/dictionaries/c-api_function.txt new file mode 100644 index 0000000000..0e1b59889c --- /dev/null +++ b/dictionaries/c-api_function.txt @@ -0,0 +1 @@ +lanzable