Sandbox::https://github.com/python/python-docs-pt-br/blob/3.7/tutorial/datastructures.po

Repository navigation

816 lines (728 loc) · 44.4 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2023, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# Translators:
# Claudio Rogerio Carvalho Filho <excriptbrasil@gmail.com>, 2019
# Leticia Portella <leportella@gmail.com>, 2019
# Cauê Baasch de Souza <cauebaasch@gmail.com>, 2019
# Victor Matheus Castro <victormatheuscastro@gmail.com>, 2019
# Adorilson Bezerra <adorilson@gmail.com>, 2019
"Project-Id-Version: Python 3.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-06-23 16:56+0000\n"
"PO-Revision-Date: 2019-09-01 02:41+0000\n"
"Last-Translator: Adorilson Bezerra <adorilson@gmail.com>, 2019\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"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:5
msgid "Data Structures"
msgstr "Estruturas de dados"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:7
"This chapter describes some things you've learned about already in more "
"detail, and adds some new things as well."
"Esse capítulo descreve algumas coisas que você já aprendeu em detalhes e "
"adiciona algumas coisas novas também."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:13
msgid "More on Lists"
msgstr "Mais sobre listas"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:15
"The list data type has some more methods.  Here are all of the methods of "
"list objects:"
"O tipo de dado lista tem ainda mais métodos. Aqui estão apresentados todos "
"os métodos de objetos do tipo lista:"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:22
"Add an item to the end of the list.  Equivalent to ``a[len(a):] = [x]``."
msgstr "Adiciona um item ao fim da lista. Equivalente a ``a[len(a):] = [x]``."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:28
"Extend the list by appending all the items from the iterable.  Equivalent to "
"``a[len(a):] = iterable``."
"Prolonga a lista, adicionando no fim todos os elementos do argumento "
"`iterable` passado como parâmetro. Equivalente a ``a[len(a):] = iterable``."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:35
"Insert an item at a given position.  The first argument is the index of the "
"element before which to insert, so ``a.insert(0, x)`` inserts at the front "
"of the list, and ``a.insert(len(a), x)`` is equivalent to ``a.append(x)``."
"Insere um item em uma dada posição. O primeiro argumento é o índice do "
"elemento anterior ao qual você deseja inserir, então ``a.insert(0, x)`` "
"insere um elemento na frente da lista e ``a.insert(len(a), x)`` é "
"equivalente a ``a.append(x)``."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:43
"Remove the first item from the list whose value is equal to *x*.  It raises "
"a :exc:`ValueError` if there is no such item."
"Remove o primeiro item encontrado na lista cujo valor é igual a *x*. Se não "
"existir valor igual, uma exceção :exc:`ValueError` é levantada."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:50
"Remove the item at the given position in the list, and return it.  If no "
"index is specified, ``a.pop()`` removes and returns the last item in the "
"list.  (The square brackets around the *i* in the method signature denote "
"that the parameter is optional, not that you should type square brackets at "
"that position.  You will see this notation frequently in the Python Library "
"Reference.)"
"Remove um item em uma dada posição na lista e o retorna. Se nenhum índice é "
"especificado, ``a.pop()`` remove e retorna o último item da lista. (Os "
"colchetes ao redor do *i* na demonstração do método indica que o parâmetro é "
"opcional, e não que é necessário escrever estes colchetes ao chamar o "
"método. Você verá este tipo de notação frequentemente na Biblioteca de "
"Referência Python.)"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:60
msgid "Remove all items from the list.  Equivalent to ``del a[:]``."
msgstr "Remove todos os itens de uma lista. Equivalente a ``del a[:]``."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:66
"Return zero-based index in the list of the first item whose value is equal "
"to *x*. Raises a :exc:`ValueError` if there is no such item."
"Devolve o índice base-zero do primeiro item cujo valor é igual a *x*, "
"levantando :exc:`ValueError`  se este valor não existe."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:69
"The optional arguments *start* and *end* are interpreted as in the slice "
"notation and are used to limit the search to a particular subsequence of the "
"list.  The returned index is computed relative to the beginning of the full "
"sequence rather than the *start* argument."
"Os argumentos opcionais *start* e *end* são interpretados como nas notações "
"de fatiamento e são usados para limitar a busca para uma subsequência "
"específica da lista. O índice retornado é calculado relativo ao começo da "
"sequência inteira e não referente ao argumento *start*."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:78
msgid "Return the number of times *x* appears in the list."
msgstr "Retorna o número de vezes em que *x* aparece na lista."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:84
"Sort the items of the list in place (the arguments can be used for sort "
"customization, see :func:`sorted` for their explanation)."
"Ordena os itens na lista (os argumentos podem ser usados para personalizar a "
"ordenação, veja a função :func:`sorted` para maiores explicações)."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:91
msgid "Reverse the elements of the list in place."
msgstr "Inverte a ordem dos elementos na lista."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:97
msgid "Return a shallow copy of the list.  Equivalent to ``a[:]``."
msgstr "Devolve uma cópia rasa da lista. Equivalente a ``a[:]``."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:100
msgid "An example that uses most of the list methods::"
msgstr "Um exemplo que usa a maior parte dos métodos das listas::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:123
"You might have noticed that methods like ``insert``, ``remove`` or ``sort`` "
"that only modify the list have no return value printed -- they return the "
"default ``None``. [1]_  This is a design principle for all mutable data "
"structures in Python."
"Você pode ter percebido que métodos como ``insert``, ``remove`` ou ``sort``, "
"que apenas modificam a lista, não têm valor de retorno impresso -- eles "
"retornam o ``None`` padrão. [1]_  Isto é um princípio de design para todas "
"as estruturas de dados mutáveis em Python."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:132
msgid "Using Lists as Stacks"
msgstr "Usando listas como pilhas"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:137
"The list methods make it very easy to use a list as a stack, where the last "
"element added is the first element retrieved (\"last-in, first-out\").  To "
"add an item to the top of the stack, use :meth:`append`.  To retrieve an "
"item from the top of the stack, use :meth:`pop` without an explicit index.  "
"For example::"
"Os métodos de lista tornam muito fácil utilizar listas como pilhas, onde o "
"item adicionado por último é o primeiro a ser recuperado (política “último a "
"entrar, primeiro a sair”). Para adicionar um item ao topo da pilha, use :"
"meth:`append`. Para recuperar um item do topo da pilha use :meth:`pop` sem "
"nenhum índice. Por exemplo::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:162
msgid "Using Lists as Queues"
msgstr "Usando listas como filas"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:166
"It is also possible to use a list as a queue, where the first element added "
"is the first element retrieved (\"first-in, first-out\"); however, lists are "
"not efficient for this purpose.  While appends and pops from the end of list "
"are fast, doing inserts or pops from the beginning of a list is slow "
"(because all of the other elements have to be shifted by one)."
"Você também pode usar uma lista como uma fila, onde o primeiro item "
"adicionado é o primeiro a ser recuperado (política “primeiro a entrar, "
"primeiro a sair”); porém, listas não são eficientes para esta finalidade. "
"Embora *appends* e *pops* no final da lista sejam rápidos, fazer *inserts* "
"ou *pops* no início da lista é lento (porque todos os demais elementos têm "
"que ser deslocados)."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:172
"To implement a queue, use :class:`collections.deque` which was designed to "
"have fast appends and pops from both ends.  For example::"
"Para implementar uma fila, use a classe :class:`collections.deque` que foi "
"projetada para permitir *appends* e *pops* eficientes nas duas extremidades. "
"Por exemplo::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:190
msgid "List Comprehensions"
msgstr "Compreensões de lista"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:192
"List comprehensions provide a concise way to create lists. Common "
"applications are to make new lists where each element is the result of some "
"operations applied to each member of another sequence or iterable, or to "
"create a subsequence of those elements that satisfy a certain condition."
"Compreensões de lista fornece uma maneira concisa de criar uma lista. "
"Aplicações comuns são criar novas listas onde cada elemento é o resultado de "
"alguma operação aplicada a cada elemento de outra sequência ou iterável, ou "
"criar uma subsequência de elementos que satisfaçam uma certa condição. (N.d."
"T. o termo original em inglês é *list comprehensions*, muito utilizado no "
"Brasil; também se usa a abreviação *listcomp*)."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:197
msgid "For example, assume we want to create a list of squares, like::"
"Por exemplo, suponha que queremos criar uma lista de quadrados, assim::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:206
"Note that this creates (or overwrites) a variable named ``x`` that still "
"exists after the loop completes.  We can calculate the list of squares "
"without any side effects using::"
"Note que isto cria (ou sobrescreve) uma variável chamada ``x`` que ainda "
"existe após o término do laço. Podemos calcular a lista dos quadrados sem "
"qualquer efeito colateral usando::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:212
msgid "or, equivalently::"
msgstr "ou, de maneira equivalente::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:216
msgid "which is more concise and readable."
msgstr "que é mais conciso e legível."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:218
"A list comprehension consists of brackets containing an expression followed "
"by a :keyword:`!for` clause, then zero or more :keyword:`!for` or :keyword:`!"
"if` clauses.  The result will be a new list resulting from evaluating the "
"expression in the context of the :keyword:`!for` and :keyword:`!if` clauses "
"which follow it. For example, this listcomp combines the elements of two "
"lists if they are not equal::"
"Um compreensão de lista consiste de um par de colchetes contendo uma "
"expressão seguida de uma cláusula :keyword:`!for`, e então zero ou mais "
"cláusulas :keyword:`!for` ou :keyword:`!if`.  O resultado será uma nova "
"lista resultante da avaliação da expressão no contexto das cláusulas :"
"keyword:`!for` e :keyword:`!if`. Por exemplo, essa compreensão combina os "
"elementos de duas listas se eles forem diferentes::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:228
msgid "and it's equivalent to::"
msgstr "e é equivalente a::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:239
"Note how the order of the :keyword:`for` and :keyword:`if` statements is the "
"same in both these snippets."
"Note como a ordem das instruções :keyword:`for` e :keyword:`if` é a mesma em "
"ambos os trechos."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:242
"If the expression is a tuple (e.g. the ``(x, y)`` in the previous example), "
"it must be parenthesized. ::"
"Se a expressão é uma tupla (ex., ``(x, y)`` no exemplo anterior), ela deve "
"ser inserida entre parênteses. ::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:273
"List comprehensions can contain complex expressions and nested functions::"
"Compreensões de lista podem conter expressões complexas e funções aninhadas::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:280
msgid "Nested List Comprehensions"
msgstr "Compreensões de lista aninhadas"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:282
"The initial expression in a list comprehension can be any arbitrary "
"expression, including another list comprehension."
"A expressão inicial em uma list comprehension pode ser qualquer expressão "
"arbitrária, incluindo outra list comprehension."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:285
"Consider the following example of a 3x4 matrix implemented as a list of 3 "
"lists of length 4::"
"Observe este exemplo de uma matriz 3x4 implementada como uma lista de 3 "
"listas de comprimento 4::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:294
msgid "The following list comprehension will transpose rows and columns::"
msgstr "A compreensão de listas abaixo transpõe as linhas e colunas::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:299
"As we saw in the previous section, the nested listcomp is evaluated in the "
"context of the :keyword:`for` that follows it, so this example is equivalent "
"Como vimos na seção anterior, a compreensão de lista aninhada é computada no "
"contexto da cláusula :keyword:`for` seguinte, portanto o exemplo acima "
"equivale a::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:310
msgid "which, in turn, is the same as::"
msgstr "e isso, por sua vez, faz o mesmo que isto::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:323
"In the real world, you should prefer built-in functions to complex flow "
"statements. The :func:`zip` function would do a great job for this use case::"
"Na prática, você deve dar preferência a funções embutidas em vez de "
"expressões complexas. A função :func:`zip` resolve muito bem este caso de "
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:329
"See :ref:`tut-unpacking-arguments` for details on the asterisk in this line."
"Veja :ref:`tut-unpacking-arguments` para entender o uso do asterisco neste "
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:334
msgid "The :keyword:`!del` statement"
msgstr "A instrução :keyword:`!del`"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:336
"There is a way to remove an item from a list given its index instead of its "
"value: the :keyword:`del` statement.  This differs from the :meth:`pop` "
"method which returns a value.  The :keyword:`!del` statement can also be "
"used to remove slices from a list or clear the entire list (which we did "
"earlier by assignment of an empty list to the slice).  For example::"
"Existe uma maneira de remover um item de uma lista usando seu índice no "
"lugar do seu valor: a instrução :keyword:`del`.  Ele difere do método :meth:"
"`pop` que retorna um valor.  A instrução :keyword:`!del` pode também ser "
"utilizada para remover fatias de uma lista ou limpar a lista inteira (que "
"fizemos antes atribuindo uma lista vazia à fatia ``a[:]``).  Por exemplo:: "
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:353
msgid ":keyword:`del` can also be used to delete entire variables::"
":keyword:`del` também pode ser usado para remover totalmente uma variável::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:357
"Referencing the name ``a`` hereafter is an error (at least until another "
"value is assigned to it).  We'll find other uses for :keyword:`del` later."
"Referenciar a variável ``a`` depois de sua remoção constitui erro (pelo "
"menos até que seja feita uma nova atribuição para ela). Encontraremos outros "
"usos para a instrução :keyword:`del` mais tarde."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:364
msgid "Tuples and Sequences"
msgstr "Tuplas e Sequências"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:366
"We saw that lists and strings have many common properties, such as indexing "
"and slicing operations.  They are two examples of *sequence* data types "
"(see :ref:`typesseq`).  Since Python is an evolving language, other sequence "
"data types may be added.  There is also another standard sequence data type: "
"the *tuple*."
"Vimos que listas e strings têm muitas propriedades em comum, como indexação "
"e operações de fatiamento. Elas são dois exemplos de *sequências* (veja :ref:"
"`typesseq`). Como Python é uma linguagem em evolução, outros tipos de "
"sequências podem ser adicionados. Existe ainda um outro tipo de sequência "
"padrão na linguagem: a *tupla*."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:372
"A tuple consists of a number of values separated by commas, for instance::"
"Uma tupla consiste em uma sequência de valores separados por vírgulas, por "
"exemplo::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:394
"As you see, on output tuples are always enclosed in parentheses, so that "
"nested tuples are interpreted correctly; they may be input with or without "
"surrounding parentheses, although often parentheses are necessary anyway (if "
"the tuple is part of a larger expression).  It is not possible to assign to "
"the individual items of a tuple, however it is possible to create tuples "
"which contain mutable objects, such as lists."
"Como você pode ver no trecho acima, na saída do console as tuplas são sempre "
"envolvidas por parênteses, assim tuplas aninhadas podem ser lidas "
"corretamente. Na criação, tuplas podem ser envolvidas ou não por parênteses, "
"desde que o contexto não exija os parênteses (como no caso da tupla dentro "
"de uma expressão maior). Não é possível atribuir itens individuais de uma "
"tupla, contudo é possível criar tuplas que contenham objetos mutáveis, como "
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:401
"Though tuples may seem similar to lists, they are often used in different "
"situations and for different purposes. Tuples are :term:`immutable`, and "
"usually contain a heterogeneous sequence of elements that are accessed via "
"unpacking (see later in this section) or indexing (or even by attribute in "
"the case of :func:`namedtuples <collections.namedtuple>`). Lists are :term:"
"`mutable`, and their elements are usually homogeneous and are accessed by "
"iterating over the list."
"Apesar de tuplas serem similares a listas, elas são frequentemente "
"utilizadas em situações diferentes e com propósitos distintos. Tuplas são :"
"term:`imutáveis <imutável>`, e usualmente contém uma sequência heterogênea "
"de elementos que são acessados via desempacotamento (ver a seguir nessa "
"seção) ou índice (ou mesmo por um atributo no caso de :func:`namedtuples "
"<collections.namedtuple>`). Listas são :term:`mutáveis <mutável>`, e seus "
"elementos geralmente são homogêneos e são acessados iterando sobre a lista."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:409
"A special problem is the construction of tuples containing 0 or 1 items: the "
"syntax has some extra quirks to accommodate these.  Empty tuples are "
"constructed by an empty pair of parentheses; a tuple with one item is "
"constructed by following a value with a comma (it is not sufficient to "
"enclose a single value in parentheses). Ugly, but effective.  For example::"
"Um problema especial é a criação de tuplas contendo 0 ou 1 itens: a sintaxe "
"usa certos truques para acomodar estes casos. Tuplas vazias são construídas "
"por uma par de parênteses vazios; uma tupla unitária é construída por um "
"único valor e uma vírgula entre parênteses (não basta colocar um único valor "
"entre parênteses). Feio, mas funciona. Por exemplo::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:424
"The statement ``t = 12345, 54321, 'hello!'`` is an example of *tuple "
"packing*: the values ``12345``, ``54321`` and ``'hello!'`` are packed "
"together in a tuple. The reverse operation is also possible::"
"A instrução ``t = 12345, 54321, 'bom dia!'`` é um exemplo de *empacotamento "
"de tupla*: os valores ``12345``, ``54321`` e ``'bom dia!'`` são empacotados "
"em uma tupla. A operação inversa também é possível::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:430
"This is called, appropriately enough, *sequence unpacking* and works for any "
"sequence on the right-hand side.  Sequence unpacking requires that there are "
"as many variables on the left side of the equals sign as there are elements "
"in the sequence.  Note that multiple assignment is really just a combination "
"of tuple packing and sequence unpacking."
"Isso é chamado, apropriadamente, de *sequência de desempacotamento* e "
"funciona para qualquer sequência no lado direito. O desempacotamento de "
"sequência requer que haja tantas variáveis no lado esquerdo do sinal de "
"igual, quanto existem de elementos na sequência. Observe que a atribuição "
"múltipla é, na verdade,  apenas uma combinação de empacotamento de tupla e "
"desempacotamento de sequência."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:440
msgid "Sets"
msgstr "Conjuntos"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:442
"Python also includes a data type for *sets*.  A set is an unordered "
"collection with no duplicate elements.  Basic uses include membership "
"testing and eliminating duplicate entries.  Set objects also support "
"mathematical operations like union, intersection, difference, and symmetric "
"difference."
"Python também inclui um tipo de dados para conjuntos, chamado ``set``. Um "
"conjunto é uma coleção desordenada de elementos, sem elementos repetidos. "
"Usos comuns para conjuntos incluem a verificação eficiente da existência de "
"objetos e a eliminação de itens duplicados. Conjuntos também suportam "
"operações matemáticas como união, interseção, diferença e diferença "
"simétrica."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:447
"Curly braces or the :func:`set` function can be used to create sets.  Note: "
"to create an empty set you have to use ``set()``, not ``{}``; the latter "
"creates an empty dictionary, a data structure that we discuss in the next "
"Chaves ou a função :func:`set` podem ser usados para criar conjuntos. Note: "
"para criar um conjunto vazio você precisa usar ``set()``, não ``{}``; este "
"último cria um dicionário vazio, uma estrutura de dados que discutiremos na "
"próxima seção."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:451
msgid "Here is a brief demonstration::"
msgstr "Uma pequena demonstração:"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:476
"Similarly to :ref:`list comprehensions <tut-listcomps>`, set comprehensions "
"are also supported::"
"Da mesma forma que :ref:`compreensão de listas <tut-listcomps>`, "
"compreensões de conjunto também são suportadas::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:487
msgid "Dictionaries"
msgstr "Dicionários"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:489
"Another useful data type built into Python is the *dictionary* (see :ref:"
"`typesmapping`). Dictionaries are sometimes found in other languages as "
"\"associative memories\" or \"associative arrays\".  Unlike sequences, which "
"are indexed by a range of numbers, dictionaries are indexed by *keys*, which "
"can be any immutable type; strings and numbers can always be keys.  Tuples "
"can be used as keys if they contain only strings, numbers, or tuples; if a "
"tuple contains any mutable object either directly or indirectly, it cannot "
"be used as a key. You can't use lists as keys, since lists can be modified "
"in place using index assignments, slice assignments, or methods like :meth:"
"`append` and :meth:`extend`."
"Outra estrutura de dados muito útil embutida em Python é o *dicionário*, "
"cujo tipo é ``dict`` (ver :ref:`typesmapping`). Dicionários são também "
"chamados de “memória associativa” ou “vetor associativo” em outras "
"linguagens. Diferente de sequências que são indexadas por inteiros, "
"dicionários são indexados por chaves (*keys*), que podem ser de qualquer "
"tipo imutável (como strings e inteiros). Tuplas também podem ser chaves se "
"contiverem apenas strings, inteiros ou outras tuplas. Se a tupla contiver, "
"direta ou indiretamente, qualquer valor mutável, não poderá ser chave. "
"Listas não podem ser usadas como chaves porque podem ser modificadas "
"*internamente* pela atribuição em índices ou fatias, e por métodos como :"
"meth:`append` e :meth:`extend`."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:500
"It is best to think of a dictionary as a set of *key: value* pairs, with the "
"requirement that the keys are unique (within one dictionary). A pair of "
"braces creates an empty dictionary: ``{}``. Placing a comma-separated list "
"of key:value pairs within the braces adds initial key:value pairs to the "
"dictionary; this is also the way dictionaries are written on output."
"Um bom modelo mental é imaginar um dicionário como um conjunto não-ordenado "
"de pares *chave: valor*, onde as chaves são únicas em uma dada instância do "
"dicionário. Dicionários são delimitados por chaves: ``{}``, e contém uma "
"lista de pares chave:valor separada por vírgulas. Dessa forma também será "
"exibido o conteúdo de um dicionário no console do Python. O dicionário vazio "
"é ``{}``."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:506
"The main operations on a dictionary are storing a value with some key and "
"extracting the value given the key.  It is also possible to delete a key:"
"value pair with ``del``. If you store using a key that is already in use, "
"the old value associated with that key is forgotten.  It is an error to "
"extract a value using a non-existent key."
"As principais operações em um dicionário são armazenar e recuperar valores a "
"partir de chaves. Também é possível remover um par *chave:valor* com o "
"comando ``del``. Se você armazenar um valor utilizando uma chave já "
"presente, o antigo valor será substituído pelo novo. Se tentar recuperar um "
"valor usando uma chave inexistente, será gerado um erro."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:512
"Performing ``list(d)`` on a dictionary returns a list of all the keys used "
"in the dictionary, in insertion order (if you want it sorted, just use "
"``sorted(d)`` instead). To check whether a single key is in the dictionary, "
"use the :keyword:`in` keyword."
"Executar ``list(d)`` em um dicionário devolve a lista de todas as chaves "
"presentes no dicionário, na ordem de inserção (se desejar ordená-las basta "
"aplicar o a função ``sorted(d)`` à lista devolvida). Para verificar a "
"existência de uma chave, use o operador :keyword:`in`."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:517
msgid "Here is a small example using a dictionary::"
msgstr "A seguir, um exemplo de uso do dicionário:"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:538
"The :func:`dict` constructor builds dictionaries directly from sequences of "
"key-value pairs::"
"O construtor :func:`dict` produz dicionários diretamente de sequências de "
"pares chave-valor::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:544
"In addition, dict comprehensions can be used to create dictionaries from "
"arbitrary key and value expressions::"
"Além disso, os compreensão de dicionários podem ser usadas para criar "
"dicionários a partir de expressões arbitrárias de chave e valor::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:550
"When the keys are simple strings, it is sometimes easier to specify pairs "
"using keyword arguments::"
"Quando chaves são strings simples, é mais fácil especificar os pares usando "
"argumentos nomeados no construtor:"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:560
msgid "Looping Techniques"
msgstr "Técnicas de iteração"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:562
"When looping through dictionaries, the key and corresponding value can be "
"retrieved at the same time using the :meth:`items` method. ::"
"Ao iterar sobre dicionários, a chave e o valor correspondente podem ser "
"obtidos simultaneamente usando o método :meth:`items`. ::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:572
"When looping through a sequence, the position index and corresponding value "
"can be retrieved at the same time using the :func:`enumerate` function. ::"
"Ao iterar sobre sequências, a posição e o valor correspondente podem ser "
"obtidos simultaneamente usando a função :func:`enumerate`. ::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:582
"To loop over two or more sequences at the same time, the entries can be "
"paired with the :func:`zip` function. ::"
"Para percorrer duas ou mais sequências ao mesmo tempo, as entradas podem ser "
"pareadas com a função :func:`zip`. ::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:594
"To loop over a sequence in reverse, first specify the sequence in a forward "
"direction and then call the :func:`reversed` function. ::"
"Para percorrer uma sequência em ordem inversa, chame a função :func:"
"`reversed` com a sequência na ordem original. ::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:606
"To loop over a sequence in sorted order, use the :func:`sorted` function "
"which returns a new sorted list while leaving the source unaltered. ::"
"Para percorrer uma sequência de maneira ordenada, use a função :func:"
"`sorted`, que retorna uma lista ordenada com os itens, mantendo a sequência "
"original inalterada. ::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:618
"It is sometimes tempting to change a list while you are looping over it; "
"however, it is often simpler and safer to create a new list instead. ::"
"Às vezes é tentador alterar uma lista enquanto você itera sobre ela; porém, "
"costuma ser mais simples e seguro criar uma nova lista. ::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:635
msgid "More on Conditions"
msgstr "Mais sobre condições"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:637
"The conditions used in ``while`` and ``if`` statements can contain any "
"operators, not just comparisons."
"As condições de controle usadas em ``while`` e ``if`` podem conter quaisquer "
"operadores, não apenas comparações."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:640
"The comparison operators ``in`` and ``not in`` check whether a value occurs "
"(does not occur) in a sequence.  The operators ``is`` and ``is not`` compare "
"whether two objects are really the same object; this only matters for "
"mutable objects like lists.  All comparison operators have the same "
"priority, which is lower than that of all numerical operators."
"Os operadores de comparação ``in`` e ``not in`` verificam se um valor ocorre "
"(ou não ocorre) em uma dada sequência. Os operadores ``is`` e ``is not`` "
"comparam se dois objetos são na verdade o mesmo objeto; isto só é relevante "
"no contexto de objetos mutáveis, como listas. Todos os operadores de "
"comparação possuem a mesma precedência, que é menor do que a prioridade de "
"todos os operadores numéricos."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:646
"Comparisons can be chained.  For example, ``a < b == c`` tests whether ``a`` "
"is less than ``b`` and moreover ``b`` equals ``c``."
"Comparações podem ser encadeadas: Por exemplo ``a < b == c`` testa se ``a`` "
"é menor que ``b`` e também se ``b`` é igual a ``c``."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:649
"Comparisons may be combined using the Boolean operators ``and`` and ``or``, "
"and the outcome of a comparison (or of any other Boolean expression) may be "
"negated with ``not``.  These have lower priorities than comparison "
"operators; between them, ``not`` has the highest priority and ``or`` the "
"lowest, so that ``A and not B or C`` is equivalent to ``(A and (not B)) or "
"C``. As always, parentheses can be used to express the desired composition."
"Comparações podem ser combinadas através de operadores booleanos ``and`` e "
"``or``, e o resultado de uma comparação (ou de qualquer outra expressão), "
"pode ter seu valor booleano negado através de ``not``. Estes possuem menor "
"prioridade que os demais operadores de comparação. Entre eles, ``not`` é o "
"de maior prioridade e ``or`` o de menor. Dessa forma, a condição ``A and not "
"B or C`` é equivalente a ``(A and (not B)) or C``. Naturalmente, parênteses "
"podem ser usados para expressar o agrupamento desejado."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:656
"The Boolean operators ``and`` and ``or`` are so-called *short-circuit* "
"operators: their arguments are evaluated from left to right, and evaluation "
"stops as soon as the outcome is determined.  For example, if ``A`` and ``C`` "
"are true but ``B`` is false, ``A and B and C`` does not evaluate the "
"expression ``C``.  When used as a general value and not as a Boolean, the "
"return value of a short-circuit operator is the last evaluated argument."
"Os operadores booleanos ``and`` e ``or`` são operadores *short-circuit*: "
"seus argumentos são avaliados da esquerda para a direita, e a avaliação para "
"quando o resultado é determinado. Por exemplo, se ``A`` e ``C`` são "
"expressões verdadeiras, mas ``B`` é falsa, então ``A and B and C`` não chega "
"a avaliar a expressão ``C``. Em geral, quando usado sobre valores genéricos "
"e não como booleanos, o valor do resultado de um operador atalho é o último "
"valor avaliado na expressão."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:663
"It is possible to assign the result of a comparison or other Boolean "
"expression to a variable.  For example, ::"
"É possível atribuir o resultado de uma comparação ou outra expressão "
"booleana para uma variável. Por exemplo::"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:671
"Note that in Python, unlike C, assignment cannot occur inside expressions. C "
"programmers may grumble about this, but it avoids a common class of problems "
"encountered in C programs: typing ``=`` in an expression when ``==`` was "
"intended."
"Observe que em Python, diferente de C, atribuição não pode ocorrer dentro de "
"uma expressão. Programadores C podem resmungar, mas isso evita toda uma "
"classe de problemas frequentemente encontrados em programas C: digitar ``=`` "
"numa expressão quando a intenção era ``==``."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:680
msgid "Comparing Sequences and Other Types"
msgstr "Comparando sequências e outros tipos"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:682
"Sequence objects may be compared to other objects with the same sequence "
"type. The comparison uses *lexicographical* ordering: first the first two "
"items are compared, and if they differ this determines the outcome of the "
"comparison; if they are equal, the next two items are compared, and so on, "
"until either sequence is exhausted. If two items to be compared are "
"themselves sequences of the same type, the lexicographical comparison is "
"carried out recursively.  If all items of two sequences compare equal, the "
"sequences are considered equal. If one sequence is an initial sub-sequence "
"of the other, the shorter sequence is the smaller (lesser) one.  "
"Lexicographical ordering for strings uses the Unicode code point number to "
"order individual characters.  Some examples of comparisons between sequences "
"of the same type::"
"Objetos sequência podem ser comparados com outros objetos sequência, desde "
"que o tipo das sequências seja o mesmo. A comparação utiliza a ordem "
"lexicográfica: primeiramente os dois primeiros itens são comparados, e se "
"diferirem isto determinará o resultado da comparação, caso contrário os "
"próximos dois itens serão comparados, e assim por diante até que se tenha "
"exaurido alguma das sequências. Se em uma comparação de itens, os mesmos "
"forem também sequências (aninhadas), então é disparada recursivamente outra "
"comparação lexicográfica. Se todos os itens da sequência forem iguais, então "
"as sequências são ditas iguais. Se uma das sequências é uma subsequência da "
"outra, então a subsequência é a menor. A comparação lexicográfica de strings "
"codificação Unicode para definir a ordenação. Alguns exemplos de comparações "
"entre sequências do mesmo tipo:"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:702
"Note that comparing objects of different types with ``<`` or ``>`` is legal "
"provided that the objects have appropriate comparison methods.  For example, "
"mixed numeric types are compared according to their numeric value, so 0 "
"equals 0.0, etc.  Otherwise, rather than providing an arbitrary ordering, "
"the interpreter will raise a :exc:`TypeError` exception."
"Note que comparar objetos de tipos diferentes com ``<`` ou ``>`` é permitido "
"desde que os objetos possuam os métodos de comparação apropriados.  Por "
"exemplo, tipos numéricos mistos são comparados de acordo com os seus valores "
"numéricos, portanto 0 é igual a 0.0, etc.  Em caso contrário, ao invés de "
"fornecer uma ordenação arbitrária, o interpretador levantará um :exc:"
"`TypeError`."
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:710
msgid "Footnotes"
msgstr "Notas de rodapé"
#: /home/runner/work/python-docs-tx-translations/python-docs-tx-translations/cpython/Doc/tutorial/datastructures.rst:711
"Other languages may return the mutated object, which allows method chaining, "
"such as ``d->insert(\"a\")->remove(\"b\")->sort();``."
"Outras linguagens podem retornar o objeto modificado, o que permite "
"encadeamento de métodos, como ``d->insert(\"a\")->remove(\"b\")->sort();``."
FilesExpand file tree

datastructures.po

Latest commit

History

datastructures.po

File metadata and controls
