python-docs-pt-br/c-api/type.po at 3.9 · python/python-docs-pt-br

417 lines (354 loc) · 14.3 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2025, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# Translators:
# python-doc bot, 2025
"Project-Id-Version: Python 3.9\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-09-22 21:56+0000\n"
"PO-Revision-Date: 2025-09-22 17:54+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
"teams/5390/pt_BR/)\n"
"Language: pt_BR\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % "
"1000000 == 0 ? 1 : 2;\n"
#: ../../c-api/type.rst:6
msgid "Type Objects"
msgstr "Objetos tipo"
#: ../../c-api/type.rst:13
msgid "The C structure of the objects used to describe built-in types."
msgstr "A estrutura C dos objetos usados para descrever tipos embutidos."
#: ../../c-api/type.rst:18
"This is the type object for type objects; it is the same object as :class:"
"`type` in the Python layer."
"Este é o objeto de tipo para objetos tipo; é o mesmo objeto que :class:"
"`type` na camada Python."
#: ../../c-api/type.rst:24
"Return non-zero if the object *o* is a type object, including instances of "
"types derived from the standard type object.  Return 0 in all other cases. "
"This function always succeeds."
"Retorna valor diferente de zero se o objeto *o* for um objeto tipo, "
"incluindo instâncias de tipos derivados do objeto tipo padrão. Retorna 0 em "
"todos os outros casos. Esta função sempre tem sucesso."
#: ../../c-api/type.rst:31
"Return non-zero if the object *o* is a type object, but not a subtype of the "
"standard type object.  Return 0 in all other cases.  This function always "
"succeeds."
"Retorna valor diferente de zero se o objeto *o* for um objeto tipo, mas não "
"um subtipo do objeto tipo padrão. Retorna 0 em todos os outros casos. Esta "
"função sempre tem sucesso."
#: ../../c-api/type.rst:38
msgid "Clear the internal lookup cache. Return the current version tag."
msgstr "Limpa o cache de pesquisa interno. Retorna a marcação de versão atual."
#: ../../c-api/type.rst:42
"Return the :c:member:`~PyTypeObject.tp_flags` member of *type*. This "
"function is primarily meant for use with `Py_LIMITED_API`; the individual "
"flag bits are guaranteed to be stable across Python releases, but access to :"
"c:member:`~PyTypeObject.tp_flags` itself is not part of the limited API."
"Retorna o membro :c:member:`~PyTypeObject.tp_flags` de *type*. Esta função "
"deve ser usada principalmente com `Py_LIMITED_API`; os bits sinalizadores "
"individuais têm garantia de estabilidade em todas as versões do Python, mas "
"o acesso a :c:member:`~PyTypeObject.tp_flags` não faz parte da API limitada."
#: ../../c-api/type.rst:49
msgid "The return type is now ``unsigned long`` rather than ``long``."
msgstr "O tipo de retorno é agora um ``unsigned long`` em vez de um ``long``."
#: ../../c-api/type.rst:55
"Invalidate the internal lookup cache for the type and all of its subtypes.  "
"This function must be called after any manual modification of the attributes "
"or base classes of the type."
"Invalida o cache de pesquisa interna para o tipo e todos os seus subtipos. "
"Esta função deve ser chamada após qualquer modificação manual dos atributos "
"ou classes bases do tipo."
#: ../../c-api/type.rst:62
"Return non-zero if the type object *o* sets the feature *feature*. Type "
"features are denoted by single bit flags."
"Retorna valor diferente de zero se o objeto tipo *o* define o recurso "
"*feature*. Os recursos de tipo são denotados por sinalizadores de bit único."
#: ../../c-api/type.rst:68
"Return true if the type object includes support for the cycle detector; this "
"tests the type flag :const:`Py_TPFLAGS_HAVE_GC`."
"Retorna verdadeiro se o objeto tipo incluir suporte para o detector de "
"ciclo; isso testa o sinalizador de tipo :const:`Py_TPFLAGS_HAVE_GC`."
#: ../../c-api/type.rst:74
msgid "Return true if *a* is a subtype of *b*."
msgstr "Retorna verdadeiro se *a* for um subtipo de *b*."
#: ../../c-api/type.rst:76
"This function only checks for actual subtypes, which means that :meth:"
"`~class.__subclasscheck__` is not called on *b*.  Call :c:func:"
"`PyObject_IsSubclass` to do the same check that :func:`issubclass` would do."
"Esta função só verifica pelos subtipos, o que significa que :meth:`~class."
"__subclasscheck__` não é chamado em *b*.  Chame :c:func:"
"`PyObject_IsSubclass` para fazer a mesma verificação que :func:`issubclass` "
#: ../../c-api/type.rst:84
"Generic handler for the :c:member:`~PyTypeObject.tp_alloc` slot of a type "
"object.  Use Python's default memory allocation mechanism to allocate a new "
"instance and initialize all its contents to ``NULL``."
"Manipulador genérico para o slot :c:member:`~PyTypeObject.tp_alloc` de um "
"objeto tipo. Use o mecanismo de alocação de memória padrão do Python para "
"alocar uma nova instância e inicializar todo o seu conteúdo para ``NULL``."
#: ../../c-api/type.rst:90
"Generic handler for the :c:member:`~PyTypeObject.tp_new` slot of a type "
"object.  Create a new instance using the type's :c:member:`~PyTypeObject."
"tp_alloc` slot."
"Manipulador genérico para o slot :c:member:`~PyTypeObject.tp_new` de um "
"objeto tipo. Cria uma nova instância usando o slot :c:member:`~PyTypeObject."
"tp_alloc` do tipo."
#: ../../c-api/type.rst:95
"Finalize a type object.  This should be called on all type objects to finish "
"their initialization.  This function is responsible for adding inherited "
"slots from a type's base class.  Return ``0`` on success, or return ``-1`` "
"and sets an exception on error."
"Finaliza um objeto tipo. Isso deve ser chamado em todos os objetos tipo para "
"finalizar sua inicialização. Esta função é responsável por adicionar slots "
"herdados da classe base de um tipo. Retorna ``0`` em caso de sucesso, ou "
"retorna ``-1`` e define uma exceção em caso de erro."
#: ../../c-api/type.rst:101
"If some of the base classes implements the GC protocol and the provided type "
"does not include the :const:`Py_TPFLAGS_HAVE_GC` in its flags, then the GC "
"protocol will be automatically implemented from its parents. On the "
"contrary, if the type being created does include :const:`Py_TPFLAGS_HAVE_GC` "
"in its flags then it **must** implement the GC protocol itself by at least "
"implementing the :c:member:`~PyTypeObject.tp_traverse` handle."
#: ../../c-api/type.rst:111
"Return the function pointer stored in the given slot. If the result is "
"``NULL``, this indicates that either the slot is ``NULL``, or that the "
"function was called with invalid parameters. Callers will typically cast the "
"result pointer into the appropriate function type."
"Retorna o ponteiro de função armazenado no slot fornecido. Se o resultado "
"for ``NULL``, isso indica que o slot é ``NULL`` ou que a função foi chamada "
"com parâmetros inválidos. Os chamadores normalmente lançarão o ponteiro do "
"resultado no tipo de função apropriado."
#: ../../c-api/type.rst:117
"See :c:member:`PyType_Slot.slot` for possible values of the *slot* argument."
"Veja :c:member:`PyType_Slot.slot` por possíveis valores do argumento *slot*."
#: ../../c-api/type.rst:119
msgid "An exception is raised if *type* is not a heap type."
msgstr "Uma exceção é levantada se *type* não é um tipo heap."
#: ../../c-api/type.rst:125
"Return the module object associated with the given type when the type was "
"created using :c:func:`PyType_FromModuleAndSpec`."
"Retorna o objeto de módulo associado ao tipo fornecido quando o tipo foi "
"criado usando :c:func:`PyType_FromModuleAndSpec`."
#: ../../c-api/type.rst:128 ../../c-api/type.rst:146
"If no module is associated with the given type, sets :py:class:`TypeError` "
"and returns ``NULL``."
"Se nenhum módulo estiver associado com o tipo fornecido, define :py:class:"
"`TypeError` e retorna ``NULL``."
#: ../../c-api/type.rst:131
"This function is usually used to get the module in which a method is "
"defined. Note that in such a method, ``PyType_GetModule(Py_TYPE(self))`` may "
"not return the intended result. ``Py_TYPE(self)`` may be a *subclass* of the "
"intended class, and subclasses are not necessarily defined in the same "
"module as their superclass. See :c:type:`PyCMethod` to get the class that "
"defines the method."
#: ../../c-api/type.rst:142
"Return the state of the module object associated with the given type. This "
"is a shortcut for calling :c:func:`PyModule_GetState()` on the result of :c:"
"func:`PyType_GetModule`."
#: ../../c-api/type.rst:149
"If the *type* has an associated module but its state is ``NULL``, returns "
"``NULL`` without setting an exception."
#: ../../c-api/type.rst:156
msgid "Creating Heap-Allocated Types"
#: ../../c-api/type.rst:158
"The following functions and structs are used to create :ref:`heap types "
"<heap-types>`."
#: ../../c-api/type.rst:163
"Creates and returns a heap type object from the *spec* (:const:"
"`Py_TPFLAGS_HEAPTYPE`)."
#: ../../c-api/type.rst:166
"If *bases* is a tuple, the created heap type contains all types contained in "
"it as base types."
#: ../../c-api/type.rst:169
"If *bases* is ``NULL``, the *Py_tp_bases* slot is used instead. If that also "
"is ``NULL``, the *Py_tp_base* slot is used instead. If that also is "
"``NULL``, the new type derives from :class:`object`."
#: ../../c-api/type.rst:173
"The *module* argument can be used to record the module in which the new "
"class is defined. It must be a module object or ``NULL``. If not ``NULL``, "
"the module is associated with the new type and can later be retrieved with :"
"c:func:`PyType_GetModule`. The associated module is not inherited by "
"subclasses; it must be specified for each class individually."
#: ../../c-api/type.rst:180
msgid "This function calls :c:func:`PyType_Ready` on the new type."
#: ../../c-api/type.rst:186
msgid "Equivalent to ``PyType_FromModuleAndSpec(NULL, spec, bases)``."
#: ../../c-api/type.rst:192
msgid "Equivalent to ``PyType_FromSpecWithBases(spec, NULL)``."
#: ../../c-api/type.rst:196
msgid "Structure defining a type's behavior."
#: ../../c-api/type.rst:200
msgid "Name of the type, used to set :c:member:`PyTypeObject.tp_name`."
#: ../../c-api/type.rst:205
"Size of the instance in bytes, used to set :c:member:`PyTypeObject."
"tp_basicsize` and :c:member:`PyTypeObject.tp_itemsize`."
#: ../../c-api/type.rst:211
msgid "Type flags, used to set :c:member:`PyTypeObject.tp_flags`."
#: ../../c-api/type.rst:213
"If the ``Py_TPFLAGS_HEAPTYPE`` flag is not set, :c:func:"
"`PyType_FromSpecWithBases` sets it automatically."
#: ../../c-api/type.rst:218
"Array of :c:type:`PyType_Slot` structures. Terminated by the special slot "
"value ``{0, NULL}``."
#: ../../c-api/type.rst:223
"Structure defining optional functionality of a type, containing a slot ID "
"and a value pointer."
#: ../../c-api/type.rst:228
msgid "A slot ID."
#: ../../c-api/type.rst:230
"Slot IDs are named like the field names of the structures :c:type:"
"`PyTypeObject`, :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, :c:"
"type:`PyMappingMethods` and :c:type:`PyAsyncMethods` with an added ``Py_`` "
"prefix. For example, use:"
#: ../../c-api/type.rst:236
msgid "``Py_tp_dealloc`` to set :c:member:`PyTypeObject.tp_dealloc`"
#: ../../c-api/type.rst:237
msgid "``Py_nb_add`` to set :c:member:`PyNumberMethods.nb_add`"
#: ../../c-api/type.rst:238
msgid "``Py_sq_length`` to set :c:member:`PySequenceMethods.sq_length`"
#: ../../c-api/type.rst:240
"The following fields cannot be set at all using :c:type:`PyType_Spec` and :c:"
"type:`PyType_Slot`:"
#: ../../c-api/type.rst:243
msgid ":c:member:`~PyTypeObject.tp_dict`"
msgstr ":c:member:`~PyTypeObject.tp_dict`"
#: ../../c-api/type.rst:244
msgid ":c:member:`~PyTypeObject.tp_mro`"
msgstr ":c:member:`~PyTypeObject.tp_mro`"
#: ../../c-api/type.rst:245
msgid ":c:member:`~PyTypeObject.tp_cache`"
msgstr ":c:member:`~PyTypeObject.tp_cache`"
#: ../../c-api/type.rst:246
msgid ":c:member:`~PyTypeObject.tp_subclasses`"
msgstr ":c:member:`~PyTypeObject.tp_subclasses`"
#: ../../c-api/type.rst:247
msgid ":c:member:`~PyTypeObject.tp_weaklist`"
msgstr ":c:member:`~PyTypeObject.tp_weaklist`"
#: ../../c-api/type.rst:248
msgid ":c:member:`~PyTypeObject.tp_vectorcall`"
msgstr ":c:member:`~PyTypeObject.tp_vectorcall`"
#: ../../c-api/type.rst:249
":c:member:`~PyTypeObject.tp_weaklistoffset` (see :ref:`PyMemberDef "
"<pymemberdef-offsets>`)"
#: ../../c-api/type.rst:251
":c:member:`~PyTypeObject.tp_dictoffset` (see :ref:`PyMemberDef <pymemberdef-"
"offsets>`)"
#: ../../c-api/type.rst:253
":c:member:`~PyTypeObject.tp_vectorcall_offset` (see :ref:`PyMemberDef "
"<pymemberdef-offsets>`)"
#: ../../c-api/type.rst:256
"The following fields cannot be set using :c:type:`PyType_Spec` and :c:type:"
"`PyType_Slot` under the limited API:"
#: ../../c-api/type.rst:259
msgid ":c:member:`~PyBufferProcs.bf_getbuffer`"
msgstr ":c:member:`~PyBufferProcs.bf_getbuffer`"
#: ../../c-api/type.rst:260
msgid ":c:member:`~PyBufferProcs.bf_releasebuffer`"
msgstr ":c:member:`~PyBufferProcs.bf_releasebuffer`"
#: ../../c-api/type.rst:262
"Setting :c:data:`Py_tp_bases` or :c:data:`Py_tp_base` may be problematic on "
"some platforms. To avoid issues, use the *bases* argument of :py:func:"
"`PyType_FromSpecWithBases` instead."
#: ../../c-api/type.rst:269
msgid "Slots in :c:type:`PyBufferProcs` may be set in the unlimited API."
#: ../../c-api/type.rst:273
"The desired value of the slot. In most cases, this is a pointer to a "
"function."
#: ../../c-api/type.rst:276
msgid "May not be ``NULL``."
Navigation Menu

Uh oh!

Uh oh!

Uh oh!

Uh oh!

FilesExpand file tree

type.po

Latest commit

History

type.po

File metadata and controls
