# 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

#

#, fuzzy

msgid ""

msgstr ""

"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/set.rst:6

msgid "Set Objects"

msgstr "Objeto Set"

#: ../../c-api/set.rst:15

msgid ""

"This section details the public API for :class:`set` and :class:`frozenset` "

"objects. Any functionality not listed below is best accessed using either "

"the abstract object protocol (including :c:func:`PyObject_CallMethod`, :c:"

"func:`PyObject_RichCompareBool`, :c:func:`PyObject_Hash`, :c:func:"

"`PyObject_Repr`, :c:func:`PyObject_IsTrue`, :c:func:`PyObject_Print`, and :c:"

"func:`PyObject_GetIter`) or the abstract number protocol (including :c:func:"

"`PyNumber_And`, :c:func:`PyNumber_Subtract`, :c:func:`PyNumber_Or`, :c:func:"

"`PyNumber_Xor`, :c:func:`PyNumber_InPlaceAnd`, :c:func:"

"`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr`, and :c:func:"

"`PyNumber_InPlaceXor`)."

msgstr ""

"Esta seção detalha a API pública para os objetos :class:`set` e :class:"

"`frozenset`. Qualquer funcionalidade não listada abaixo é melhor acessada "

"usando o protocolo de objeto abstrato (incluindo :c:func:"

"`PyObject_CallMethod`, :c:func:`PyObject_RichCompareBool`, :c:func:"

"`PyObject_Hash`, :c:func:`PyObject_Repr`, :c:func:`PyObject_IsTrue`, :c:func:"

"`PyObject_Print` e :c:func:`PyObject_GetIter`) ou o protocolo abstrato de "

"número (incluindo :c:func:`PyNumber_And`, :c:func:`PyNumber_Subtract`, :c:"

"func:`PyNumber_Or`, :c:func:`PyNumber_Xor`, :c:func:`PyNumber_InPlaceAnd`, :"

"c:func:`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr` e :c:func:"

"`PyNumber_InPlaceXor`)."

#: ../../c-api/set.rst:29

msgid ""

"This subtype of :c:type:`PyObject` is used to hold the internal data for "

"both :class:`set` and :class:`frozenset` objects. It is like a :c:type:"

"`PyDictObject` in that it is a fixed size for small sets (much like tuple "

"storage) and will point to a separate, variable sized block of memory for "

"medium and large sized sets (much like list storage). None of the fields of "

"this structure should be considered public and all are subject to change. "

"All access should be done through the documented API rather than by "

"manipulating the values in the structure."

msgstr ""

"Este subtipo de :c:type:`PyObject` é usado para manter os dados internos "

"para ambos os objetos :class:`set` e :class:`frozenset`. É como um :c:type:"

"`PyDictObject` em que tem um tamanho fixo para conjuntos pequenos (muito "

"parecido com o armazenamento de tupla) e apontará para um bloco de memória "

"de tamanho variável separado para conjuntos de tamanho médio e grande (muito "

"parecido com lista armazenamento). Nenhum dos campos desta estrutura deve "

"ser considerado público e todos estão sujeitos a alterações. Todo o acesso "

"deve ser feito por meio da API documentada, em vez de manipular os valores "

"na estrutura."

#: ../../c-api/set.rst:40

msgid ""

"This is an instance of :c:type:`PyTypeObject` representing the Python :class:"

"`set` type."

msgstr ""

"Essa é uma instância de :c:type:`PyTypeObject` representando o tipo Python :"

"class:`set`"

#: ../../c-api/set.rst:46

msgid ""

"This is an instance of :c:type:`PyTypeObject` representing the Python :class:"

"`frozenset` type."

msgstr ""

"Esta é uma instância de :c:type:`PyTypeObject` representando o tipo Python :"

"class:`frozenset`."

#: ../../c-api/set.rst:49

msgid ""

"The following type check macros work on pointers to any Python object. "

"Likewise, the constructor functions work with any iterable Python object."

msgstr ""

"As macros de verificação de tipo a seguir funcionam em ponteiros para "

"qualquer objeto Python. Da mesma forma, as funções construtoras funcionam "

"com qualquer objeto Python iterável."

#: ../../c-api/set.rst:55

msgid ""

"Return true if *p* is a :class:`set` object or an instance of a subtype. "

"This function always succeeds."

msgstr ""

"Retorna verdadeiro se *p* for um objeto :class:`set` ou uma instância de um "

"subtipo. Esta função sempre tem sucesso."

#: ../../c-api/set.rst:60

msgid ""

"Return true if *p* is a :class:`frozenset` object or an instance of a "

"subtype. This function always succeeds."

msgstr ""

"Retorna verdadeiro se *p* for um objeto :class:`frozenset` ou uma instância "

"de um subtipo. Esta função sempre tem sucesso."

#: ../../c-api/set.rst:65

msgid ""

"Return true if *p* is a :class:`set` object, a :class:`frozenset` object, or "

"an instance of a subtype. This function always succeeds."

msgstr ""

"Retorna verdadeiro se *p* for um objeto :class:`set`, um objeto :class:"

"`frozenset` ou uma instância de um subtipo. Esta função sempre tem sucesso."

#: ../../c-api/set.rst:71

msgid ""

"Return true if *p* is a :class:`set` object or a :class:`frozenset` object "

"but not an instance of a subtype. This function always succeeds."

msgstr ""

"Retorna verdadeiro se *p* for um objeto :class:`set` ou um objeto :class:"

"`frozenset`, mas não uma instância de um subtipo. Esta função sempre tem "

"sucesso."

#: ../../c-api/set.rst:77

msgid ""

"Return true if *p* is a :class:`frozenset` object but not an instance of a "

"subtype. This function always succeeds."

msgstr ""

"Retorna verdadeiro se *p* for um objeto :class:`frozenset`, mas não uma "

"instância de um subtipo. Esta função sempre tem sucesso."

#: ../../c-api/set.rst:83

msgid ""

"Return a new :class:`set` containing objects returned by the *iterable*. "

"The *iterable* may be ``NULL`` to create a new empty set. Return the new "

"set on success or ``NULL`` on failure. Raise :exc:`TypeError` if *iterable* "

"is not actually iterable. The constructor is also useful for copying a set "

"(``c=set(s)``)."

msgstr ""

"Retorna uma nova :class:`set` contendo objetos retornados pelo iterável "

"*iterable*. O *iterable* pode ser ``NULL`` para criar um novo conjunto "

"vazio. Retorna o novo conjunto em caso de sucesso ou ``NULL`` em caso de "

"falha. Levanta :exc:`TypeError` se *iterable* não for realmente iterável. O "

"construtor também é útil para copiar um conjunto (``c=set(s)``)."

#: ../../c-api/set.rst:92

msgid ""

"Return a new :class:`frozenset` containing objects returned by the "

"*iterable*. The *iterable* may be ``NULL`` to create a new empty frozenset. "

"Return the new set on success or ``NULL`` on failure. Raise :exc:"

"`TypeError` if *iterable* is not actually iterable."

msgstr ""

"Retorna uma nova :class:`frozenset` contendo objetos retornados pelo "

"iterável *iterable*. O *iterable* pode ser ``NULL`` para criar um novo "

"frozenset vazio. Retorna o novo conjunto em caso de sucesso ou ``NULL`` em "

"caso de falha. Levanta :exc:`TypeError` se *iterable* não for realmente "

"iterável."

#: ../../c-api/set.rst:98

msgid ""

"The following functions and macros are available for instances of :class:"

"`set` or :class:`frozenset` or instances of their subtypes."

msgstr ""

"As seguintes funções e macros estão disponíveis para instâncias de :class:"

"`set` ou :class:`frozenset` ou instâncias de seus subtipos."

#: ../../c-api/set.rst:106

msgid ""

"Return the length of a :class:`set` or :class:`frozenset` object. Equivalent "

"to ``len(anyset)``. Raises a :exc:`PyExc_SystemError` if *anyset* is not a :"

"class:`set`, :class:`frozenset`, or an instance of a subtype."

msgstr ""

"Retorna o comprimento de um objeto :class:`set` ou :class:`frozenset`. "

"Equivalente a ``len(anyset)``. Levanta um :exc:`PyExc_SystemError` se "

"*anyset* não for um :class:`set`, :class:`frozenset`, ou uma instância de um "

"subtipo."

#: ../../c-api/set.rst:113

msgid "Macro form of :c:func:`PySet_Size` without error checking."

msgstr "Forma macro de :c:func:`PySet_Size` sem verificação de erros."

#: ../../c-api/set.rst:118

msgid ""

"Return ``1`` if found, ``0`` if not found, and ``-1`` if an error is "

"encountered. Unlike the Python :meth:`__contains__` method, this function "

"does not automatically convert unhashable sets into temporary frozensets. "

"Raise a :exc:`TypeError` if the *key* is unhashable. Raise :exc:"

"`PyExc_SystemError` if *anyset* is not a :class:`set`, :class:`frozenset`, "

"or an instance of a subtype."

msgstr ""

"Retorna ``1`` se encontrado, ``0`` se não encontrado, e ``-1`` se um erro é "

"encontrado. Ao contrário do método Python :meth:`__contains__`, esta função "

"não converte automaticamente conjuntos não hasheáveis em frozensets "

"temporários. Levanta um :exc:`TypeError` se a *key* não for hasheável. "

"Levanta :exc:`PyExc_SystemError` se *anyset* não é um :class:`set`, :class:"

"`frozenset`, ou uma instância de um subtipo."

#: ../../c-api/set.rst:127

msgid ""

"Add *key* to a :class:`set` instance. Also works with :class:`frozenset` "

"instances (like :c:func:`PyTuple_SetItem` it can be used to fill in the "

"values of brand new frozensets before they are exposed to other code). "

"Return ``0`` on success or ``-1`` on failure. Raise a :exc:`TypeError` if "

"the *key* is unhashable. Raise a :exc:`MemoryError` if there is no room to "

"grow. Raise a :exc:`SystemError` if *set* is not an instance of :class:"

"`set` or its subtype."

msgstr ""

"Adiciona *key* a uma instância de :class:`set`. Também funciona com "

"instâncias de :class:`frozenset` (como :c:func:`PyTuple_SetItem`, ele pode "

"ser usado para preencher os valores de novos conjuntos de congelamentos "

"antes que eles sejam expostos a outro código). Retorna ``0`` em caso de "

"sucesso ou ``-1`` em caso de falha. Levanta um :exc:`TypeError` se a *key* "

"não for hasheável. Levanta uma :exc:`MemoryError` se não houver espaço para "

"crescer. Levanta uma :exc:`SystemError` se *set* não for uma instância de :"

"class:`set` ou seu subtipo."

#: ../../c-api/set.rst:136

msgid ""

"The following functions are available for instances of :class:`set` or its "

"subtypes but not for instances of :class:`frozenset` or its subtypes."

msgstr ""

"As seguintes funções estão disponíveis para instâncias de :class:`set` ou "

"seus subtipos, mas não para instâncias de :class:`frozenset` ou seus "

"subtipos."

#: ../../c-api/set.rst:142

msgid ""

"Return ``1`` if found and removed, ``0`` if not found (no action taken), and "

"``-1`` if an error is encountered. Does not raise :exc:`KeyError` for "

"missing keys. Raise a :exc:`TypeError` if the *key* is unhashable. Unlike "

"the Python :meth:`~set.discard` method, this function does not automatically "

"convert unhashable sets into temporary frozensets. Raise :exc:"

"`PyExc_SystemError` if *set* is not an instance of :class:`set` or its "

"subtype."

msgstr ""

"Retorna ``1`` se encontrado e removido, ``0`` se não encontrado (nenhuma "

"ação realizada) e ``-1`` se um erro for encontrado. Não levanta :exc:"

"`KeyError` para chaves ausentes. Levanta uma :exc:`TypeError` se a *key* não "

"for hasheável. Ao contrário do método Python :meth:`~set.discard`, esta "

"função não converte automaticamente conjuntos não hasheáveis em frozensets "

"temporários. Levanta :exc:`PyExc_SystemError` se *set* não é uma instância "

"de :class:`set` ou seu subtipo."

#: ../../c-api/set.rst:152

msgid ""

"Return a new reference to an arbitrary object in the *set*, and removes the "

"object from the *set*. Return ``NULL`` on failure. Raise :exc:`KeyError` "

"if the set is empty. Raise a :exc:`SystemError` if *set* is not an instance "

"of :class:`set` or its subtype."

msgstr ""

"Retorna uma nova referência a um objeto arbitrário no *set* e remove o "

"objeto do *set*. Retorna ``NULL`` em caso de falha. Levanta :exc:`KeyError` "

"se o conjunto estiver vazio. Levanta uma :exc:`SystemError` se *set* não for "

"uma instância de :class:`set` ou seu subtipo."

#: ../../c-api/set.rst:160

msgid "Empty an existing set of all elements."

msgstr "Limpa todos os elementos de um conjunto existente"