The Ultimate Python Dictionaries Tutorial for Beginners
Tags: python, programming, tutorial
Published: 2021-03-11 14:08:23


*In this short tutorial, let’s learn how to implement data structures with dictionaries for fast data retrieval management.*

Dictionaries are the Python programming language’s way of implementing data structures. A Python dictionary consists of several key-value pairs; each pair maps the key to its associated value.

For example, say you’re a teacher who wants to match students’ names to their grades. You could use a Python dictionary to map the keys (names) to their associated values (grades).

If you need to find a specific student’s grade on an exam, you can access it from your dictionary. This lookup shortcut should save you time over parsing an entire list to find the student’s grade.

This article shows you how to access dictionary values through each value’s key. Before you begin the tutorial, make sure you have the [Anaconda package manager](https://docs.anaconda.com/anaconda/) and [Jupyter Notebook](https://opensource.com/article/18/3/getting-started-jupyter-notebooks) installed on your machine.

![](https://cdn-images-1.medium.com/max/2000/1*XvR7lYGB5rTyoHVbB0-sAQ.jpeg)

**Get the book**: [Data Structures and Algorithims for job interviews](https://leanpub.com/data-structures-algorithms-for-job-interviews)

## 1. Open a new notebook in Jupyter

Begin by opening Jupyter and running it in a tab in your web browser. Then:

 1. Go to **File** in the top-left corner.

 2. Select **New Notebook**, then **Python 3**.

![](https://cdn-images-1.medium.com/max/2000/0*PbfrdXs9dAckr7NP.png)

Your new notebook starts off untitled, but you can rename it anything you’d like. I named mine **OpenSource.com Data Dictionary Tutorial**.

The line number you see in your new Jupyter notebook is where you will write your code. (That is, your input.)

On macOS, you’ll hit **Shift** then **Return** to receive your output. Make sure to do this before creating new line numbers; otherwise, any additional code you write might not run.

## 2. Create a key-value pair

Write the keys and values you wish to access in your dictionary. To start, you’ll need to define what they are in the context of your dictionary:

    **empty_dictionary = {}
    grades = {
        "Kelsey": 87,
        "Finley": 92
    }**

    **one_line = {a: 1, b: 2}**

![](https://cdn-images-1.medium.com/max/2000/0*QMjmktE8hjf6TTQS.png)

This allows the dictionary to associate specific keys with their respective values. Dictionaries store data by name, which allows faster lookup.

## 3. Access a dictionary value by its key

Say you want to find a specific dictionary value; in this case, a specific student’s grade. To start, hit **Insert** then **Insert Cell Below**.

![](https://cdn-images-1.medium.com/max/2000/0*Fbenuw-QDbvlryYs.png)

In your new cell, define the keys and values in your dictionary.

Then, find the value you need by telling your dictionary to print that value’s key. For example, look for a specific student’s name — Kelsey:

    ***# Access data in a dictionary*
    grades = {
        "Kelsey": 87,
        "Finley": 92
    }**

    **print(grades["Kelsey"])
    87**

![](https://cdn-images-1.medium.com/max/2000/0*RZkfkGpaudhjpQUC.png)

Once you’ve asked for Kelsey’s grade (that is, the value you’re trying to find), hit **Shift** (if you’re on macOS), then **Return**.

You see your desired value — Kelsey’s grade — as an output below your cell.

## 4. Update an existing key

What if you realize you added the wrong grade for a student to your dictionary? You can fix it by updating your dictionary to store an additional value.

To start, choose which key you want to update. In this case, say you entered Finley’s grade incorrectly. That is the key you’ll update in this example.

To update Finley’s grade, insert a new cell below, then create a new key-value pair. Tell your cell to print the dictionary, then hit **Shift** and **Return**:

    **grades["Finley"] = 90
    print(grades)**

    **{'Kelsey': 87; "Finley": 90}**

![](https://cdn-images-1.medium.com/max/2000/0*iQLTE1qHVzGuFhQz.png)

The updated dictionary, with Finley’s new grade, appears as your output.

## 5. Add a new key

Say you get a new student’s grade for an exam. You can add that student’s name and grade to your dictionary by adding a new key-value pair.

Insert a new cell below, then add the new student’s name and grade as a key-value pair. Once you’re done, tell your cell to print the dictionary, then hit **Shift** and **Return**:

    **grades["Alex"] = 88
    print(grades)**

    **{'Kelsey': 87, 'Finley': 90, 'Alex': 88}**

![](https://cdn-images-1.medium.com/max/2000/0*WirklQol7re8cEg4.png)

All key-value pairs should appear as output.

## Using dictionaries

Remember that keys and values can be any data type, but it’s rare for them to be [non-primitive types](https://www.datacamp.com/community/tutorials/data-structures-python). Additionally, dictionaries don’t store or structure their content in any specific order. If you need an ordered sequence of items, it’s best to create a list in Python, not a dictionary.

If you’re thinking of using a dictionary, first confirm if your data is structured the right way, i.e., like a phone book. If not, then using a list, tuple, tree, or other data structure might be the best option.

**Additional resources to learn Python:**

[The Complete Python Course: Build 10 Real World OOP Programs](https://click.linksynergy.com/deeplink?id=NcMZU1aTATA&mid=39197&murl=https%3A%2F%2Fwww.udemy.com%2Fcourse%2Fthe-python-pro-course%2F)

[Learn Python Programming Masterclass](https://coursesim.com/course/learn-python-programming-masterclass/)

Reference site: **Lauren Maffeo [**https://opensource.com/article/21/3/dictionary-values-python](https://opensource.com/article/21/3/dictionary-values-python)

---

Other interesting Dev.to Posts: 

- [Taking your JS Skills to the Next Level { with The Most Powerful JS_Tutorial }](https://dev.to/bricourse/taking-your-js-skills-to-the-next-level-with-the-most-powerful-jstutorial-4dkk)
- [Making your Python Debugging Sweeter with some “IceCream” 🍦😉](https://dev.to/bricourse/making-your-python-debugging-sweeter-with-some-icecream-87i)
- [Finally Understanding Javascript Closures like the Pros](https://dev.to/bricourse/finally-understanding-javascript-closures-like-the-pros-3pgd)