python-docs-pt-br/c-api/tuple.po at 3.15 · python/python-docs-pt-br

389 lines (338 loc) · 15 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 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
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-05-08 18:34+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+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"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: pt_BR\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."
"Este subtipo de :c:type:`PyObject` representa um objeto tupla em Python."
#: ../../c-api/tuple.rst:18
"This instance of :c:type:`PyTypeObject` represents the Python tuple type; it "
"is the same object as :class:`tuple` in the Python layer."
"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
"Return true if *p* is a tuple object or an instance of a subtype of the "
"tuple type.  This function always succeeds."
"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
"Return true if *p* is a tuple object, but not an instance of a subtype of "
"the tuple type.  This function always succeeds."
"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
"Return a new tuple object of size *len*, or ``NULL`` with an exception set "
"on failure."
"Retorna um novo objeto tupla de tamanho *len*, ou ``NULL`` com uma exceção "
"definida em caso de falha."
#: ../../c-api/tuple.rst:42
"Create a tuple of *size* items and copy references from *array* to the new "
#: ../../c-api/tuple.rst:45
msgid "*array* can be NULL if *size* is ``0``."
#: ../../c-api/tuple.rst:47
"On success, return a new reference. On error, set an exception and return "
"``NULL``."
#: ../../c-api/tuple.rst:55
"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)``."
"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:63
"Take a pointer to a tuple object, and return the size of that tuple. On "
"error, return ``-1`` with an exception set."
"Pega um ponteiro para um objeto tupla e retorna o tamanho dessa tupla. No "
"erro, retorna ``-1`` com uma exceção definida."
#: ../../c-api/tuple.rst:69
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:74
"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."
"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:77
"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`."
"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:86
msgid "Like :c:func:`PyTuple_GetItem`, but does no checking of its arguments."
"Como :c:func:`PyTuple_GetItem`, mas faz nenhuma verificação de seus "
"argumentos."
#: ../../c-api/tuple.rst:91
"Return the slice of the tuple pointed to by *p* between *low* and *high*, or "
"``NULL`` with an exception set on failure."
"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:94
"This is the equivalent of the Python expression ``p[low:high]``. Indexing "
"from the end of the tuple is not supported."
"Isso é o equivalente da expressão Python ``p[low:high]``. A indexação do "
"final da tupla não é suportada."
#: ../../c-api/tuple.rst:100
"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. This function should only be used to "
"fill in brand new tuples; using it on an existing tuple is thread-unsafe."
#: ../../c-api/tuple.rst:107
"This function \"steals\" a reference to *o* and discards a reference to an "
"item already in the tuple at the affected position."
"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:113
"Like :c:func:`PyTuple_SetItem`, but does no error checking, and should "
"*only* be used to fill in brand new tuples, using it on an existing tuple is "
"thread-unsafe."
#: ../../c-api/tuple.rst:116 ../../c-api/tuple.rst:243
#: ../../c-api/tuple.rst:261
"Bounds checking is performed as an assertion if Python is built in :ref:"
"`debug mode <debug-build>` or :option:`with assertions <--with-assertions>`."
"A verificação de limites é realizada como uma asserção se o Python for "
"construído em :ref:`modo de depuração <debug-build>` ou :option:`com "
"asserções <--with-assertions>`."
#: ../../c-api/tuple.rst:121
"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."
"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á "
#: ../../c-api/tuple.rst:128
"This macro should *only* be used on tuples that are newly created. Using "
"this macro on a tuple that is already in use (or in other words, has a "
"refcount > 1) could lead to undefined behavior."
"Esta macro deve ser usada *somente* em tuplas recém-criadas. Usar esta macro "
"em uma tupla que já está em uso (ou, em outras palavras, com uma contagem de "
"referências > 1) pode levar a um comportamento indefinido."
#: ../../c-api/tuple.rst:135
"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`."
"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:150
msgid "Struct Sequence Objects"
msgstr "Objetos sequência de estrutura"
#: ../../c-api/tuple.rst:152
"A struct sequence object is a :term:`named tuple`, that is, a sequence whose "
"items can also be accessed through attributes. It is similar to :func:"
"`collections.namedtuple`, but provides a slightly different interface."
#: ../../c-api/tuple.rst:157
"To create a struct sequence, you first have to create a specific struct "
"sequence type."
#: ../../c-api/tuple.rst:162
"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`."
"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:165 ../../c-api/tuple.rst:234
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:170
msgid "Initializes a struct sequence type *type* from *desc* in place."
"Inicializa um tipo de sequência de estrutura *type* de *desc* no lugar."
#: ../../c-api/tuple.rst:175
"Like :c:func:`PyStructSequence_InitType`, but returns ``0`` on success and "
"``-1`` with an exception set on failure."
"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:183
msgid "Contains the meta information of a struct sequence type to create."
"Contém as metainformações de um tipo de sequência de estrutura a ser criado."
#: ../../c-api/tuple.rst:187
"Fully qualified name of the type; null-terminated UTF-8 encoded. The name "
"must contain the module name."
"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:192
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:196
msgid "Pointer to ``NULL``-terminated array with field names of the new type."
"Ponteiro para um vetor terminado em ``NULL`` com nomes de campos do novo tipo"
#: ../../c-api/tuple.rst:200
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:205
"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."
"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:213
"Name for the field or ``NULL`` to end the list of named fields, set to :c:"
"data:`PyStructSequence_UnnamedField` to leave unnamed."
"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:218
msgid "Field docstring or ``NULL`` to omit."
msgstr "Campo docstring ou ``NULL`` para omitir."
#: ../../c-api/tuple.rst:223
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:225
msgid "The type was changed from ``char *``."
msgstr "O tipo foi alterado de ``char *``."
#: ../../c-api/tuple.rst:231
"Creates an instance of *type*, which must have been created with :c:func:"
"`PyStructSequence_NewType`."
"Cria um instância de *type*, que deve ser criada com :c:func:"
"`PyStructSequence_NewType`."
#: ../../c-api/tuple.rst:239
"Return the object at position *pos* in the struct sequence pointed to by "
"*p*. The returned reference is borrowed from the struct sequence *p* (that "
"is: it is only valid as long as you hold a reference to *p*)."
#: ../../c-api/tuple.rst:249
msgid "Alias to :c:func:`PyStructSequence_GetItem`."
msgstr "Apelido para :c:func:`PyStructSequence_GetItem`."
#: ../../c-api/tuple.rst:251
msgid "Now implemented as an alias to :c:func:`PyStructSequence_GetItem`."
"Agora implementada como um apelido para :c:func:`PyStructSequence_GetItem`."
#: ../../c-api/tuple.rst:257
"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."
"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:266
msgid "This function \"steals\" a reference to *o*."
msgstr "Esta função \"rouba\" uma referência a *o*."
#: ../../c-api/tuple.rst:271
msgid "Alias to :c:func:`PyStructSequence_SetItem`."
msgstr "Apelido para :c:func:`PyStructSequence_SetItem`."
#: ../../c-api/tuple.rst:273
msgid "Now implemented as an alias to :c:func:`PyStructSequence_SetItem`."
"Agora implementada como um apelido para :c:func:`PyStructSequence_SetItem`."
#: ../../c-api/tuple.rst:8
msgid "object"
msgstr "objeto"
#: ../../c-api/tuple.rst:8
msgid "tuple"
msgstr "tupla"
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

tuple.po

Latest commit

History

tuple.po

File metadata and controls
