{"id":25930,"date":"2020-12-13T17:05:30","date_gmt":"2020-12-14T01:05:30","guid":{"rendered":"https:\/\/careerkarma.com\/blog\/?p=25930"},"modified":"2022-07-20T08:35:08","modified_gmt":"2022-07-20T15:35:08","slug":"python-dictionary","status":"publish","type":"post","link":"https:\/\/careerkarma.com\/blog\/python-dictionary\/","title":{"rendered":"Python Dictionary: A Guide for Beginners"},"content":{"rendered":"\n

A Python dictionary stores data in key-value pairs. A key is a label for a value. Dictionaries are declared as a set of keys and values between a pair of curly brackets. The syntax for a key and value is: “key_name”: value.<\/em><\/p>\n\n\n\n

When you take a look at a dictionary (Merriam-Webster\u2019s<\/em>, Oxford<\/em>), what do you notice? It\u2019s a book or list in an app of words and their corresponding definitions and etymology:<\/p>\n\n\n\n

careerkarma<\/strong><\/p>\n\n\n\n

noun<\/strong> ca\u00b7\u200breer\u00b7kar\u00b7ma | \\ k\u0259-\u02c8rir-\u02c8k\u00e4r-m\u0259 \\<\/p>\n\n\n\n

Definition<\/strong><\/p>\n\n\n\n

Definitions go here<\/strong><\/p>\n\n\n\n

Etymology<\/strong><\/p>\n\n\n\n

Etymology and\/or other information goes here<\/strong><\/p>\n\n\n\n

In Python, dictionaries are very similar. A dictionary in Python is a data structure that holds key\/value pairs together to tell us something about the structure. This article takes a look at dictionaries and some of their built-in functions.<\/p>\n\n\n\n

What is a Python Dictionary?<\/h2>\n\n\n\n

A Python dictionary is key-value pairs, separated by commas, and are enclosed in curly braces. Dictionary keys must be string labels. A value can contain any data type, such as a string, an integer, or another dictionary.<\/p>\n\n\n\n

Dictionaries are unordered: if you want to control the order in a dictionary, use a list with square brackets instead<\/p>\n\n\n\n

To create a dictionary, you need to create a variable and set it equal to two curly braces. The variable can be whatever you would like to name it \u2013 in these examples we are naming it \u201cdictionary\u201d.<\/p>\n\n\n\n

dictionary = {}\n \nprint(dictionary)<\/pre><\/div>\n\n\n\n
Here is an example dictionary with some values:<\/p>\n\n\n\n
word = {\n\t"name": "banana",\n\t"definition": "a yellow fruit"\n}<\/pre><\/div>\n\n\n\n
Our dictionary contains two keys and values. “name” and “definition” are keys and the strings that come after them are our values.<\/p>\n\n\n\n
Duplicate keys cannot exist in a dictionary. Each key must have a unique name.<\/p>\n\n\n\n
Python Add to Dictionary<\/h3>\n\n\n\n
Right now, if we were to print this, it would be an empty dictionary. Let\u2019s add some stuff to it:<\/p>\n\n\n\n
dictionary = {}\n \ndictionary["name"] = "Christina"\ndictionary["favorite_animal"] = "cat"\ndictionary["num_pets"] = 1\n \nprint(dictionary)<\/pre><\/div>\n\n\n\n
We use the bracket notation to create the key\/value pairs. Inside the brackets is a string that identifies our dictionary key. What the dictionary key is assigned to is the value of that key.<\/p>\n\n\n\n
We can use the same notation to update the dictionary as well. It\u2019ll just overwrite the previous value.<\/p>\n\n\n\n
Access Items in a Dictionary<\/h3>\n\n\n\n
We use the same notation to access items present in a dictionary.<\/p>\n\n\n\n
dictionary = {}\n \ndictionary["name"] = "Christina"\ndictionary["favorite_animal"] = "cat"\ndictionary["num_pets"] = 1\n \nprint(dictionary["name"])<\/pre><\/div>\n\n\n\n
Using dictionary<\/em>[\u201cname\u201d<\/em>] accesses only the name<\/em> property of the dictionary and prints that in the interpreter.<\/p>\n\n\n\n
You can also use the Python dictionary get() method<\/a> to retrieve an item from a dictionary:<\/p>\n\n\n\n
dictionary = {}\n\ndictionary["name"] = "Christina"\ndictionary["favorite_animal"] = "cat"\ndictionary["num_pets"] = 1\n\nprint(dictionary.get("name"))<\/pre><\/div>\n\n\n\n
This code prints out the value of the “name” key, which is “Christina”.<\/p>\n\n\n\n
Python Remove from Dictionary<\/h3>\n\n\n\n
There are essentially three different ways to remove a key from a dictionary: the individual entry, all the entries, or the entire dictionary.<\/p>\n\n\n\n
The first method removes just the entry. We do that by accessing the key we would like to get rid of using bracket notation: del<\/em> dictionary<\/em>[\u201c<key name>\u201d<\/em>]<\/p>\n\n\n\n
Here\u2019s an example using the del<\/em> statement with the key name to delete the key we have specified:<\/p>\n\n\n\n
dictionary = {}\n \ndictionary["name"] = "Christina"\ndictionary["favorite_animal"] = "cat"\ndictionary["num_pets"] = 1\nprint(dictionary)\n \n# remove entry with key 'name'\ndel dictionary["name"]\nprint(dictionary) # {'favorite_animal': 'cat', 'num_pets': 1}<\/pre><\/div>\n\n\n\n
The second method removes all the entries in the dictionary. We do that with the method dictionary.clear()<\/em>. Remember that this dictionary method is that it merely clears out the dictionary. The instance of the dictionary still remains so it can be used again.<\/p>\n\n\n\n
Here\u2019s an example using the clear()<\/em> method:<\/p>\n\n\n\n
# remove all entries in dict\ndictionary.clear()  \nprint(dictionary) # {}<\/pre><\/div>\n\n\n\n
The last method gets rid of the entire instance of the dictionary. If we try to access the dictionary after it has been deleted, it will throw an error letting you know that it doesn\u2019t exist. Do this by using the del<\/em> keyword: del<\/em> dictionary.<\/em><\/p>\n\n\n\n
Here\u2019s an example using the del<\/em> keyword:<\/p>\n\n\n\n
# delete entire dictionary\ndel dictionary \nprint(dictionary)<\/pre><\/div>\n\n\n\n
Your code will throw KeyError exceptions if you try to access a dictionary item that does not exist using this syntax. You can read about how to solve a KeyError in our Python KeyError guide<\/a>.<\/p>\n\n\n\n
oop Through Dictionary<\/h3>\n\n\n\n
You can use a for\u2026in loop to loop through dictionaries in Python:<\/p>\n\n\n\n
for key in dictionary:\n\tprint(f'{key}: {dictionary[key]}')<\/pre><\/div>\n\n\n\n
Python Dictionary Methods Glossary<\/h2>\n\n\n\n
We’ve prepared a list of functions often used with the Python dictionary data type. This list should help you learn how you can manipulate your dictionaries in your code.<\/p>\n\n\n\n
Dictionary functions:<\/h3>\n\n\n\n
len<\/em>(dictionary1)<\/em>: Gives the total length of the dictionary. This is equal to the number of key-value pairs in the dictionary.<\/p>\n\n\n\n
str<\/em>(dictionary1)<\/em>: Produces a printable string representation of a dictionary. This is comparable to the JavaScript JSON stringify<\/a> method, if you are used to using JavaScript.<\/p>\n\n\n\n
type<\/em>(variable)<\/em>: Returns the type of the passed variable. If the passed variable is a dictionary, it will return a dictionary type.<\/p>\n\n\n\n
Dictionary built-in methods<\/h3>\n\n\n\n
dictionary<\/em>.clear()<\/em>: Removes all elements of dictionary1. Leaves the actual dictionary intact so that it can still be used. It\u2019s just an empty dictionary.<\/p>\n\n\n\n
dictionary<\/em>.copy()<\/em>: Returns a shallow copy of dictionary dict. Does not mutate the original dictionary.<\/p>\n\n\n\n
dictionary<\/em>.fromkeys(set(), value)<\/em>: Creates a new dictionary with the parameters passed into set()<\/em>, and value.<\/p>\n\n\n\n
dictionary<\/em>.get(key, default = None)<\/em><\/a>: For key, returns the value or default if the key is not in the dictionary.<\/p>\n\n\n\n
dictionary<\/em>.has_key(key)<\/em> : Returns true if a key exists in the dictionary and false if otherwise.<\/p>\n\n\n\n
dictionary<\/em>.items()<\/em>: Returns dictionary\u2019s (key, value) tuple pairs in a list (<\/em>[ <\/em>(key1, value1), (key2, value2), etc.])<\/em><\/p>\n\n\n\n
dictionary<\/em>.keys()<\/em><\/a>: Returns a list of keys.<\/p>\n\n\n\n
dictionary<\/em>.pop(\u2018name\u2019)<\/em>: Removes the key\/value pair from the dictionary. The removed item is the pop method\u2019s return value.<\/p>\n\n\n\n
dictionary<\/em>.<\/em>setdefault<\/em>(key, default = None)<\/em>: Similar to get()<\/em>, but it will set dictionary1[key]=default<\/em> if the key does not already exist in the dictionary.<\/p>\n\n\n\n
dictionary<\/em>.update(dictionary2)<\/em> : Merges dictionary2\u2019s key-values pairs with dictionary1.<\/p>\n\n\n\n
dictionary<\/em>.values()<\/em><\/a>: Returns list of dictionary values.<\/p>\n\n\n\n
Use the built-in methods and functions listed above to play with the sample dictionaries outlined below.<\/p>\n\n\n\n
Conclusion<\/h2>\n\n\n\n
A Python dictionary lets you store related values together. Data in a dictionary is stored using key-value pairs. You can add as many key value pairs in a dictionary as you want.<\/p>\n\n\n\n
Python dictionaries can be a little confusing at first, but with time and effort you will be an expert in no time!<\/p>\n\n\n\n
As a challenge, try to declare a dictionary with the following keys and values:<\/p>\n\n\n\n
  • lentil: 3.00<\/li>
  • vegetable: 2.90<\/li>
  • pea: 3.10<\/li><\/ul>\n\n\n\n
    Then, use the bracket notation to print the value of “lentil” to the console. For an extra challenge, delete the value of “pea” from the dictionary. Then, print the dictionary to the console to make sure the value has been deleted.<\/p>\n\n\n\n