dikte

Sorun bildir Kaynağı göster Nightly · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

dict, ilişkisel eşlemeyi veya sözlüğü temsil eden yerleşik bir türdür. Sözlükler, d[k] kullanarak dizine ekleme ve k in d kullanarak anahtar üyeliği test etme işlemlerini destekler. Her iki işlem de sabit bir süre alır. Dondurulmamış sözlükler değiştirilebilirdir ve d[k] değerine atanarak veya belirli yöntemler çağrılarak güncellenebilir. Sözlükler iterlenebilirdir; iterasyon, kampanya siparişindeki anahtarların sırasını verir. Mevcut bir anahtarla ilişkili değerin güncellenmesi, iterasyon sırasını etkilemez ancak bir anahtarın kaldırılıp yeniden eklenmesi iterasyon sırasını etkiler. 

d = {0: 0, 2: 2, 1: 1}
[k for k in d]  # [0, 2, 1]
d.pop(2)
d[0], d[2] = "a", "b"
0 in d, "a" in d  # (True, False)
[(k, v) for k, v in d.items()]  # [(0, "a"), (1, 1), (2, "b")]

Sözlük oluşturmanın dört yolu vardır:

  1. Sözlük ifadesi {k: v, ...}, ifadede göründükleri sırayla eklenen belirtilen anahtar/değer girişlerini içeren yeni bir sözlük oluşturur. İki anahtar ifadesi aynı değeri verirse değerlendirme başarısız olur.
  2. Sözlük kapsamı {k: v for vars in seq}, her anahtar/değer çiftinin döngü iterasyon sırasına göre yerleştirildiği yeni bir sözlük döndürür. Yinelenen öğelere izin verilir: Belirli bir anahtarın ilk eklemesi, anahtarın dizindeki konumunu belirler ve son ekleme, anahtarın ilişkili değerini belirler. 
    {k: v for k, v in (("a", 0), ("b", 1), ("a", 2))}  # {"a": 2, "b": 1}
{i: 2*i for i in range(3)}  # {0: 0, 1: 2, 2: 4}
  3. Yerleşik dict işlevinin çağrılması, belirtilen girişleri içeren bir sözlük döndürür. Bu girişler, adlandırılmış bağımsız değişkenlerden önce bağımsız değişken sırasına göre eklenir. Kapsamlarda olduğu gibi yinelenen anahtarlara izin verilir.
  4. Birleştirme ifadesi x | y, iki mevcut sözlüğü birleştirerek yeni bir sözlük oluşturur. İki sözlüğün ortak bir k anahtarı varsa anahtar için sağ taraftaki sözlüğün değeri (yani y[k]) kazanır. Birleştirme operatörünün |= varyantı, sözlüğü yerinde değiştirir. Örnek:
    d = {"foo": "FOO", "bar": "BAR"} | {"foo": "FOO2", "baz": "BAZ"}
# d == {"foo": "FOO2", "bar": "BAR", "baz": "BAZ"}
d = {"a": 1, "b": 2}
d |= {"b": 3, "c": 4}
# d == {"a": 1, "b": 3, "c": 4}

Üyeler

temizle

None dict.clear()

Sözlükteki tüm öğeleri kaldırın.

get

unknown dict.get(key, default=None)

key sözlükte varsa key değerini, yoksa default değerini döndürür. default belirtilmezse varsayılan olarak None olur. Böylece bu yöntem hiçbir zaman hata vermez.

Parametreler

Parametre Açıklama
key required
Aranacak anahtar.
default default is None
Anahtar bulunamazsa kullanılacak varsayılan değer (None yerine).

items

list dict.items()

Anahtar/değer tuplalarının listesini döndürür:
{2: "a", 4: "b", 1: "c"}.items() == [(2, "a"), (4, "b"), (1, "c")]

anahtarlar

list dict.keys()

Anahtarların listesini döndürür:
{2: "a", 4: "b", 1: "c"}.keys() == [2, 4, 1]

pop

unknown dict.pop(key, default=unbound)

Bir key öğesini dizinden kaldırır ve ilişkili değeri döndürür. Bu anahtara sahip bir giriş bulunamadıysa hiçbir şeyi kaldırmayın ve belirtilen default değerini döndürün; varsayılan değer belirtilmediyse işlem başarısız olur.

Parametreler

Parametre Açıklama
key required
Anahtar.
default default, unbound
değerini alır. Anahtar yoksa varsayılan değerdir.

popitem

tuple dict.popitem()

Sözlükten ilk (key, value) çiftini kaldırıp döndürün. popitem, genellikle küme algoritmalarında kullanıldığı gibi bir sözlük üzerinde yıkıcı bir şekilde iterasyon yapmak için kullanışlıdır. Sözlük boşsa popitem çağrısı başarısız olur.

setdefault

unknown dict.setdefault(key, default=None)

key sözlükteyse değerini döndürür. Aksi takdirde, default değerine sahip bir anahtar ekleyin ve default döndürün. default varsayılan olarak None değerine ayarlanır.

Parametreler

Parametre Açıklama
key required
Anahtar.
default default, None
değerini alır. Anahtar yoksa varsayılan değerdir.

update

None dict.update(pairs=[], **kwargs)

Sözlüğü önce isteğe bağlı konumsal bağımsız değişkenle (pairs), ardından isteğe bağlı anahtar kelime bağımsız değişkenleriyle günceller. Konuma dayalı bağımsız değişken varsa bir sözlük, iteratör veya None olmalıdır. Söz konusu değer bir sözlükse anahtar/değer çiftleri bu sözlüğe eklenir. Yinelenebilir bir değerse her biri eklenecek bir anahtar/değer çifti olarak değerlendirilen bir çift dizisi (veya 2 uzunluğunda başka yinelenebilirler) sağlamalıdır. Her anahtar kelime bağımsız değişkeni name=value, ad/değer çiftinin bu sözlüğe eklenmesine neden olur.

Parametreler

Parametre Açıklama
pairs varsayılan değer []
Bir sözlük veya giriş listesi. Girişler tam olarak iki öğe (anahtar, değer) içeren tupel veya listeler olmalıdır.
kwargs required
Ek girişler sözlüğü.

values

list dict.values()

Değer listesini döndürür:
{2: "a", 4: "b", 1: "c"}.values() == ["a", "b", "c"]