2678

I wanted to test if a key exists in a dictionary before updating the value for the key. I wrote the following code:

if 'key1' in dict.keys():
  print "blah"
else:
  print "boo"

I think this is not the best way to accomplish this task. Is there a better way to test for a key in the dictionary?

5
  • 31
    Calling dict.keys() creates a list of keys, according to the documentation docs.python.org/2/library/stdtypes.html#dict.keys but I'd be surprised if this pattern wasn't optimised for, in a serious implementation, to translate to if 'key1' in dict:. Aug 12, 2013 at 8:51
  • 7
    So I finally found out why many of my Python scripts were so slow :) :(. That's because I've been using x in dict.keys() to check for keys. And that happened because the usual way to iterate over keys in Java is for (Type k : dict.keySet()), this habit causing for k in dict.keys() to feel more natural than for k in dict (which should still be fine in terms of performance?), but then checking keys becomes if k in dict.keys() too, which is a problem... Aug 12, 2013 at 8:58
  • 4
    @EvgeniSergeev if k in dict_: tests for presence of k in the KEYS of dict_, so you still don't need dict_.keys(). (This has bit me, as it reads to me like its testing for a value in dict. But it isn't.) Dec 16, 2013 at 23:34
  • 1
    @ToolmakerSteve That's right, but not only do you not need it, it's not a good practice. Dec 17, 2013 at 1:51
  • 26
    Try "key in dict" Jun 26, 2014 at 17:18

16 Answers 16

5339

in tests for the existence of a key in a dict:

d = {"key1": 10, "key2": 23}

if "key1" in d:
    print("this will execute")

if "nonexistent key" in d:
    print("this will not")

Use dict.get() to provide a default value when the key does not exist:

d = {}

for i in range(100):
    key = i % 10
    d[key] = d.get(key, 0) + 1

To provide a default value for every key, either use dict.setdefault() on each assignment:

d = {}

for i in range(100):
    d[i % 10] = d.setdefault(i % 10, 0) + 1    

...or better, use defaultdict from the collections module:

from collections import defaultdict

d = defaultdict(int)

for i in range(100):
    d[i % 10] += 1
9
  • 95
    I usually just use get if I'm going to be pulling the item out of the dictionary anyway. No sense in using in and pulling the item out of the dictionary. Oct 21, 2009 at 19:12
  • 101
    I fully agree. But if you only need to know if a key exists, or you need to distinguish between a case where the key is defined and a case where you are using a default, in is the best way of doing it.
    – Chris B.
    Oct 21, 2009 at 19:16
  • @enkash provided the reference for Python 3. Here is the reference for Python 2.7: dict and dict.get.
    – yaobin
    Jul 23, 2015 at 13:00
  • 62
    get is a bad test if the key is equivalent to "False", like 0 for example. Learned this the hard way :/
    – Sebastien
    Feb 9, 2016 at 21:06
  • 6
    I can't agree that this a complete answer as it doesn't mention that 'try'-'except' will be the fastest when number of key fails is sufficiently small. See this answer below: stackoverflow.com/a/1602945/4376643 Oct 5, 2017 at 1:18
1871

Use key in my_dict directly instead of key in my_dict.keys():

if 'key1' in my_dict:
    print("blah")
else:
    print("boo")

That will be much faster as it uses the dictionary's O(1) hashing as opposed to doing an O(n) linear search on a list of keys.

2
  • 2
    doesn't work on nested values.
    – Mujtaba
    Jun 25, 2022 at 10:32
  • 3
    @Mujtaba nor would dict.keys() (just to clarify)
    – Matt
    Oct 21, 2022 at 16:11
295

You can test for the presence of a key in a dictionary, using the in keyword:

d = {'a': 1, 'b': 2}
'a' in d # <== evaluates to True
'c' in d # <== evaluates to False

A common use for checking the existence of a key in a dictionary before mutating it is to default-initialize the value (e.g. if your values are lists, for example, and you want to ensure that there is an empty list to which you can append when inserting the first value for a key). In cases such as those, you may find the collections.defaultdict() type to be of interest.

In older code, you may also find some uses of has_key(), a deprecated method for checking the existence of keys in dictionaries (just use key_name in dict_name, instead).

0
180

You can shorten your code to this:

if 'key1' in my_dict:
    ...

However, this is at best a cosmetic improvement. Why do you believe this is not the best way?

6
  • 132
    This is much more than a cosmetic improvement. The time to find a key using this method is O(1) whereas calling keys would generate a list and be O(n). Oct 21, 2009 at 19:08
  • 6
    The O(1) does not seem quite right. Are you sure it's not something like O(log n)?
    – spectras
    Aug 22, 2015 at 18:08
  • 17
    It's the complexity of a single dict lookup, which is on average O(1) and at worst O(n). .list() will always be O(n). wiki.python.org/moin/TimeComplexity Oct 28, 2015 at 0:18
  • 3
    this also avoids an extra allocation. (important for making tight loops a bit faster)
    – nurettin
    Dec 9, 2018 at 9:19
  • @JasonBaker Calling .keys only generates a list or takes O(n) time (and memory) in 2.x. In 3.x, it creates a special view object, analogous to 2.x's .iterkeys. However, it still adds unnecessarily complexity and overhead. May 5 at 2:49
99

For additional information on speed execution of the accepted answer's proposed methods (10 million loops):

  • 'key' in mydict elapsed time 1.07 seconds
  • mydict.get('key') elapsed time 1.84 seconds
  • mydefaultdict['key'] elapsed time 1.07 seconds

Therefore using in or defaultdict are recommended against get.

1
  • 12
    totally agree that get's 1.84s is < 1.07*2 ;-P
    – Paul Rigor
    Jun 15, 2017 at 16:59
65

I would recommend using the setdefault method instead. It sounds like it will do everything you want.

>>> d = {'foo':'bar'}
>>> q = d.setdefault('foo','baz') #Do not override the existing key
>>> print q #The value takes what was originally in the dictionary
bar
>>> print d
{'foo': 'bar'}
>>> r = d.setdefault('baz',18) #baz was never in the dictionary
>>> print r #Now r has the value supplied above
18
>>> print d #The dictionary's been updated
{'foo': 'bar', 'baz': 18}
2
  • 11
    What does setdefault have to do with the OP's question?
    – hughdbrown
    Oct 21, 2009 at 19:11
  • 21
    @hughdbrown "I wanted to test if a key exists in a dictionary before updating the value for the key." Sometimes posts include code that generate a flurry of responses to something that's not quite the original goal. To accomplish the goal stated in the first sentence, setdefault is the most effective method, even though it's not a drop-in replacement for the sample code posted. Oct 21, 2009 at 19:14
60

A dictionary in Python has a get('key', default) method. So you can just set a default value in case there isn't any key.

values = {...}
myValue = values.get('Key', None)
1
  • 1
    The get method's second argument is optional and defaults toNone if not included, so values.get('Key', None) is the same as values.get('Key').
    – CodeBiker
    May 24, 2021 at 21:19
56

Using the Python ternary operator:

message = "blah" if 'key1' in my_dict else "booh"
print(message)
51

Use EAFP (easier to ask forgiveness than permission):

try:
   blah = dict["mykey"]
   # key exists in dict
except KeyError:
   # key doesn't exist in dict

See other Stack Overflow posts:

1
  • 21
    Try/except may be more expensive if it's likely that the key often doesn't exist. From the post you referenced: "[I]f you expect that 99 % of the time result will actually contain something iterable, I'd use the try/except approach. It will be faster if exceptions really are exceptional. If result is None more than 50 % of the time, then using if is probably better.[...][A]n if statement always costs you, it's nearly free to set up a try/except block. But when an Exception actually occurs, the cost is much higher." stackoverflow.com/a/1835844/1094092 Aug 19, 2014 at 20:07
32

Check if a given key already exists in a dictionary

To get the idea how to do that we first inspect what methods we can call on dictionary.

Here are the methods:

d={'clear':0, 'copy':1, 'fromkeys':2, 'get':3, 'items':4, 'keys':5, 'pop':6, 'popitem':7, 'setdefault':8, 'update':9, 'values':10}

Python Dictionary clear()        Removes all Items
Python Dictionary copy()         Returns Shallow Copy of a Dictionary
Python Dictionary fromkeys()     Creates dictionary from given sequence
Python Dictionary get()          Returns Value of The Key
Python Dictionary items()        Returns view of dictionary (key, value) pair
Python Dictionary keys()         Returns View Object of All Keys
Python Dictionary pop()          Removes and returns element having given key
Python Dictionary popitem()      Returns & Removes Element From Dictionary
Python Dictionary setdefault()   Inserts Key With a Value if Key is not Present
Python Dictionary update()       Updates the Dictionary
Python Dictionary values()       Returns view of all values in dictionary

The brutal method to check if the key already exists may be the get() method:

d.get("key")

The other two interesting methods items() and keys() sounds like too much of work. So let's examine if get() is the right method for us. We have our dict d:

d= {'clear':0, 'copy':1, 'fromkeys':2, 'get':3, 'items':4, 'keys':5, 'pop':6, 'popitem':7, 'setdefault':8, 'update':9, 'values':10}

Printing shows the key we don't have will return None:

print(d.get('key')) #None
print(d.get('clear')) #0
print(d.get('copy')) #1

We use that to get the information if the key is present or no. But consider this if we create a dict with a single key:None:

d= {'key':None}
print(d.get('key')) #None
print(d.get('key2')) #None

Leading that get() method is not reliable in case some values may be None.

This story should have a happier ending. If we use the in comparator:

print('key' in d) #True
print('key2' in d) #False

We get the correct results.

We may examine the Python byte code:

import dis
dis.dis("'key' in d")
#   1           0 LOAD_CONST               0 ('key')
#               2 LOAD_NAME                0 (d)
#               4 COMPARE_OP               6 (in)
#               6 RETURN_VALUE

dis.dis("d.get('key2')")
#   1           0 LOAD_NAME                0 (d)
#               2 LOAD_METHOD              1 (get)
#               4 LOAD_CONST               0 ('key2')
#               6 CALL_METHOD              1
#               8 RETURN_VALUE

This shows that in compare operator is not just more reliable, but even faster than get().

2
  • .get() can have a second argument for default value, that couldbe used to handle the issue where key:None. example: d.get("key", False)
    – Alex
    Jul 5, 2019 at 9:36
  • .get() is the fastest way. Another option is to assign in a try/except block
    – HCLivess
    Dec 30, 2019 at 20:34
24

The ways in which you can get the results are:

Which is better is dependent on 3 things:

  1. Does the dictionary 'normally has the key' or 'normally does not have the key'.
  2. Do you intend to use conditions like if...else...elseif...else?
  3. How big is dictionary?

Read More: http://paltman.com/try-except-performance-in-python-a-simple-test/

Use of try/block instead of 'in' or 'if':

try:
    my_dict_of_items[key_i_want_to_check]
except KeyError:
    # Do the operation you wanted to do for "key not present in dict".
else:
    # Do the operation you wanted to do with "key present in dict."
0
21

Python 2 only: (and Python 2.7 supports `in` already)

You can use the has_key() method:

if dict.has_key('xyz')==1:
    # Update the value for the key
else:
    pass
2
  • 33
    .has_key() has been deprecated; you should use in as shown in other answers.
    – Brad Koch
    May 11, 2013 at 16:50
  • 13
    BTW, I recommend reading ALL existing answers to an OLD question, before answering it. This answer added nothing, since the suggestion already existed in Michael's answer, from '09. (I don't mean to discourage an attempt to add something useful to a discussion. Keep trying.) Dec 16, 2013 at 23:58
19

Just an FYI adding to Chris. B's (best) answer:

d = defaultdict(int)

Works as well; the reason is that calling int() returns 0 which is what defaultdict does behind the scenes (when constructing a dictionary), hence the name "Factory Function" in the documentation.

1
  • 2
    If you're creating a dictionary of counts, you should be using Counter (assuming Python 2.7). And I used defaultdict(lambda: 0) instead of defaultdict(int) because I think it's clearer what's going on; the reader doesn't need to know you get 0 if you call int() without arguments. YMMV.
    – Chris B.
    Feb 3, 2014 at 19:35
9

A Python dictionary has the method called __contains__. This method will return True if the dictionary has the key, else it returns False.

>>> temp = {}

>>> help(temp.__contains__)

Help on built-in function __contains__:

__contains__(key, /) method of builtins.dict instance
    True if D has a key k, else False.
3
  • 4
    It is very bad practice to call __contains__ directly. The correct way of doing it, is to use in operator, which is the containment check that invokes the __contains__ function. Nov 14, 2017 at 18:21
  • @user1767754 I'm using foo = x['foo'] if x.__contains__('foo') else 'bar'. Any ideas how would might use the in operator as part of this expression?
    – ron_g
    Jan 8, 2019 at 10:03
  • 2
    foo = x['foo'] if 'foo' in x else 'bar' Jul 13, 2019 at 17:11
6

Another way of checking if a key exists using Boolean operators:

d = {'a': 1, 'b':2}
keys = 'abcd'

for k in keys:
    x = (k in d and 'blah') or 'boo'
    print(x)

This returns

>>> blah
>>> blah
>>> boo
>>> boo

Explanation

First, you should know that in Python, 0, None, or objects with zero length evaluate to False. Everything else evaluates to True. Boolean operations are evaluated left to right and return the operand not True or False.

Let's see an example:

>>> 'Some string' or 1/0
'Some string'
>>>

Since 'Some string' evaluates to True, the rest of the or is not evaluated and there is no division by zero error raised.

But if we switch the order 1/0 is evaluated first and raises an exception:

>>> 1/0 or 'Some string'
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ZeroDivisionError: division by zero
>>>

We can use this for pattern for checking if a key exists.

(k in d and 'blah')

does the same as

if k in d:
    'blah'
else:
    False

This already returns the correct result if the key exists, but we want it to print 'boo' when it doesn't. So, we take the result and or it with 'boo'

>>> False or 'boo'
'boo'
>>> 'blah' or 'boo'
'blah'
>>>
4

You can use a for loop to iterate over the dictionary and get the name of key you want to find in the dictionary. After that, check if it exist or not using if condition:

dic = {'first' : 12, 'second' : 123}
for each in dic:
    if each == 'second':
        print('the key exists and the corresponding value can be updated in the dictionary')
2
  • 1
    check over the code because the output for this is it is exist and not exist
    – Hass786123
    Apr 18, 2019 at 18:38
  • 2
    why using a dictionary at all if this is to perform linear search? May 25, 2019 at 6:54

Not the answer you're looking for? Browse other questions tagged or ask your own question.