freeCodeCamp/guide/portuguese/python/data-structures/dictionaries/index.md

title	localeTitle
The Python Dict	O Dicionário Python

Um Dicionário (também conhecido como "dict") em Python é um tipo de estrutura de dados interna que pode ser usada para armazenar pares de key-value . Isso permite que você trate um dict como se fosse um banco de dados para armazenar e organizar dados.

O que há de especial nos dicionários é a maneira como eles são implementados. A estrutura tipo mesa de hash facilita a verificação de existência - o que significa que podemos determinar facilmente se uma chave específica está presente no dicionário sem precisar examinar cada elemento. O interpretador Python pode simplesmente ir até a chave de localização e verificar se a chave está lá.

Dicionários podem usar quase todos os tipos de dados arbitrários, como strings, integers, floats, etc., para chaves. No entanto, valores que não são hashable, ou seja, valores contendo listas, dicionários ou outros tipos mutáveis (que são comparados por valor em vez de por identidade de objeto) não podem ser usados como chaves(keys). Os tipos numéricos usados como chaves (keys) obedecem às regras normais de comparação numérica: se dois números forem iguais (como 1 e 1.0 ), eles poderão ser usados de forma intercambiável e proporcional para indexar a mesma entrada do dicionário. Observe, no entanto, que, como os computadores armazenam números de ponto flutuante como aproximações, geralmente é insensato usá-los como chaves de dicionário.

O requisito mais importante de um dicionário é que as chaves(keys) devem ser exclusivas.
Para criar um dicionário vazio, basta usar um par de chaves(keys):

    >>> teams = {} 
    >>> type(teams) 
    >>> <class 'dict'> 

Para criar um dicionário não vazio com alguns valores iniciais, coloque uma lista separada por vírgula de pares de valores-chave:

    >>> teams = {'barcelona': 1875, 'chelsea': 1910} 
    >>> teams 
    {'barcelona': 1875, 'chelsea': 1910} 

É fácil adicionar pares de valores-chave(values-keys) a um dicionário existente:

    >>> teams['santos'] = 1787 
    >>> teams 
    {'chelsea': 1910, 'barcelona': 1875, 'santos': 1787} # Notice the order - Dictionaries are unordered ! 
    >>> # extracting value - Just provide the key 
    ... 
    >>> teams['barcelona'] 
    1875 

O operador del é usado para excluir um par de valores-chave(values-keys) do dicionário. Nos cenários em que uma chave que já está em uso é novamente usada para armazenar valores, o valor antigo associado a essa chave é completamente perdido, pois é substituido pela inclusão. Além disso, lembre-se de que é um erro extrair o valor usando uma chave inexistente.

    >>> del teams['santos'] 
    >>> teams 
    {'chelsea': 1910, 'barcelona': 1875} 
    >>> teams['chelsea'] = 2017 # overwriting 
    >>> teams 
    {'chelsea': 2017, 'barcelona': 1875} 

O operador in com uma palavra-chave pode ser usado para verificar se existe uma chave(key) desejada no dicionário ou não:

    >>> 'sanots' in teams 
    False 
    >>> 'barcelona' in teams 
    True 
    >>> 'chelsea' not in teams 
    False 

keys é um método interno que pode ser usado para obter as chaves(keys) de um determinado dicionário. Para extrair as chaves(keys) presentes em um dicionário como listas:

    >>> club_names = list(teams.keys()) 
    >>> club_names 
    ['chelsea', 'barcelona'] 

Ainda outra maneira de criar dicionário é usando o método dict() :

    >>> players = dict( [('messi','argentina'), ('ronaldo','portugal'), ('kaka','brazil')] ) # sequence of key-value pair is passed 
    >>> players 
    {'ronaldo': 'portugal', 'kaka': 'brazil', 'messi': 'argentina'} 
    >>> 
    >>> # If keys are simple strings, it's quite easier to specify pairs using keyword arguments 
    ... 
    >>> dict( totti = 38, zidane = 43 ) 
    {'zidane': 43, 'totti': 38} 

As compreensões de ditado podem ser usadas também para criar dicionários a partir de expressões arbitrárias de chave(key) e valor(value):

    >>> {x: x**2 for x in (2, 4, 6)} 
    {2: 4, 4: 16, 6: 36} 

Looping no dicionário
Para simplesmente percorrer as chave(keys) no dicionário, em vez das chaves(keys) e valores(values):

    >>> d = {'x': 1, 'y': 2, 'z': 3} 
    >>> for key in d: 
    ...     print(key) # do something 
    ... 
    x 
    y 
    z 

Para repetir a chave(key) e o valor(value), você pode usar o seguinte:
Para Python 2.x:

    >>> for key, item in d.iteritems(): 
    ...     print items 
    ... 
    1 
    2 
    3 

Use items() para o Python 3.x:

    >>> for key, item in d.items(): 
    ...     print(key, items) 
    ... 
    x 1 
    y 2 
    z 3