Python Dictionary items()

The items() method returns a view object that displays a list of dictionary's (key, value) tuple pairs.

Example

marks = {'Physics':67, 'Maths':87}

print(marks.items())
# Output: dict_items([('Physics', 67), ('Maths', 87)])

Syntax of Dictionary items()

The syntax of items() method is:

dictionary.items()

Note: items() method is similar to dictionary's viewitems() method in Python 2.7.


items() Parameters

The items() method doesn't take any parameters.


Return value from items()

The items() method returns a view object that displays a list of a given dictionary's (key, value) tuple pair.


Example 1: Get all items of a dictionary with items()

# random sales dictionary
sales = { 'apple': 2, 'orange': 3, 'grapes': 4 }

print(sales.items())

Output

dict_items([('apple', 2), ('orange', 3), ('grapes', 4)])

Example 2: How items() works when a dictionary is modified?

# random sales dictionary
sales = { 'apple': 2, 'orange': 3, 'grapes': 4 }

items = sales.items()
print('Original items:', items) # delete an item from dictionary
del[sales['apple']]
print('Updated items:', items)

Output

Original items: dict_items([('apple', 2), ('orange', 3), ('grapes', 4)])
Updated items: dict_items([('orange', 3), ('grapes', 4)])

The view object items doesn't itself return a list of sales items but it returns a view of sales's (key, value) pair.

If the list is updated at any time, the changes are reflected on the view object itself, as shown in the above program.

Did you find this article helpful?