Liste, numaralı kutulardan oluşan bir satırsa, Python sözlüğü, etiketli kutulardan oluşan bir dizidir. İstediğiniz şeyi konuma göre değil isme göre sorarsınız, bu nedenle sözlükler JSON verilerinin, yapılandırmanın, önbelleklerin ve Python’un çoğunun arkasında yer alır.

Bu eğitim temel bilgilerle başlıyor ve deneyimli geliştiricilerin her gün kullandığı kalıplara doğru ilerliyor. Tüm örnekleri Python 3.13’te çalıştırdık ve gösterilen çıktı bu çalıştırmadan geliyor.

Sözlük nedir?

Bir sözlük veya dict, anahtarları değerlerle eşleştirir. Her anahtar yalnızca bir kez görünür ve değerler, listeler veya diğer sözlükler dahil olmak üzere herhangi bir şey olabilir.

Python 3.7’den beri sözlükler resmi olarak ekleme sırasını koruyor. Birçok eski öğreticide hâlâ bunları sırasız olarak adlandırılıyor ve bu artık doğru değil. Diğer türlerin daha geniş bir karşılaştırması için Python list vs Tuple vs set konusuna bakın.

Sözlükler karma tablosu kullandığından aramalar hızlıdır. Bir anahtarın kontrol edilmesi, sözlüğün on veya bir milyon öğe içermesi ile hemen hemen aynı süreyi alır; oysa liste büyüdükçe arama işlemi yavaşlar.

Sözlük oluştur

user = {"name": "Asha", "age": 31, "city": "Pune"}

empty = {}
from_keywords = dict(name="Asha", age=31)
from_pairs = dict([("a", 1), ("b", 2)])

Kıvrımlı ayraçlar en yaygın biçimdir. Bir tuzak: {} boş bir küme değil, boş bir sözlük oluşturur. Boş bir küme için set()‘ye ihtiyacınız vardır.

Değerleri güvenle okuyun

Bir değeri okumanın iki yolu vardır ve aradaki fark, bir anahtarın mevcut olmadığı durumlarda önemlidir:

user["name"]                  # 'Asha'
user["email"]                 # KeyError: 'email'

user.get("email")             # None
user.get("email", "not set")  # 'not set'

Anahtarın mevcut olması gerektiğinde köşeli parantez kullanın, böylece eksik bir anahtar yüksek sesle başarısız olur. API yanıtındaki isteğe bağlı bir alan gibi devamsızlığın normal olduğu durumlarda get() kullanın. Bir anahtarı kontrol etmek için değerler yerine anahtarlara bakan in operatörünü kullanın:

"city" in user    # True
"Pune" in user    # False

Ekle, güncelle ve kaldır

Bir anahtara atama, varsa onu günceller, yoksa ekler:

user["age"] = 32
user["email"] = "asha@example.com"
print(user)

# {'name': 'Asha', 'age': 32, 'city': 'Pune', 'email': 'asha@example.com'}

Python öğeleri kaldırmak için çeşitli yollar sunar:

user.pop("city")          # returns 'Pune' and removes it
user.pop("phone", None)   # no error if it is missing
del user["email"]         # removes it, and raises KeyError if missing
user.clear()              # empties the dictionary

Değeri geri istediğinizde pop()‘i kullanın. İkinci argüman olarak bir varsayılanı iletmek, anahtar orada olmadığında bir hatayı önler. popitem() en son eklenen çifti kaldırır ve döndürür.

Bir sözlük üzerinde döngü yap

Döngü doğrudan size anahtarları verir. Hem anahtarları hem de değerleri almak için items() kullanın:

user = {"name": "Asha", "age": 32}

for key, value in user.items():
    print(key, "=", value)

# name = Asha
# age = 32

keys(), values() ve items() kopyalar yerine canlı görüntüleri döndürür, dolayısıyla daha sonraki değişiklikleri yansıtırlar. Bir sözlük üzerinde döngü yaparken anahtar eklemeyin veya çıkarmayın çünkü Python bir RuntimeError değerini yükseltir. Bunu yapmanız gerekiyorsa list(user) üzerinden döngü yapın.

Sözlük yöntemleri hile sayfası

Sözlükleri birleştir

Yaygın bir ihtiyaç, kullanıcı ayarlarını varsayılanların üstüne uygulamaktır. Anahtarlar çarpıştığında sağ taraf kazanır:

defaults = {"theme": "light", "lang": "en"}
saved = {"theme": "dark"}

defaults | saved
{**defaults, **saved}

# Both give: {'theme': 'dark', 'lang': 'en'}

| operatörü Python 3.9 veya daha yeni bir sürüme ihtiyaç duyarken, ** sürümü de eski sürümlerde çalışır. Her ikisi de yeni bir sözlük oluşturur. Buna karşılık, defaults.update(saved) ve defaults |= saved, defaults‘i yerinde değiştirir.

Anlamalar ve sıralama

Sözlük kavramaları, tıpkı liste anlamalarının listeler için yaptığı gibi, okunabilir tek bir satırda yeni bir sözlük oluşturur:

prices = {"pen": 10, "book": 250, "bag": 900}

{k: v for k, v in prices.items() if v > 100}
# {'book': 250, 'bag': 900}

Değere göre sıralamak için sorted()‘ye bir key işlevi iletin. En büyük değere sahip anahtarı bulmak için max() kullanın:

sorted(prices.items(), key=lambda item: item[1], reverse=True)
# [('bag', 900), ('book', 250), ('pen', 10)]

max(prices, key=prices.get)
# 'bag'

Bir sözlüğün sort() yöntemi yoktur ve sorted() çiftlerin bir listesini döndürür. Sözlüğün bu sırayla olmasını istiyorsanız sonucu dict()‘e sarın.

Sayma ve gruplama kalıpları

Sürekli olarak iki görev ortaya çıkıyor. Bunlardan ilki, varsayılan sıfır değeriyle get() kullanarak yapabileceğiniz sayma işlemidir:

words = "to be or not to be".split()

counts = {}
for word in words:
    counts[word] = counts.get(word, 0) + 1

print(counts)
# {'to': 2, 'be': 2, 'or': 1, 'not': 1}

Standart kütüphane bunu Counter ile daha da kısaltır:

from collections import Counter

Counter(words).most_common(2)
# [('to', 2), ('be', 2)]

İkincisi gruplamadır ve defaultdict burada idealdir çünkü sizin için eksik değeri yaratır:

from collections import defaultdict

orders = [("Asha", 1200), ("Ben", 300), ("Asha", 800)]

by_customer = defaultdict(list)
for name, total in orders:
    by_customer[name].append(total)

print(dict(by_customer))
# {'Asha': [1200, 800], 'Ben': [300]}

Bu olmasaydı, eklemeden önce her anahtarın var olup olmadığını kontrol etmeniz gerekirdi. Aynı modeller API verilerini veya günlük satırlarını toplamak için de işe yarar. Bir sözlük boş olduğunda veya bir anahtar eksik olduğunda, Python istisna işleme kılavuzumuzda ortaya çıkan KeyError ile nasıl başa çıkılacağı gösterilmektedir.

İç içe geçmiş veriler ve kopyalama tuzağı

JSON doğrudan iç içe geçmiş sözlüklere ve listelere eşlenir, böylece genellikle anahtarları zincirlersiniz. Zincirleme get(), bir seviyenin eksik olabileceği durumlarda bunu güvende tutar:

response = {"user": {"profile": {"city": "Pune"}}}

response["user"]["profile"]["city"]               # 'Pune'
response.get("user", {}).get("settings", {}).get("theme")   # None

İç içe geçmiş verileri kopyalarken dikkatli olun. copy() yalnızca en üst düzeyi kopyalar, böylece iç sözlükler orijinalle paylaşılmaya devam eder:

settings = {"db": {"host": "localhost"}}

shallow = settings.copy()
shallow["db"]["host"] = "prod"

print(settings["db"]["host"])
# prod

Kopyayı değiştirmek orijinali değiştirdi ve bu kötü bir hata olabilir. Tamamen bağımsız bir kopya elde etmek için copy.deepcopy(settings)‘i kullanın.

Sözlük anahtarı ne olabilir?

Anahtarlar hash edilebilir olmalıdır, bu da genellikle değişmez anlamına gelir. Değişmez değerlerin dizeleri, sayıları ve dizilerinin tümü çalışır. Listeler ve sözlükler şunları yapmaz:

{["a"]: 1}

# TypeError: unhashable type: 'list'

Bunun nedeni, bir anahtarın karmasının, değerinin nerede saklanacağına karar vermesidir. Eğer bir anahtar değişebilseydi Python artık onu bulamazdı. Bileşik anahtara ihtiyacınız varsa {("Pune", 2026): 120} gibi bir tanımlama grubu kullanın.

Yaygın hatalar

• İsteğe bağlı tuşlarda köşeli parantez kullanma. Bir anahtarın bulunmadığı durumlarda get()‘ye ulaşın.
• get()‘nin anahtarın var olduğu anlamına geldiğini varsayarsak. None, eksik veya depolanmış bir None anlamına gelebilir. Fark önemli olduğunda in‘i kullanın.
• Değişken bir varsayılan kullanma. dict.fromkeys(names, []) her tuşa aynı listeyi verir. Bunun yerine bir anlayış kullanın.
• Yineleme sırasında boyut değiştiriliyor. Anahtarların bir kopyası üzerinde döngü yapın.
• Sabit, bilinen alanlar için dict kullanma. A dataclass daha net olabilir ve alan adlarındaki yazım hatalarını yakalar.

Son sözler

Sözlükler biraz pratik yapmayı ödüllendirir. İsteğe bağlı tuşlar için get()‘i, döngüler için items()‘yi ve en yaygın iki iş için Counter ve defaultdict‘ü unutmayın. Alıştırma yapmak için küçük bir JSON dosyası alın ve kayıtlarını saymak ve gruplandırmak için kod yazın. Dilde yeniyseniz, Yeni başlayanlar için Python eğitimimiz ile başlayın.

Sık sorulan sorular

Öğrenmeye devam et