python-docs-es/extending/newtypes.po at 3.10.2 · python/python-docs-es

913 lines (824 loc) · 43.5 KB
# 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
"Project-Id-Version: Python 3.8\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-01-25 13:19+0100\n"
"PO-Revision-Date: 2021-10-19 20:28-0500\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.9.1\n"
#: ../Doc/extending/newtypes.rst:7
msgid "Defining Extension Types: Assorted Topics"
msgstr "Definición de tipos de extensión: temas variados"
#: ../Doc/extending/newtypes.rst:11
"This section aims to give a quick fly-by on the various type methods you can "
"implement and what they do."
"Esta sección tiene como objetivo dar un vistazo rápido a los diversos "
"métodos de tipo que puede implementar y lo que hacen."
#: ../Doc/extending/newtypes.rst:14
"Here is the definition of :c:type:`PyTypeObject`, with some fields only used "
"in :ref:`debug builds <debug-build>` omitted:"
"Aquí está la definición de :c:type:`PyTypeObject`, con algunos campos que "
"solo se usan en las :ref:`versiones de depuración <debug-build>` omitidas:"
#: ../Doc/extending/newtypes.rst:20
"Now that's a *lot* of methods.  Don't worry too much though -- if you have a "
"type you want to define, the chances are very good that you will only "
"implement a handful of these."
"Esos son *muchos* métodos. Sin embargo, no se preocupe demasiado: si tiene "
"un tipo que desea definir, es muy probable que solo implemente un puñado de "
#: ../Doc/extending/newtypes.rst:24
"As you probably expect by now, we're going to go over this and give more "
"information about the various handlers.  We won't go in the order they are "
"defined in the structure, because there is a lot of historical baggage that "
"impacts the ordering of the fields.  It's often easiest to find an example "
"that includes the fields you need and then change the values to suit your "
"new type. ::"
"Como probablemente espera ahora, vamos a repasar esto y daremos más "
"información sobre los diversos controladores. No iremos en el orden en que "
"se definen en la estructura, porque hay mucho equipaje histórico que afecta "
"el orden de los campos. A menudo es más fácil encontrar un ejemplo que "
"incluya los campos que necesita y luego cambiar los valores para adaptarlos "
"a su nuevo tipo. ::"
#: ../Doc/extending/newtypes.rst:33
"The name of the type -- as mentioned in the previous chapter, this will "
"appear in various places, almost entirely for diagnostic purposes. Try to "
"choose something that will be helpful in such a situation! ::"
"El nombre del tipo -- como se mencionó en el capítulo anterior, aparecerá en "
"varios lugares, casi por completo para fines de diagnóstico. ¡Intente elegir "
"algo que sea útil en tal situación! ::"
#: ../Doc/extending/newtypes.rst:39
"These fields tell the runtime how much memory to allocate when new objects "
"of this type are created.  Python has some built-in support for variable "
"length structures (think: strings, tuples) which is where the :c:member:"
"`~PyTypeObject.tp_itemsize` field comes in.  This will be dealt with "
"later. ::"
"Estos campos le dicen al tiempo de ejecución cuánta memoria asignar cuando "
"se crean nuevos objetos de este tipo. Python tiene algún soporte incorporado "
"para estructuras de longitud variable (piense: cadenas, tuplas) que es donde "
"entra el campo :c:member:`~PyTypeObject.tp_itemsize`. Esto se tratará más "
"adelante. ::"
#: ../Doc/extending/newtypes.rst:46
"Here you can put a string (or its address) that you want returned when the "
"Python script references ``obj.__doc__`` to retrieve the doc string."
"Aquí puede poner una cadena de caracteres (o su dirección) que desea que se "
"retorne cuando el script de Python haga referencia a ``obj.__doc__`` para "
"recuperar el docstring."
#: ../Doc/extending/newtypes.rst:49
"Now we come to the basic type methods -- the ones most extension types will "
"implement."
"Ahora llegamos a los métodos de tipo básicos: los que implementarán la "
"mayoría de los tipos de extensión."
#: ../Doc/extending/newtypes.rst:54
msgid "Finalization and De-allocation"
msgstr "Finalización y desasignación"
#: ../Doc/extending/newtypes.rst:66
"This function is called when the reference count of the instance of your "
"type is reduced to zero and the Python interpreter wants to reclaim it.  If "
"your type has memory to free or other clean-up to perform, you can put it "
"here.  The object itself needs to be freed here as well.  Here is an example "
"of this function::"
"Se llama a esta función cuando el recuento de referencia de la instancia de "
"su tipo se reduce a cero y el intérprete de Python quiere reclamarlo. Si su "
"tipo tiene memoria para liberar u otra limpieza para realizar, puede ponerla "
"aquí. El objeto en sí mismo necesita ser liberado aquí también. Aquí hay un "
"ejemplo de esta función::"
#: ../Doc/extending/newtypes.rst:79
"If your type supports garbage collection, the destructor should call :c:func:"
"`PyObject_GC_UnTrack` before clearing any member fields::"
#: ../Doc/extending/newtypes.rst:95
"One important requirement of the deallocator function is that it leaves any "
"pending exceptions alone.  This is important since deallocators are "
"frequently called as the interpreter unwinds the Python stack; when the "
"stack is unwound due to an exception (rather than normal returns), nothing "
"is done to protect the deallocators from seeing that an exception has "
"already been set.  Any actions which a deallocator performs which may cause "
"additional Python code to be executed may detect that an exception has been "
"set.  This can lead to misleading errors from the interpreter.  The proper "
"way to protect against this is to save a pending exception before performing "
"the unsafe action, and restoring it when done.  This can be done using the :"
"c:func:`PyErr_Fetch` and :c:func:`PyErr_Restore` functions::"
"Un requisito importante de la función desasignador es que deja solo las "
"excepciones pendientes. Esto es importante ya que los desasignadores se "
"llaman con frecuencia cuando el intérprete desenrolla la pila de Python; "
"cuando la pila se desenrolla debido a una excepción (en lugar de retornos "
"normales), no se hace nada para proteger a los desasignadores de memoria "
"(*deallocator*) de ver que ya se ha establecido una excepción. Cualquier "
"acción que realice un desasignador que pueda hacer que se ejecute código "
"Python adicional puede detectar que se ha establecido una excepción. Esto "
"puede conducir a errores engañosos del intérprete. La forma correcta de "
"protegerse contra esto es guardar una excepción pendiente antes de realizar "
"la acción insegura y restaurarla cuando haya terminado. Esto se puede hacer "
"usando las funciones :c:func:`PyErr_Fetch` y :c:func:`PyErr_Restore`::"
#: ../Doc/extending/newtypes.rst:134
"There are limitations to what you can safely do in a deallocator function. "
"First, if your type supports garbage collection (using :c:member:"
"`~PyTypeObject.tp_traverse` and/or :c:member:`~PyTypeObject.tp_clear`), some "
"of the object's members can have been cleared or finalized by the time :c:"
"member:`~PyTypeObject.tp_dealloc` is called.  Second, in :c:member:"
"`~PyTypeObject.tp_dealloc`, your object is in an unstable state: its "
"reference count is equal to zero.  Any call to a non-trivial object or API "
"(as in the example above) might end up calling :c:member:`~PyTypeObject."
"tp_dealloc` again, causing a double free and a crash."
"Existen limitaciones para lo que puede hacer de manera segura en una función "
"de desasignación. Primero, si su tipo admite la recolección de basura "
"(usando :c:member:`~PyTypeObject.tp_traverse` o :c:member:`~PyTypeObject."
"tp_clear`), algunos de los miembros del objeto pueden haber sido borrados o "
"finalizados por el time :c:member:`~PyTypeObject.tp_dealloc` es llamado. "
"Segundo, en :c:member:`~PyTypeObject.tp_dealloc`, su objeto está en un "
"estado inestable: su recuento de referencia es igual a cero. Cualquier "
"llamada a un objeto o API no trivial (como en el ejemplo anterior) podría "
"terminar llamando :c:member:`~PyTypeObject.tp_dealloc` nuevamente, causando "
"una doble liberación y un bloqueo."
#: ../Doc/extending/newtypes.rst:143
"Starting with Python 3.4, it is recommended not to put any complex "
"finalization code in :c:member:`~PyTypeObject.tp_dealloc`, and instead use "
"the new :c:member:`~PyTypeObject.tp_finalize` type method."
"Comenzando con Python 3.4, se recomienda no poner ningún código de "
"finalización complejo en :c:member:`~PyTypeObject.tp_dealloc`, y en su lugar "
"use el nuevo método de tipo :c:member:`~PyTypeObject.tp_finalize`."
#: ../Doc/extending/newtypes.rst:148
msgid ":pep:`442` explains the new finalization scheme."
msgstr ":pep:`442` explica el nuevo esquema de finalización."
#: ../Doc/extending/newtypes.rst:155
msgid "Object Presentation"
msgstr "Presentación de Objetos"
#: ../Doc/extending/newtypes.rst:157
"In Python, there are two ways to generate a textual representation of an "
"object: the :func:`repr` function, and the :func:`str` function.  (The :func:"
"`print` function just calls :func:`str`.)  These handlers are both optional."
"En Python, hay dos formas de generar una representación textual de un "
"objeto: la función :func:`repr`, y la función :func:`str`. (La función :func:"
"`print` solo llama a :func:`str`.) Estos controladores son opcionales."
#: ../Doc/extending/newtypes.rst:166
"The :c:member:`~PyTypeObject.tp_repr` handler should return a string object "
"containing a representation of the instance for which it is called.  Here is "
"a simple example::"
"El manejador :c:member:`~PyTypeObject.tp_repr` debe retornar un objeto de "
"cadena que contenga una representación de la instancia para la que se llama. "
"Aquí hay un ejemplo simple::"
#: ../Doc/extending/newtypes.rst:177
"If no :c:member:`~PyTypeObject.tp_repr` handler is specified, the "
"interpreter will supply a representation that uses the type's :c:member:"
"`~PyTypeObject.tp_name` and a uniquely-identifying value for the object."
"Si no se especifica :c:member:`~PyTypeObject.tp_repr`, el intérprete "
"proporcionará una representación que utiliza los tipos :c:member:"
"`~PyTypeObject.tp_name` y un valor de identificación único para el objeto."
#: ../Doc/extending/newtypes.rst:181
"The :c:member:`~PyTypeObject.tp_str` handler is to :func:`str` what the :c:"
"member:`~PyTypeObject.tp_repr` handler described above is to :func:`repr`; "
"that is, it is called when Python code calls :func:`str` on an instance of "
"your object.  Its implementation is very similar to the :c:member:"
"`~PyTypeObject.tp_repr` function, but the resulting string is intended for "
"human consumption.  If :c:member:`~PyTypeObject.tp_str` is not specified, "
"the :c:member:`~PyTypeObject.tp_repr` handler is used instead."
"El manejador :c:member:`~PyTypeObject.tp_str` es para :func:`str` lo que el "
"manejador :c:member:`~PyTypeObject.tp_repr` descrito arriba es para :func:"
"`repr`; es decir, se llama cuando el código Python llama :func:`str` en una "
"instancia de su objeto. Su implementación es muy similar a la función :c:"
"member:`~PyTypeObject.tp_repr`, pero la cadena resultante está destinada al "
"consumo humano. Si :c:member:`~PyTypeObject.tp_str` no se especifica, en su "
"lugar se utiliza el controlador :c:member:`~PyTypeObject.tp_repr`."
#: ../Doc/extending/newtypes.rst:188
msgid "Here is a simple example::"
msgstr "Aquí hay un ejemplo simple::"
#: ../Doc/extending/newtypes.rst:200
msgid "Attribute Management"
msgstr "Gestión de atributos"
#: ../Doc/extending/newtypes.rst:202
"For every object which can support attributes, the corresponding type must "
"provide the functions that control how the attributes are resolved.  There "
"needs to be a function which can retrieve attributes (if any are defined), "
"and another to set attributes (if setting attributes is allowed).  Removing "
"an attribute is a special case, for which the new value passed to the "
"handler is ``NULL``."
"Para cada objeto que puede soportar atributos, el tipo correspondiente debe "
"proporcionar las funciones que controlan cómo se resuelven los atributos. Es "
"necesario que haya una función que pueda recuperar atributos (si hay alguna "
"definida), y otra para establecer atributos (si se permite establecer "
"atributos). La eliminación de un atributo es un caso especial, para el cual "
"el nuevo valor pasado al controlador es ``NULL``."
#: ../Doc/extending/newtypes.rst:208
"Python supports two pairs of attribute handlers; a type that supports "
"attributes only needs to implement the functions for one pair.  The "
"difference is that one pair takes the name of the attribute as a :c:type:"
"`char\\*`, while the other accepts a :c:type:`PyObject\\*`.  Each type can "
"use whichever pair makes more sense for the implementation's convenience. ::"
"Python admite dos pares de controladores de atributos; un tipo que admite "
"atributos solo necesita implementar las funciones para un par. La diferencia "
"es que un par toma el nombre del atributo como a :c:type:`char\\*`, mientras "
"que el otro acepta un :c:type:`PyObject\\*`. Cada tipo puede usar el par que "
"tenga más sentido para la conveniencia de la implementación. ::"
#: ../Doc/extending/newtypes.rst:220
"If accessing attributes of an object is always a simple operation (this will "
"be explained shortly), there are generic implementations which can be used "
"to provide the :c:type:`PyObject\\*` version of the attribute management "
"functions. The actual need for type-specific attribute handlers almost "
"completely disappeared starting with Python 2.2, though there are many "
"examples which have not been updated to use some of the new generic "
"mechanism that is available."
"Si acceder a los atributos de un objeto es siempre una operación simple "
"(esto se explicará en breve), existen implementaciones genéricas que se "
"pueden utilizar para proporcionar la versión :c:type:`PyObject\\*` de las "
"funciones de gestión de atributos. La necesidad real de controladores de "
"atributos específicos de tipo desapareció casi por completo a partir de "
"Python 2.2, aunque hay muchos ejemplos que no se han actualizado para "
"utilizar algunos de los nuevos mecanismos genéricos que están disponibles."
#: ../Doc/extending/newtypes.rst:231
msgid "Generic Attribute Management"
msgstr "Gestión de atributos genéricos"
#: ../Doc/extending/newtypes.rst:233
"Most extension types only use *simple* attributes.  So, what makes the "
"attributes simple?  There are only a couple of conditions that must be met:"
"La mayoría de los tipos de extensión solo usan atributos *simple*. Entonces, "
"¿qué hace que los atributos sean simples? Solo hay un par de condiciones que "
"se deben cumplir:"
#: ../Doc/extending/newtypes.rst:236
"The name of the attributes must be known when :c:func:`PyType_Ready` is "
"El nombre de los atributos debe ser conocido cuando :c:func:`PyType_Ready` "
"es llamado."
#: ../Doc/extending/newtypes.rst:239
"No special processing is needed to record that an attribute was looked up or "
"set, nor do actions need to be taken based on the value."
"No se necesita un procesamiento especial para registrar que un atributo se "
"buscó o se configuró, ni se deben tomar acciones basadas en el valor."
#: ../Doc/extending/newtypes.rst:242
"Note that this list does not place any restrictions on the values of the "
"attributes, when the values are computed, or how relevant data is stored."
"Tenga en cuenta que esta lista no impone restricciones a los valores de los "
"atributos, cuándo se calculan los valores o cómo se almacenan los datos "
"relevantes."
#: ../Doc/extending/newtypes.rst:245
"When :c:func:`PyType_Ready` is called, it uses three tables referenced by "
"the type object to create :term:`descriptor`\\s which are placed in the "
"dictionary of the type object.  Each descriptor controls access to one "
"attribute of the instance object.  Each of the tables is optional; if all "
"three are ``NULL``, instances of the type will only have attributes that are "
"inherited from their base type, and should leave the :c:member:"
"`~PyTypeObject.tp_getattro` and :c:member:`~PyTypeObject.tp_setattro` fields "
"``NULL`` as well, allowing the base type to handle attributes."
"Cuando se llama a :c:func:`PyType_Ready`, utiliza tres tablas a las que hace "
"referencia el objeto de tipo para crear :term:`descriptor` que se colocan en "
"el diccionario del objeto de tipo. Cada descriptor controla el acceso a un "
"atributo del objeto de instancia. Cada una de las tablas es opcional; si los "
"tres son ``NULL``, las instancias del tipo solo tendrán atributos que se "
"heredan de su tipo base, y deberían dejar :c:member:`~PyTypeObject."
"tp_getattro` y los campos :c:member:`~PyTypeObject.tp_setattro` ``NULL`` "
"también, permitiendo que el tipo base maneje los atributos."
#: ../Doc/extending/newtypes.rst:253
msgid "The tables are declared as three fields of the type object::"
msgstr "Las tablas se declaran como tres campos del tipo objeto::"
#: ../Doc/extending/newtypes.rst:259
"If :c:member:`~PyTypeObject.tp_methods` is not ``NULL``, it must refer to an "
"array of :c:type:`PyMethodDef` structures.  Each entry in the table is an "
"instance of this structure::"
"Si :c:member:`~PyTypeObject.tp_methods` no es ``NULL``, debe referirse a un "
"arreglo de estructuras :c:type:`PyMethodDef`. Cada entrada en la tabla es "
"una instancia de esta estructura::"
#: ../Doc/extending/newtypes.rst:270
"One entry should be defined for each method provided by the type; no entries "
"are needed for methods inherited from a base type.  One additional entry is "
"needed at the end; it is a sentinel that marks the end of the array.  The :"
"attr:`ml_name` field of the sentinel must be ``NULL``."
"Se debe definir una entrada para cada método proporcionado por el tipo; No "
"se necesitan entradas para los métodos heredados de un tipo base. Se "
"necesita una entrada adicional al final; es un centinela el que marca el "
"final del arreglo. El campo :attr:`ml_name` del centinela debe ser ``NULL``."
#: ../Doc/extending/newtypes.rst:275
"The second table is used to define attributes which map directly to data "
"stored in the instance.  A variety of primitive C types are supported, and "
"access may be read-only or read-write.  The structures in the table are "
"defined as::"
"La segunda tabla se utiliza para definir atributos que se asignan "
"directamente a los datos almacenados en la instancia. Se admite una variedad "
"de tipos C primitivos, y el acceso puede ser de solo lectura o lectura-"
"escritura. Las estructuras en la tabla se definen como::"
#: ../Doc/extending/newtypes.rst:287
"For each entry in the table, a :term:`descriptor` will be constructed and "
"added to the type which will be able to extract a value from the instance "
"structure.  The :attr:`type` field should contain one of the type codes "
"defined in the :file:`structmember.h` header; the value will be used to "
"determine how to convert Python values to and from C values.  The :attr:"
"`flags` field is used to store flags which control how the attribute can be "
"accessed."
"Para cada entrada en la tabla, se construirá un :term:`descriptor` y se "
"agregará al tipo que podrá extraer un valor de la estructura de la "
"instancia. El campo :attr:`type` debe contener uno de los códigos de tipo "
"definidos en el encabezado :file:`structmember.h`; el valor se usará para "
"determinar cómo convertir los valores de Python hacia y desde los valores de "
"C. El campo :attr:`flags` se usa para almacenar flags que controlan cómo se "
"puede acceder al atributo."
#: ../Doc/extending/newtypes.rst:294
"The following flag constants are defined in :file:`structmember.h`; they may "
"be combined using bitwise-OR."
"Las siguientes constantes de flag se definen en :file:`structmember.h`; se "
"pueden combinar usando OR bit a bit (*bitwise-OR*)."
#: ../Doc/extending/newtypes.rst:298
msgid "Constant"
msgstr "Constante"
#: ../Doc/extending/newtypes.rst:298
msgid "Meaning"
msgstr "Significado"
#: ../Doc/extending/newtypes.rst:300
msgid ":const:`READONLY`"
msgstr ":const:`READONLY`"
#: ../Doc/extending/newtypes.rst:300
msgid "Never writable."
msgstr "Nunca escribible."
#: ../Doc/extending/newtypes.rst:302
msgid ":const:`PY_AUDIT_READ`"
msgstr ":const:`PY_AUDIT_READ`"
#: ../Doc/extending/newtypes.rst:302
"Emit an ``object.__getattr__`` :ref:`audit events <audit-events>` before "
"Emite un ``object.__getattr__`` :ref:`audita evento <audit-events>` antes de "
#: ../Doc/extending/newtypes.rst:307
":const:`RESTRICTED`, :const:`READ_RESTRICTED` and :const:`WRITE_RESTRICTED` "
"are deprecated. However, :const:`READ_RESTRICTED` is an alias for :const:"
"`PY_AUDIT_READ`, so fields that specify either :const:`RESTRICTED` or :const:"
"`READ_RESTRICTED` will also raise an audit event."
":const:`RESTRICTED`, :const:`READ_RESTRICTED` y :const:`WRITE_RESTRICTED` "
"están en desuso. Sin embargo, :const:`READ_RESTRICTED` es un alias para :"
"const:`PY_AUDIT_READ`, por lo que los campos que especifican :const:"
"`RESTRICTED` o :const:`READ_RESTRICTED` también generarán un evento de "
"auditoría."
#: ../Doc/extending/newtypes.rst:320
"An interesting advantage of using the :c:member:`~PyTypeObject.tp_members` "
"table to build descriptors that are used at runtime is that any attribute "
"defined this way can have an associated doc string simply by providing the "
"text in the table.  An application can use the introspection API to retrieve "
"the descriptor from the class object, and get the doc string using its :attr:"
"`__doc__` attribute."
"Una ventaja interesante de usar la tabla :c:member:`~PyTypeObject."
"tp_members` para crear descriptores que se usan en tiempo de ejecución es "
"que cualquier atributo definido de esta manera puede tener un docstring "
"asociada simplemente al proporcionar el texto en la tabla. Una aplicación "
"puede usar la API de introspección para recuperar el descriptor del objeto "
"de clase y obtener el docstring utilizando su atributo :attr:`__doc__`."
#: ../Doc/extending/newtypes.rst:326
"As with the :c:member:`~PyTypeObject.tp_methods` table, a sentinel entry "
"with a :attr:`name` value of ``NULL`` is required."
"Al igual que con la tabla :c:member:`~PyTypeObject.tp_methods`, se requiere "
"una entrada de centinela con un valor :attr:`name` de ``NULL``."
#: ../Doc/extending/newtypes.rst:340
msgid "Type-specific Attribute Management"
msgstr "Gestión de atributos específicos de tipo"
#: ../Doc/extending/newtypes.rst:342
"For simplicity, only the :c:type:`char\\*` version will be demonstrated "
"here; the type of the name parameter is the only difference between the :c:"
"type:`char\\*` and :c:type:`PyObject\\*` flavors of the interface. This "
"example effectively does the same thing as the generic example above, but "
"does not use the generic support added in Python 2.2.  It explains how the "
"handler functions are called, so that if you do need to extend their "
"functionality, you'll understand what needs to be done."
"Para simplificar, aquí solo se demostrará la versión :c:type:`char \\*`; el "
"tipo de parámetro de nombre es la única diferencia entre las variaciones de "
"la interfaz :c:type:`char\\*` y :c:type:`PyObject\\*`. Este ejemplo "
"efectivamente hace lo mismo que el ejemplo genérico anterior, pero no "
"utiliza el soporte genérico agregado en Python 2.2. Explica cómo se llaman "
"las funciones del controlador, de modo que si necesita ampliar su "
"funcionalidad, comprenderá lo que debe hacerse."
#: ../Doc/extending/newtypes.rst:350
"The :c:member:`~PyTypeObject.tp_getattr` handler is called when the object "
"requires an attribute look-up.  It is called in the same situations where "
"the :meth:`__getattr__` method of a class would be called."
"Se llama al manejador :c:member:`~PyTypeObject.tp_getattr` cuando el objeto "
"requiere una búsqueda de atributo. Se llama en las mismas situaciones donde "
"se llamaría el método :meth:`__getattr__` de una clase."
#: ../Doc/extending/newtypes.rst:354
msgid "Here is an example::"
msgstr "Aquí hay un ejemplo::"
#: ../Doc/extending/newtypes.rst:370
"The :c:member:`~PyTypeObject.tp_setattr` handler is called when the :meth:"
"`__setattr__` or :meth:`__delattr__` method of a class instance would be "
"called.  When an attribute should be deleted, the third parameter will be "
"``NULL``.  Here is an example that simply raises an exception; if this were "
"really all you wanted, the :c:member:`~PyTypeObject.tp_setattr` handler "
"should be set to ``NULL``. ::"
"Se llama al manejador :c:member:`~PyTypeObject.tp_setattr` cuando se llama "
"al método :meth:`__setattr__` o :meth:`__delattr__` de una instancia de "
"clase. Cuando se debe eliminar un atributo, el tercer parámetro será "
"``NULL``. Aquí hay un ejemplo que simplemente plantea una excepción; si esto "
"fuera realmente todo lo que deseaba, el controlador :c:member:`~PyTypeObject."
"tp_setattr` debería establecerse en ``NULL``. ::"
#: ../Doc/extending/newtypes.rst:384
msgid "Object Comparison"
msgstr "Comparación de Objetos"
#: ../Doc/extending/newtypes.rst:390
"The :c:member:`~PyTypeObject.tp_richcompare` handler is called when "
"comparisons are needed.  It is analogous to the :ref:`rich comparison "
"methods <richcmpfuncs>`, like :meth:`__lt__`, and also called by :c:func:"
"`PyObject_RichCompare` and :c:func:`PyObject_RichCompareBool`."
"Se llama al manejador :c:member:`~PyTypeObject.tp_richcompare` cuando se "
"necesitan comparaciones. Es análogo a :ref:`métodos de comparación ricos "
"<richcmpfuncs>`, como :meth:`__lt__`, y también llamado por :c:func:"
"`PyObject_RichCompare` y :c:func:`PyObject_RichCompareBool`."
#: ../Doc/extending/newtypes.rst:395
"This function is called with two Python objects and the operator as "
"arguments, where the operator is one of ``Py_EQ``, ``Py_NE``, ``Py_LE``, "
"``Py_GE``, ``Py_LT`` or ``Py_GT``.  It should compare the two objects with "
"respect to the specified operator and return ``Py_True`` or ``Py_False`` if "
"the comparison is successful, ``Py_NotImplemented`` to indicate that "
"comparison is not implemented and the other object's comparison method "
"should be tried, or ``NULL`` if an exception was set."
"Esta función se llama con dos objetos Python y el operador como argumentos, "
"donde el operador es uno de ``Py_EQ``, ``Py_NE``, ``Py_LE``, ``Py_GT``, "
"``Py_LT`` o ``Py_GT``. Debe comparar los dos objetos con respecto al "
"operador especificado y retornar ``Py_True`` o ``Py_False`` si la "
"comparación es exitosa, ``Py_NotImplemented`` para indicar que la "
"comparación no está implementada y el método de comparación del otro objeto "
"debería intentarse, o ``NULL`` si se estableció una excepción."
#: ../Doc/extending/newtypes.rst:403
"Here is a sample implementation, for a datatype that is considered equal if "
"the size of an internal pointer is equal::"
"Aquí hay una implementación de muestra, para un tipo de datos que se "
"considera igual si el tamaño de un puntero interno es igual:"
#: ../Doc/extending/newtypes.rst:433
msgid "Abstract Protocol Support"
msgstr "Soporte de protocolo abstracto"
#: ../Doc/extending/newtypes.rst:435
"Python supports a variety of *abstract* 'protocols;' the specific interfaces "
"provided to use these interfaces are documented in :ref:`abstract`."
"Python admite una variedad de protocolos *abstractos*; las interfaces "
"específicas proporcionadas para usar estas interfaces están documentadas en :"
"ref:`abstract`."
#: ../Doc/extending/newtypes.rst:439
"A number of these abstract interfaces were defined early in the development "
"of the Python implementation.  In particular, the number, mapping, and "
"sequence protocols have been part of Python since the beginning.  Other "
"protocols have been added over time.  For protocols which depend on several "
"handler routines from the type implementation, the older protocols have been "
"defined as optional blocks of handlers referenced by the type object.  For "
"newer protocols there are additional slots in the main type object, with a "
"flag bit being set to indicate that the slots are present and should be "
"checked by the interpreter.  (The flag bit does not indicate that the slot "
"values are non-``NULL``. The flag may be set to indicate the presence of a "
"slot, but a slot may still be unfilled.) ::"
"Varias de estas interfaces abstractas se definieron temprano en el "
"desarrollo de la implementación de Python. En particular, los protocolos de "
"número, mapeo y secuencia han sido parte de Python desde el principio. Se "
"han agregado otros protocolos con el tiempo. Para los protocolos que "
"dependen de varias rutinas de controlador de la implementación de tipo, los "
"protocolos más antiguos se han definido como bloques opcionales de "
"controladores a los que hace referencia el objeto de tipo. Para los "
"protocolos más nuevos, hay espacios adicionales en el objeto de tipo "
"principal, con un bit de marca que se establece para indicar que los "
"espacios están presentes y el intérprete debe verificarlos. (El bit de "
"indicador no indica que los valores de intervalo no son ``NULL``. El "
"indicador puede establecerse para indicar la presencia de un intervalo, pero "
"un intervalo aún puede estar vacío.)::"
#: ../Doc/extending/newtypes.rst:454
"If you wish your object to be able to act like a number, a sequence, or a "
"mapping object, then you place the address of a structure that implements "
"the C type :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, or :c:"
"type:`PyMappingMethods`, respectively. It is up to you to fill in this "
"structure with appropriate values. You can find examples of the use of each "
"of these in the :file:`Objects` directory of the Python source "
"distribution. ::"
"Si desea que su objeto pueda actuar como un número, una secuencia o un "
"objeto de mapeo, entonces coloca la dirección de una estructura que "
"implementa el tipo C :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, "
"o :c:type:`PyMappingMethods`, respectivamente. Depende de usted completar "
"esta estructura con los valores apropiados. Puede encontrar ejemplos del uso "
"de cada uno de estos en el directorio :file:`Objects` de la distribución "
"fuente de Python. ::"
#: ../Doc/extending/newtypes.rst:463
"This function, if you choose to provide it, should return a hash number for "
"an instance of your data type. Here is a simple example::"
"Esta función, si elige proporcionarla, debería retornar un número hash para "
"una instancia de su tipo de datos. Aquí hay un ejemplo simple::"
#: ../Doc/extending/newtypes.rst:476
":c:type:`Py_hash_t` is a signed integer type with a platform-varying width. "
"Returning ``-1`` from :c:member:`~PyTypeObject.tp_hash` indicates an error, "
"which is why you should be careful to avoid returning it when hash "
"computation is successful, as seen above."
":c:type:`Py_hash_t` es un tipo entero con signo con un ancho que varia "
"dependiendo de la plataforma.retornar ``-1`` de :c:member:`~PyTypeObject."
"tp_hash` indica un error, por lo que debe tener cuidado de evitar retornarlo "
"cuando el cálculo de hash sea exitoso, como se vio anteriormente."
#: ../Doc/extending/newtypes.rst:485
"This function is called when an instance of your data type is \"called\", "
"for example, if ``obj1`` is an instance of your data type and the Python "
"script contains ``obj1('hello')``, the :c:member:`~PyTypeObject.tp_call` "
"handler is invoked."
"Esta función se llama cuando una instancia de su tipo de datos se \"llama\", "
"por ejemplo, si ``obj1`` es una instancia de su tipo de datos y el script de "
"Python contiene ``obj1('hello')``, el controlador :c:member:`~PyTypeObject."
"tp_call` se invoca."
#: ../Doc/extending/newtypes.rst:489
msgid "This function takes three arguments:"
msgstr "Esta función toma tres argumentos:"
#: ../Doc/extending/newtypes.rst:491
"*self* is the instance of the data type which is the subject of the call. If "
"the call is ``obj1('hello')``, then *self* is ``obj1``."
"*self* es la instancia del tipo de datos que es el sujeto de la llamada. Si "
"la llamada es ``obj1('hola')``, entonces *self* es ``obj1``."
#: ../Doc/extending/newtypes.rst:494
"*args* is a tuple containing the arguments to the call.  You can use :c:func:"
"`PyArg_ParseTuple` to extract the arguments."
"*args* es una tupla que contiene los argumentos de la llamada. Puede usar :c:"
"func:`PyArg_ParseTuple` para extraer los argumentos."
#: ../Doc/extending/newtypes.rst:497
"*kwds* is a dictionary of keyword arguments that were passed. If this is non-"
"``NULL`` and you support keyword arguments, use :c:func:"
"`PyArg_ParseTupleAndKeywords` to extract the arguments.  If you do not want "
"to support keyword arguments and this is non-``NULL``, raise a :exc:"
"`TypeError` with a message saying that keyword arguments are not supported."
"*kwds* es un diccionario de argumentos de palabras clave que se pasaron. Si "
"no es ``NULL`` y admite argumentos de palabras clave, use :c:func:"
"`PyArg_ParseTupleAndKeywords` para extraer los argumentos. Si no desea "
"admitir argumentos de palabras clave y esto no es ``NULL``, genere un :exc:"
"`TypeError` con un mensaje que indique que los argumentos de palabras clave "
"no son compatibles."
#: ../Doc/extending/newtypes.rst:503
msgid "Here is a toy ``tp_call`` implementation::"
msgstr "Aquí hay una implementación de juguete ``tp_call``::"
#: ../Doc/extending/newtypes.rst:529
"These functions provide support for the iterator protocol.  Both handlers "
"take exactly one parameter, the instance for which they are being called, "
"and return a new reference.  In the case of an error, they should set an "
"exception and return ``NULL``.  :c:member:`~PyTypeObject.tp_iter` "
"corresponds to the Python :meth:`__iter__` method, while :c:member:"
"`~PyTypeObject.tp_iternext` corresponds to the Python :meth:`~iterator."
"__next__` method."
"Estas funciones proporcionan soporte para el protocolo iterador. Ambos "
"manejadores toman exactamente un parámetro, la instancia para la que están "
"siendo llamados, y retornan una nueva referencia. En el caso de un error, "
"deben establecer una excepción y retornar ``NULL``. :c:member:`~PyTypeObject."
"tp_iter` corresponde al método Python :meth:`__iter__`, mientras que :c:"
"member:`~PyTypeObject.tp_iternext` corresponde al método Python :meth:"
"`~iterator.__next__`."
#: ../Doc/extending/newtypes.rst:536
"Any :term:`iterable` object must implement the :c:member:`~PyTypeObject."
"tp_iter` handler, which must return an :term:`iterator` object.  Here the "
"same guidelines apply as for Python classes:"
"Cualquier objeto :term:`iterable` debe implementar el manejador :c:member:"
"`~PyTypeObject.tp_iter`, que debe retornar un objeto :term:`iterator`. Aquí "
"se aplican las mismas pautas que para las clases de Python:"
#: ../Doc/extending/newtypes.rst:540
"For collections (such as lists and tuples) which can support multiple "
"independent iterators, a new iterator should be created and returned by each "
"call to :c:member:`~PyTypeObject.tp_iter`."
"Para colecciones (como listas y tuplas) que pueden admitir múltiples "
"iteradores independientes, cada llamada debe crear y retornar un nuevo "
"iterador a :c:member:`~PyTypeObject.tp_iter`."
#: ../Doc/extending/newtypes.rst:543
"Objects which can only be iterated over once (usually due to side effects of "
"iteration, such as file objects) can implement :c:member:`~PyTypeObject."
"tp_iter` by returning a new reference to themselves -- and should also "
"therefore implement the :c:member:`~PyTypeObject.tp_iternext`  handler."
"Los objetos que solo se pueden iterar una vez (generalmente debido a los "
"efectos secundarios de la iteración, como los objetos de archivo) pueden "
"implementar :c:member:`~PyTypeObject.tp_iter` retornando una nueva "
"referencia a ellos mismos y, por lo tanto, también deben implementar el "
"manejador :c:member:`~PyTypeObject.tp_iternext`."
#: ../Doc/extending/newtypes.rst:548
"Any :term:`iterator` object should implement both :c:member:`~PyTypeObject."
"tp_iter` and :c:member:`~PyTypeObject.tp_iternext`.  An iterator's :c:member:"
"`~PyTypeObject.tp_iter` handler should return a new reference to the "
"iterator.  Its :c:member:`~PyTypeObject.tp_iternext` handler should return a "
"new reference to the next object in the iteration, if there is one. If the "
"iteration has reached the end, :c:member:`~PyTypeObject.tp_iternext` may "
"return ``NULL`` without setting an exception, or it may set :exc:"
"`StopIteration` *in addition* to returning ``NULL``; avoiding the exception "
"can yield slightly better performance.  If an actual error occurs, :c:member:"
"`~PyTypeObject.tp_iternext` should always set an exception and return "
"``NULL``."
"Cualquier objeto :term:`iterator` debe implementar tanto :c:member:"
"`~PyTypeObject.tp_iter` como :c:member:`~PyTypeObject.tp_iternext`. El "
"manejador de un iterador :c:member:`~PyTypeObject.tp_iter` debería retornar "
"una nueva referencia al iterador. Su controlador :c:member:`~PyTypeObject."
"tp_iternext` debería retornar una nueva referencia al siguiente objeto en la "
"iteración, si hay uno. Si la iteración ha llegado al final, :c:member:"
"`~PyTypeObject.tp_iternext` puede retornar ``NULL`` sin establecer una "
"excepción, o puede establecer :exc:`StopIteration` *además* para retornar "
"``NULL``; evitar la excepción puede producir un rendimiento ligeramente "
"mejor. Si se produce un error real, :c:member:`~PyTypeObject.tp_iternext` "
"siempre debe establecer una excepción y retornar ``NULL``."
#: ../Doc/extending/newtypes.rst:564
msgid "Weak Reference Support"
msgstr "Soporte de referencia débil"
#: ../Doc/extending/newtypes.rst:566
"One of the goals of Python's weak reference implementation is to allow any "
"type to participate in the weak reference mechanism without incurring the "
"overhead on performance-critical objects (such as numbers)."
"Uno de los objetivos de la implementación de referencia débil de Python es "
"permitir que cualquier tipo participe en el mecanismo de referencia débil "
"sin incurrir en la sobrecarga de objetos críticos para el rendimiento (como "
"los números)."
#: ../Doc/extending/newtypes.rst:571
msgid "Documentation for the :mod:`weakref` module."
msgstr "Documentación para el módulo :mod:`weakref`."
#: ../Doc/extending/newtypes.rst:573
"For an object to be weakly referencable, the extension type must do two "
"Para que un objeto sea débilmente referenciable, el tipo de extensión debe "
"hacer dos cosas:"
#: ../Doc/extending/newtypes.rst:575
"Include a :c:type:`PyObject\\*` field in the C object structure dedicated to "
"the weak reference mechanism.  The object's constructor should leave it "
"``NULL`` (which is automatic when using the default :c:member:`~PyTypeObject."
"tp_alloc`)."
"Incluya el campo a :c:type:`PyObject\\*` en la estructura del objeto C "
"dedicada al mecanismo de referencia débil. El constructor del objeto debe "
"dejarlo ``NULL`` (que es automático cuando se usa el valor predeterminado :c:"
"member:`~PyTypeObject.tp_alloc`)."
#: ../Doc/extending/newtypes.rst:580
"Set the :c:member:`~PyTypeObject.tp_weaklistoffset` type member to the "
"offset of the aforementioned field in the C object structure, so that the "
"interpreter knows how to access and modify that field."
"Establezca el miembro de tipo :c:member:`~PyTypeObject.tp_weaklistoffset` en "
"el desplazamiento del campo mencionado anteriormente en la estructura del "
"objeto C, para que el intérprete sepa cómo acceder y modificar ese campo."
#: ../Doc/extending/newtypes.rst:584
"Concretely, here is how a trivial object structure would be augmented with "
"the required field::"
"Concretamente, así es como una estructura de objeto trivial se aumentaría "
"con el campo requerido::"
#: ../Doc/extending/newtypes.rst:592
msgid "And the corresponding member in the statically-declared type object::"
"Y el miembro correspondiente en el objeto de tipo declarado estáticamente::"
#: ../Doc/extending/newtypes.rst:600
"The only further addition is that ``tp_dealloc`` needs to clear any weak "
"references (by calling :c:func:`PyObject_ClearWeakRefs`) if the field is non-"
"``NULL``::"
"La única adición adicional es que ``tp_dealloc`` necesita borrar cualquier "
"referencia débil (llamando a :c:func:`PyObject_ClearWeakRefs`) si el campo "
"no es ``NULL`` ::"
#: ../Doc/extending/newtypes.rst:616
msgid "More Suggestions"
msgstr "Más Sugerencias"
#: ../Doc/extending/newtypes.rst:618
"In order to learn how to implement any specific method for your new data "
"type, get the :term:`CPython` source code.  Go to the :file:`Objects` "
"directory, then search the C source files for ``tp_`` plus the function you "
"want (for example, ``tp_richcompare``).  You will find examples of the "
"function you want to implement."
"Para aprender a implementar cualquier método específico para su nuevo tipo "
"de datos, obtenga el código fuente :term:`CPython`. Vaya al directorio: file:"
"`Objects`, luego busque en los archivos fuente C ``tp_`` más la función que "
"desee (por ejemplo, ``tp_richcompare``). Encontrará ejemplos de la función "
"que desea implementar."
#: ../Doc/extending/newtypes.rst:624
"When you need to verify that an object is a concrete instance of the type "
"you are implementing, use the :c:func:`PyObject_TypeCheck` function.  A "
"sample of its use might be something like the following::"
"Cuando necesite verificar que un objeto es una instancia concreta del tipo "
"que está implementando, use la función :c:func:`PyObject_TypeCheck`. Una "
"muestra de su uso podría ser algo como lo siguiente::"
#: ../Doc/extending/newtypes.rst:635
msgid "Download CPython source releases."
msgstr "Descargue las versiones de origen de CPython."
#: ../Doc/extending/newtypes.rst:635
msgid "https://www.python.org/downloads/source/"
msgstr "https://www.python.org/downloads/source/"
#: ../Doc/extending/newtypes.rst:637
"The CPython project on GitHub, where the CPython source code is developed."
"El proyecto CPython en GitHub, donde se desarrolla el código fuente de "
#: ../Doc/extending/newtypes.rst:638
msgid "https://github.com/python/cpython"
msgstr "https://github.com/python/cpython"
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

newtypes.po

Latest commit

History

newtypes.po

File metadata and controls
