dikte

Sorun bildirme Kaynağı görüntüleme Nightly · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

dict, ilişkisel eşlemeyi veya sözlüğü temsil eden yerleşik bir türdür. Sözlükler, d[k] kullanarak dizine eklemeyi ve k in d kullanarak anahtar üyelik testini 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. Yineleme sırası, mevcut bir anahtarla ilişkili değerin güncellenmesinden etkilenmez ancak bir anahtarın kaldırılıp yeniden eklenmesinden etkilenir.

d = {0: "x", 2: "z", 1: "y"}
[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, "y"), (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ı, adlandırılmış bağımsız değişkenlerden önce konumsal bağımsız değişkenler olacak şekilde bağımsız değişken sırasına göre eklenen belirtilen girişleri içeren bir sözlük döndürür. 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 sağ taraftaki sözlüğün anahtar 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ükteyse key değerini, aksi takdirde 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 sözlükten kaldırır ve ilişkili değeri döndürür. Bu anahtara sahip bir giriş bulunamadıysa hiçbir öğe 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 []
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"]