# 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:

# Rafael Fontenelle <rffontenelle@gmail.com>, 2025

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.12\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2025-01-03 14:53+0000\n"

"PO-Revision-Date: 2025-07-18 19:57+0000\n"

"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 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/tuple.rst:6

msgid "Tuple Objects"

msgstr "Objeto tupla"

#: ../../c-api/tuple.rst:13

msgid "This subtype of :c:type:`PyObject` represents a Python tuple object."

msgstr ""

"Este subtipo de :c:type:`PyObject` representa um objeto tupla em Python."

#: ../../c-api/tuple.rst:18

msgid ""

"This instance of :c:type:`PyTypeObject` represents the Python tuple type; it "

"is the same object as :class:`tuple` in the Python layer."

msgstr ""

"Esta instância de :c:type:`PyTypeObject` representa o tipo tupla de Python; "

"é o mesmo objeto que :class:`tuple` na camada Python."

#: ../../c-api/tuple.rst:24

msgid ""

"Return true if *p* is a tuple object or an instance of a subtype of the "

"tuple type. This function always succeeds."

msgstr ""

"Retorna verdadeiro se *p* é um objeto tupla ou uma instância de um subtipo "

"do tipo tupla. Esta função sempre tem sucesso."

#: ../../c-api/tuple.rst:30

msgid ""

"Return true if *p* is a tuple object, but not an instance of a subtype of "

"the tuple type. This function always succeeds."

msgstr ""

"Retorna verdadeiro se *p* é um objeto tupla, mas não uma instância de um "

"subtipo do tipo tupla. Esta função sempre tem sucesso."

#: ../../c-api/tuple.rst:36

msgid ""

"Return a new tuple object of size *len*, or ``NULL`` with an exception set "

"on failure."

msgstr ""

"Retorna um novo objeto tupla de tamanho *len*, ou ``NULL`` com uma exceção "

"definida em caso de falha."

#: ../../c-api/tuple.rst:42

msgid ""

"Return a new tuple object of size *n*, or ``NULL`` with an exception set on "

"failure. The tuple values are initialized to the subsequent *n* C arguments "

"pointing to Python objects. ``PyTuple_Pack(2, a, b)`` is equivalent to "

"``Py_BuildValue(\"(OO)\", a, b)``."

msgstr ""

"Retorna um novo objeto tupla de tamanho *n*, ou ``NULL`` com uma exceção em "

"caso de falha. Os valores da tupla são inicializados para os *n* argumentos "

"C subsequentes apontando para objetos Python. ```PyTuple_Pack(2, a, b)`` é "

"equivalente a ``Py_BuildValue(\"(OO)\", a, b)``."

#: ../../c-api/tuple.rst:50

msgid ""

"Take a pointer to a tuple object, and return the size of that tuple. On "

"error, return ``-1`` and with an exception set."

msgstr ""

"Pega um ponteiro para um objeto tupla e retorna o tamanho dessa tupla. No "

"erro, retorna ``-1`` e com uma exceção definida."

#: ../../c-api/tuple.rst:56

msgid "Like :c:func:`PyTuple_Size`, but without error checking."

msgstr "Como :c:func:`PyTuple_Size`, mas sem verificação de erro."

#: ../../c-api/tuple.rst:61

msgid ""

"Return the object at position *pos* in the tuple pointed to by *p*. If "

"*pos* is negative or out of bounds, return ``NULL`` and set an :exc:"

"`IndexError` exception."

msgstr ""

"Retorna o objeto na posição *pos* na tupla apontada por *p*. Se *pos* "

"estiver fora dos limites, retorna ``NULL`` e define uma exceção :exc:"

"`IndexError`."

#: ../../c-api/tuple.rst:64

msgid ""

"The returned reference is borrowed from the tuple *p* (that is: it is only "

"valid as long as you hold a reference to *p*). To get a :term:`strong "

"reference`, use :c:func:`Py_NewRef(PyTuple_GetItem(...)) <Py_NewRef>` or :c:"

"func:`PySequence_GetItem`."

msgstr ""

"A referência retornada é emprestada da tupla *p* (ou seja: ela só é válida "

"enquanto você mantém uma referência a *p*). Para obter uma :term:`referência "

"forte`, use :c:func:`Py_NewRef(PyTuple_GetItem(...)) <Py_NewRef>` ou :c:func:"

"`PySequence_GetItem`."

#: ../../c-api/tuple.rst:73

msgid "Like :c:func:`PyTuple_GetItem`, but does no checking of its arguments."

msgstr ""

"Como :c:func:`PyTuple_GetItem`, mas faz nenhuma verificação de seus "

"argumentos."

#: ../../c-api/tuple.rst:78

msgid ""

"Return the slice of the tuple pointed to by *p* between *low* and *high*, or "

"``NULL`` with an exception set on failure."

msgstr ""

"Retorna a fatia da tupla apontada por *p* entre *low* e *high*, ou ``NULL`` "

"com uma exceção definida em caso de falha."

#: ../../c-api/tuple.rst:81

msgid ""

"This is the equivalent of the Python expression ``p[low:high]``. Indexing "

"from the end of the tuple is not supported."

msgstr ""

"Isso é o equivalente da expressão Python ``p[low:high]``. A indexação do "

"final da tupla não é suportada."

#: ../../c-api/tuple.rst:87

msgid ""

"Insert a reference to object *o* at position *pos* of the tuple pointed to "

"by *p*. Return ``0`` on success. If *pos* is out of bounds, return ``-1`` "

"and set an :exc:`IndexError` exception."

msgstr ""

"Insere uma referência ao objeto *o* na posição *pos* da tupla apontada por "

"*p*. Retorna ``0`` em caso de sucesso. Se *pos* estiver fora dos limites, "

"retorne ``-1`` e define uma exceção :exc:`IndexError`."

#: ../../c-api/tuple.rst:93

msgid ""

"This function \"steals\" a reference to *o* and discards a reference to an "

"item already in the tuple at the affected position."

msgstr ""

"Esta função \"rouba\" uma referência a *o* e descarta uma referência a um "

"item já na tupla na posição afetada."

#: ../../c-api/tuple.rst:99

msgid ""

"Like :c:func:`PyTuple_SetItem`, but does no error checking, and should "

"*only* be used to fill in brand new tuples."

msgstr ""

"Como :c:func:`PyTuple_SetItem`, mas não verifica erros e deve *apenas* ser "

"usado para preencher novas tuplas."

#: ../../c-api/tuple.rst:104

msgid ""

"This function \"steals\" a reference to *o*, and, unlike :c:func:"

"`PyTuple_SetItem`, does *not* discard a reference to any item that is being "

"replaced; any reference in the tuple at position *pos* will be leaked."

msgstr ""

"Esta função \"rouba\" uma referência para *o* e, ao contrário de :c:func:"

"`PyTuple_SetItem`, *não* descarta uma referência para nenhum item que esteja "

"sendo substituído; qualquer referência na tupla na posição *pos* será "

"perdida."

#: ../../c-api/tuple.rst:112

msgid ""

"Can be used to resize a tuple. *newsize* will be the new length of the "

"tuple. Because tuples are *supposed* to be immutable, this should only be "

"used if there is only one reference to the object. Do *not* use this if the "

"tuple may already be known to some other part of the code. The tuple will "

"always grow or shrink at the end. Think of this as destroying the old tuple "

"and creating a new one, only more efficiently. Returns ``0`` on success. "

"Client code should never assume that the resulting value of ``*p`` will be "

"the same as before calling this function. If the object referenced by ``*p`` "

"is replaced, the original ``*p`` is destroyed. On failure, returns ``-1`` "

"and sets ``*p`` to ``NULL``, and raises :exc:`MemoryError` or :exc:"

"`SystemError`."

msgstr ""

"Pode ser usado para redimensionar uma tupla. *newsize* será o novo "

"comprimento da tupla. Como as tuplas são *supostamente* imutáveis, isso só "

"deve ser usado se houver apenas uma referência ao objeto. *Não* use isto se "

"a tupla já for conhecida por alguma outra parte do código. A tupla sempre "

"aumentará ou diminuirá no final. Pense nisso como destruir a tupla antiga e "

"criar uma nova, mas com mais eficiência. Retorna ``0`` em caso de sucesso. O "

"código do cliente nunca deve presumir que o valor resultante de ``*p`` será "

"o mesmo de antes de chamar esta função. Se o objeto referenciado por ``*p`` "

"for substituído, o ``*p`` original será destruído. Em caso de falha, retorna "

"``-1`` e define ``*p`` para ``NULL``, e levanta :exc:`MemoryError` ou :exc:"

"`SystemError`."

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

msgid "Struct Sequence Objects"

msgstr "Objetos sequência de estrutura"

#: ../../c-api/tuple.rst:129

msgid ""

"Struct sequence objects are the C equivalent of :func:`~collections."

"namedtuple` objects, i.e. a sequence whose items can also be accessed "

"through attributes. To create a struct sequence, you first have to create a "

"specific struct sequence type."

msgstr ""

"Objetos sequência de estrutura são o equivalente em C dos objetos :func:"

"`~Collections.namedtuple`, ou seja, uma sequência cujos itens também podem "

"ser acessados por meio de atributos. Para criar uma sequência de estrutura, "

"você primeiro precisa criar um tipo de sequência de estrutura específico."

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

msgid ""

"Create a new struct sequence type from the data in *desc*, described below. "

"Instances of the resulting type can be created with :c:func:"

"`PyStructSequence_New`."

msgstr ""

"Cria um novo tipo de sequência de estrutura a partir dos dados em *desc*, "

"descrito abaixo. Instâncias do tipo resultante podem ser criadas com :c:func:"

"`PyStructSequence_New`."

#: ../../c-api/tuple.rst:139 ../../c-api/tuple.rst:208

msgid "Return ``NULL`` with an exception set on failure."

msgstr "Retorna ``NULL`` com uma exceção definida em caso de falha."

#: ../../c-api/tuple.rst:144

msgid "Initializes a struct sequence type *type* from *desc* in place."

msgstr ""

"Inicializa um tipo de sequência de estrutura *type* de *desc* no lugar."

#: ../../c-api/tuple.rst:149

msgid ""

"Like :c:func:`PyStructSequence_InitType`, but returns ``0`` on success and "

"``-1`` with an exception set on failure."

msgstr ""

"Como :c:func:`PyStructSequence_InitType`, mas retorna ``0`` em caso de "

"sucesso e ``-1`` com uma exceção definida em caso de falha."

#: ../../c-api/tuple.rst:157

msgid "Contains the meta information of a struct sequence type to create."

msgstr ""

"Contém as metainformações de um tipo de sequência de estrutura a ser criado."

#: ../../c-api/tuple.rst:161

msgid ""

"Fully qualified name of the type; null-terminated UTF-8 encoded. The name "

"must contain the module name."

msgstr ""

"Nome totalmente qualificado do tipo; codificado em UTF-8 terminado em nulo. "

"O nome deve conter o nome do módulo."

#: ../../c-api/tuple.rst:166

msgid "Pointer to docstring for the type or ``NULL`` to omit."

msgstr "Ponteiro para docstring para o tipo ou ``NULL`` para omitir"

#: ../../c-api/tuple.rst:170

msgid "Pointer to ``NULL``-terminated array with field names of the new type."

msgstr ""

"Ponteiro para um vetor terminado em ``NULL`` com nomes de campos do novo tipo"

#: ../../c-api/tuple.rst:174

msgid "Number of fields visible to the Python side (if used as tuple)."

msgstr "Número de campos visíveis para o lado Python (se usado como tupla)"

#: ../../c-api/tuple.rst:179

msgid ""

"Describes a field of a struct sequence. As a struct sequence is modeled as a "

"tuple, all fields are typed as :c:expr:`PyObject*`. The index in the :c:"

"member:`~PyStructSequence_Desc.fields` array of the :c:type:"

"`PyStructSequence_Desc` determines which field of the struct sequence is "

"described."

msgstr ""

"Descreve um campo de uma sequência de estrutura. Como uma sequência de "

"estrutura é modelada como uma tupla, todos os campos são digitados como :c:"

"expr:`PyObject*`. O índice no vetor :c:member:`~PyStructSequence_Desc."

"fields` do :c:type:`PyStructSequence_Desc` determina qual campo da sequência "

"de estrutura é descrito."

#: ../../c-api/tuple.rst:187

msgid ""

"Name for the field or ``NULL`` to end the list of named fields, set to :c:"

"data:`PyStructSequence_UnnamedField` to leave unnamed."

msgstr ""

"Nome do campo ou ``NULL`` para terminar a lista de campos nomeados; definida "

"para :c:data:`PyStructSequence_UnnamedField` para deixar sem nome."

#: ../../c-api/tuple.rst:192

msgid "Field docstring or ``NULL`` to omit."

msgstr "Campo docstring ou ``NULL`` para omitir."

#: ../../c-api/tuple.rst:197

msgid "Special value for a field name to leave it unnamed."

msgstr "Valor especial para um nome de campo para deixá-lo sem nome."

#: ../../c-api/tuple.rst:199

msgid "The type was changed from ``char *``."

msgstr "O tipo foi alterado de ``char *``."

#: ../../c-api/tuple.rst:205

msgid ""

"Creates an instance of *type*, which must have been created with :c:func:"

"`PyStructSequence_NewType`."

msgstr ""

"Cria um instância de *type*, que deve ser criada com :c:func:"

"`PyStructSequence_NewType`."

#: ../../c-api/tuple.rst:213

msgid ""

"Return the object at position *pos* in the struct sequence pointed to by "

"*p*. No bounds checking is performed."

msgstr ""

"Retorna o objeto na posição *pos* na sequência de estrutura apontada por "

"*p*. Nenhuma verificação de limites é executada."

#: ../../c-api/tuple.rst:219

msgid "Macro equivalent of :c:func:`PyStructSequence_GetItem`."

msgstr "Macro equivalente de :c:func:`PyStructSequence_GetItem`."

#: ../../c-api/tuple.rst:224

msgid ""

"Sets the field at index *pos* of the struct sequence *p* to value *o*. "

"Like :c:func:`PyTuple_SET_ITEM`, this should only be used to fill in brand "

"new instances."

msgstr ""

"Define o campo no índice *pos* da sequência de estrutura *p* para o valor "

"*o*. Como :c:func:`PyTuple_SET_ITEM`, isto só deve ser usado para preencher "

"novas instâncias."

#: ../../c-api/tuple.rst:230 ../../c-api/tuple.rst:240

msgid "This function \"steals\" a reference to *o*."

msgstr "Esta função \"rouba\" uma referência a *o*."

#: ../../c-api/tuple.rst:235

msgid ""

"Similar to :c:func:`PyStructSequence_SetItem`, but implemented as a static "

"inlined function."

msgstr ""

"Similar a :c:func:`PyStructSequence_SetItem`, mas implementada como uma "

"função inline estática."

#: ../../c-api/tuple.rst:8

msgid "object"

msgstr "objeto"

#: ../../c-api/tuple.rst:8

msgid "tuple"

msgstr "tupla"