From 52048d3d5ae02deb3b26b31d5326c50d60691f45 Mon Sep 17 00:00:00 2001
From: Ankit Mahato <ankmahato@gmail.com>
Date: Wed, 29 Mar 2023 06:46:18 +0530
Subject: [PATCH] Update dictionary |= operator

---
 README.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/README.md b/README.md
index efde22b..d357fb3 100644
--- a/README.md
+++ b/README.md
@@ -5811,6 +5811,38 @@ In case of common keys between the two operands (dictionaries), the values of th
 
 In the above example, both `d` and `n` shared a common key `yr`. The value corresponding to `yr` in `n` gets priority.
 
+The `|=` (union) augmented assignment operator can be used to update the dictionary with keys and values from another dictionary or an iterable of (key, value) pairs.
+
+``` python
+>>> d = {"book": "Python", "year": 1990}
+>>> dnew = {"author": "Guido"}
+>>> d |= dnew
+>>> d
+{'book': 'Python', 'year': 1990, 'author': 'Guido'}
+```
+
+If both the dictionaries share a common key, then the value corresponding to the key in the right operand is the updated value.
+
+``` python
+>>> d = {"book": "Python", "year": 1990}
+>>> dnew = {"author": "Guido", "year": 2000}
+>>> d |= dnew
+>>> d
+{'book': 'Python', 'year': 2000, 'author': 'Guido'}
+```
+
+In the above example, both `d` and `dnew` shared a common key `year`. The value (`1990`) corresponding to `year` in `d` is updated with the new value.
+
+The `|=` operator also works in case the right operand is an iterable instead of a dictionary as shown in the example below.
+
+``` python
+>>> d = {"book": "Python", "year": 1990}
+>>> inew = [("author", "Guido"), ("year", 2000)]
+>>> d |= inew
+>>> d
+{'book': 'Python', 'year': 2000, 'author': 'Guido'}
+```
+
 ## Traversing a Dictionary
 
 Compared to position based indexing of `list` or `tuple`, dictionaries are indexed based on the key.