مفتاح وقيمة
القائمة تصل لعناصرها بالموضع: scores[2]. لكن ماذا يعني الموضع 2؟ في معظم البيانات الحقيقية تريد الوصول بالاسم: سعر "الكتاب"، وعمر "ليلى"، وعاصمة "الأردن". القاموس dict يربط كل مفتاح بـقيمة:
person = {
"name": "ليلى",
"age": 28,
"city": "عمّان",
}
print(person["name"]) # ليلى
print(len(person)) # 3 أزواج
هذا شكل البيانات نفسه الذي تصلك به معظم واجهات الويب بصيغة JSON، فستتعامل مع القواميس في كل مشروع تقريبًا.
القراءة: [] أم get؟
person = {"name": "ليلى", "age": 28}
print(person["name"]) # مفتاح موجود
print(person.get("email")) # None: لا خطأ
print(person.get("email", "غير متوفّر")) # قيمة بديلة
# person["email"] ← KeyError: 'email'
d[key]حين يجب أن يكون المفتاح موجودًا، وغيابه خطأ تريد أن تراه.d.get(key, default)حين يكون المفتاح اختياريًّا.
وللفحص فقط: "email" in person تبحث في المفاتيح لا القيم.
الإضافة والتعديل والحذف
product = {"name": "كتاب", "price": 12}
product["price"] = 10 # مفتاح موجود: تعديل
product["stock"] = 50 # مفتاح جديد: إضافة
product.update({"price": 9, "color": "أزرق"}) # عدّة مفاتيح معًا
removed = product.pop("color") # حذف وإرجاع القيمة
del product["stock"] # حذف بلا إرجاع
print(product, removed)
لا يوجد مفتاح مكرّر: الإسناد لمفتاح موجود يستبدل قيمته. وpop("x", None) تحذف بلا خطأ إن لم يوجد المفتاح.
المرور على القاموس
scores = {"رياضيات": 90, "علوم": 85, "لغة": 95}
for subject in scores: # المفاتيح افتراضيًّا
print(subject)
for subject, mark in scores.items(): # المفتاح والقيمة معًا
print(f"{subject}: {mark}")
print(list(scores.keys()))
print(sum(scores.values()) / len(scores)) # المعدّل: 90.0
print(max(scores, key=scores.get)) # المادة الأعلى: لغة
القواميس تحفظ ترتيب الإضافة (منذ Python 3.7)، فالطباعة والمرور يتبعان الترتيب الذي أدخلت به المفاتيح.
نمط العدّ والتجميع
أكثر استخدام عملي للقواميس: عدّ الأشياء.
text = "تفاح موز تفاح برتقال تفاح موز"
counts = {}
for word in text.split():
counts[word] = counts.get(word, 0) + 1
print(counts)
from collections import Counter
print(Counter(text.split()).most_common(1)) # [('تفاح', 3)]
counts.get(word, 0) + 1: "القيمة الحالية أو صفر، زائد واحد". وحين تحتاجه كثيرًا، Counter من المكتبة القياسية يفعله ومعه most_common.
والتجميع في قوائم:
students = [("سارة", "عمّان"), ("أحمد", "إربد"), ("ليلى", "عمّان")]
by_city = {}
for name, city in students:
by_city.setdefault(city, []).append(name)
print(by_city) # {'عمّان': ['سارة', 'ليلى'], 'إربد': ['أحمد']}
setdefault(city, []) تعيد القائمة الموجودة، أو تنشئ قائمة فارغة وتعيدها إن لم يكن المفتاح موجودًا.
قواميس متداخلة
users = {
"u1": {"name": "أحمد", "roles": ["admin"]},
"u2": {"name": "نور", "roles": []},
}
print(users["u1"]["name"]) # أحمد
print(users["u1"]["roles"][0]) # admin
for uid, info in users.items():
status = "مشرف" if "admin" in info["roles"] else "مستخدم"
print(uid, info["name"], status)
هذا شكل بيانات JSON الحقيقية: قواميس داخلها قوائم داخلها قواميس. اقرأ المسار من اليسار لليمين: "من users، المفتاح u1، ثم roles، ثم العنصر الأول".
ما الذي يصلح مفتاحًا؟
المفاتيح يجب أن تكون غير قابلة للتغيير: نصوص، أرقام، صفوف. القائمة لا تصلح مفتاحًا (TypeError: unhashable type: 'list')، والسبب نفسه كما في المجموعات. أما القيم فأي شيء.
distances = {("عمّان", "إربد"): 85, ("عمّان", "العقبة"): 330}
print(distances[("عمّان", "إربد")]) # صفّ كمفتاح مركّب
بناء قاموس بسطر واحد
prices = {"كتاب": 12, "قلم": 1, "دفتر": 3}
with_vat = {item: round(p * 1.16, 2) for item, p in prices.items()}
cheap = {item: p for item, p in prices.items() if p < 5}
print(with_vat)
print(cheap)
Dict Comprehension، مثل فهم القوائم؛ التفاصيل في درس Comprehensions. ولدمج قاموسين: merged = a | b (Python 3.9+)، والقيم في b تغلب عند تكرار المفتاح.
جرّب بنفسك
📥 المدخلات (input) — قيمة في كل سطر
أخطاء شائعة
d["key"]لمفتاح قد لا يوجد:KeyError. استخدمgetأو افحص بـin."ليلى" in personوانتظار البحث في القيم:inتبحث في المفاتيح. للقيم:in person.values().- تعديل حجم القاموس أثناء المرور عليه (
delداخلfor k in d):RuntimeError: dictionary changed size during iteration. مرّ علىlist(d). - قائمة كمفتاح: حوّلها لصف.
b = aلنسخ قاموس: اسمان لقاموس واحد، كالقوائم. استخدمa.copy().
🎯 التالي: جملة المطابقة (Match): بديل أنيق لسلاسل if الطويلة.