dict

Simpan nilai di bawah kunci dan baca berdasarkan kunci. Kunci mempertahankan urutan penambahan; menulis kunci yang sudah ada mengganti nilainya tanpa memindahkan kunci. Setiap kunci memiliki satu nilai.

Sintaks

dict(mapping_or_pairs=(), /, **items)

Nilai yang dikembalikan

Contoh

settings = dict(mode="farm", retries=3)
mode = settings.get("mode")   # mengembalikan farm
keys = settings.keys()

for key in settings:
    text(str(settings[key]))   # mengembalikan None

Metode

17 metode

dict.constructor

Buat dictionary kosong atau salin dictionary lain atau sumber pasangan (key, value). Argumen bernama menambahkan entri setelahnya dan mengganti kunci yang sama. Nilai bersarang tetap dibagi dengan sumber.

Sintaks

dict()
dict(mapping_or_pairs, /)
dict(key=value, ...)

Parameter

NamaDeskripsi
mapping_or_pairsdict | Iterable
dict atau sumber yang dapat diiterasi; setiap item harus berupa list atau tuple dengan tepat dua item: kunci dan nilai.
Bergantung pada bentuk pemanggilan · Hanya posisi
Default: ()
key=valueAny?
Entri berbentuk key=value, ditambahkan setelah sumber; kunci yang sama diganti nilainya.
Opsional · Jumlah argumen fleksibel
Tanpa nilai bawaan

Nilai yang dikembalikan

dict — Kamus baru yang bisa berubah.

Contoh

settings = dict(mode="farm", retries=3)
copied = dict(settings)
from_pairs = dict([("mode", "pvp")])

dict.literal

Buat dictionary dengan menulis pasangan key: value di dalam kurung kurawal. Kunci berulang menyimpan nilai terakhir.

Sintaks

{"mode": "farm", "retries": 3}

Parameter

NamaDeskripsi
keyAny
Kunci yang mengidentifikasi nilai. Angka, string, dan tuple berisi kunci yang valid diperbolehkan; list, dictionary, dan set tidak. True, 1, dan 1.0 menunjuk kunci yang sama.
Wajib · Posisi atau nama
Tanpa nilai bawaan
valueAny?
Value stored for that key.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

dict — Kamus baru yang mempertahankan urutan entri literal.

Contoh

settings = {
    "mode": "farm",
    "retries": 3,
    "enabled": True
}

dict.comprehension

Buat dictionary dari pasangan key: value yang dihitung saat mengulang sumber. Kunci berulang mengganti nilai sebelumnya. Gunakan if untuk menyaring item; beberapa klausa for/if diperbolehkan. Variabel perulangan hanya berlaku dalam ekspresi ini.

Sintaks

{key: value for target in iterable if condition}

Parameter

NamaDeskripsi
keyAny
dict key calculated for each accepted item.
Wajib · Posisi atau nama
Tanpa nilai bawaan
valueAny?
Value stored for that key.
Wajib · Posisi atau nama
Tanpa nilai bawaan
targetName | destructuring target
Variabel atau kelompok variabel yang menerima item saat ini. Target seperti *rest tidak didukung.
Wajib · Posisi atau nama
Tanpa nilai bawaan
iterableIterable
Sumber yang dapat diulang, seperti string, koleksi, atau generator; dictionary menghasilkan kunci-kuncinya.
Wajib · Posisi atau nama
Tanpa nilai bawaan
conditionBoolean
Optional filter checked before storing an entry.
Opsional · Hanya posisi
Default: True

Nilai yang dikembalikan

dict — Kamus baru yang bisa berubah.

Contoh

pairs = [("mode", "farm"), ("retries", 3)]
settings = {key: value for key, value in pairs}

dict.key_access

Baca nilai yang disimpan pada key. Kunci yang tidak ada memunculkan KeyError; gunakan get() untuk memberikan nilai default.

Sintaks

dictionary["key"]

Parameter

NamaDeskripsi
dictionarydict
The source dictionary.
Wajib · Posisi atau nama
Tanpa nilai bawaan
keyAny
Key to look up.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

Any? — Nilai yang disimpan, yang bisa berupa None. Kunci yang tidak ada memunculkan KeyError.

Contoh

settings = {"mode": "farm", "retries": 3}
mode = settings["mode"]        # mengembalikan farm
missing = settings.get("unknown")  # mengembalikan None

dict.key_assignment

Tulis atau ganti satu entri kunci/nilai dengan sintaks penetapan braket.

Sintaks

dictionary[key] = value

Parameter

NamaDeskripsi
dictionarydict
The mutable dictionary to update.
Wajib · Posisi atau nama
Tanpa nilai bawaan
keyAny
Key to write or replace.
Wajib · Hanya posisi
Tanpa nilai bawaan
valueAny?
Value to store for that key.
Wajib · Hanya posisi
Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Kamus diperbarui pada tempatnya.

Contoh

settings = {"mode": "farm"}
settings["mode"] = "pvp"

dict.length

Hitung berapa banyak pasangan kunci/nilai dalam kamus.

Sintaks

len(dictionary, /)

Parameter

NamaDeskripsi
dictionarydict
The dictionary to count.
Wajib · Hanya posisi
Tanpa nilai bawaan

Nilai yang dikembalikan

Int — Jumlah entri dalam kamus.

Contoh

settings = {"mode": "farm", "retries": 3}
count = len(settings)          # mengembalikan 2

dict.get_method

Membaca nilai berdasarkan kunci dan secara opsional kembali ke default.

Sintaks

dictionary.get(key, default=None, /)

Parameter

NamaDeskripsi
keyAny
Key to look up.
Wajib · Hanya posisi
Tanpa nilai bawaan
defaultAny?
Fallback value returned when the key is missing.
Opsional · Hanya posisi
Default: None

Nilai yang dikembalikan

Any? — Nilai yang disimpan untuk kunci tersebut, atau nilai default yang diberikan.

Contoh

settings = {"mode": "farm"}
mode = settings.get("mode")           # mengembalikan farm
retry = settings.get("retries", 0)    # mengembalikan 0

dict.items_method

Kembalikan view langsung dari tuple (key, value) sesuai urutan penambahan. View mencerminkan perubahan dictionary berikutnya. Ulangi view atau konversi dengan list() untuk memakai indeks.

Sintaks

dictionary.items()

Nilai yang dikembalikan

dict_items — View dict_items; tidak dapat diakses langsung dengan indeks.

Contoh

settings = {"mode": "farm"}
pairs = settings.items()

dict.pop_method

Hapus kunci dan kembalikan nilainya. Jika kunci tidak ada, kembalikan default yang diberikan secara eksplisit, termasuk None; tanpa default akan muncul KeyError.

Sintaks

dictionary.pop(key, /)
dictionary.pop(key, default, /)

Parameter

NamaDeskripsi
keyAny
Key to remove.
Wajib · Hanya posisi
Tanpa nilai bawaan
defaultAny?
Nilai yang dikembalikan untuk kunci yang tidak ada hanya jika argumen ini diberikan. Jika dihilangkan, kunci yang tidak ada memunculkan KeyError.
Bergantung pada bentuk pemanggilan · Hanya posisi
Tanpa nilai bawaan

Nilai yang dikembalikan

Any? — Nilai yang dihapus, atau default yang diberikan secara eksplisit jika kunci tidak ada.

Contoh

settings = {"mode": "farm", "retries": 3}
removed = settings.pop("retries")

dict.copy_method

Kembalikan dictionary baru dengan entri yang sama. Menambah, menghapus, atau mengganti entri tidak mengubah aslinya; koleksi bersarang tetap dibagi.

Sintaks

dictionary.copy()

Nilai yang dikembalikan

dict — dict baru; koleksi di dalamnya tidak disalin.

Contoh

settings = {"mode": "farm"}
copied = settings.copy()

dict.update_method

Tambahkan entri ke dictionary ini dari dictionary lain atau sumber pasangan (key, value), lalu terapkan argumen bernama. Kunci yang sama diganti nilainya tanpa mengubah posisinya.

Sintaks

dictionary.update(other=(), /, **items)

Parameter

NamaDeskripsi
otherdict | Iterable
dict atau sumber list atau tuple dua item yang berisi kunci dan nilai.
Opsional · Hanya posisi
Default: ()
itemsAny?
Entri berbentuk key=value; entri ini mengganti entri berkunci sama dari other.
Opsional · Jumlah argumen fleksibel
Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Kamus diperbarui pada tempatnya.

Contoh

settings = {"mode": "farm"}
settings.update([("retries", 3)], mode="pvp")

dict.setdefault_method

Return an existing value, or store and return the default when the key is missing.

Sintaks

dictionary.setdefault(key, default=None, /)

Parameter

NamaDeskripsi
keyAny
Key to read or create.
Wajib · Hanya posisi
Tanpa nilai bawaan
defaultAny?
Value stored when the key is absent.
Opsional · Hanya posisi
Default: None

Nilai yang dikembalikan

Any? — Existing value or inserted default.

Contoh

settings = dict()
mode = settings.setdefault("mode", "farm")

dict.keys_method

Kembalikan view langsung dari kunci sesuai urutan penambahan. View mencerminkan perubahan dictionary berikutnya. Ulangi view atau konversi dengan list() untuk memakai indeks.

Sintaks

dictionary.keys()

Nilai yang dikembalikan

dict_keys — View dict_keys; tidak dapat diakses langsung dengan indeks.

Contoh

settings = {"mode": "farm", "retries": 3}
keys = settings.keys()
first_key = list(keys)[0]                 # mengembalikan mode

dict.values_method

Kembalikan view langsung dari nilai sesuai urutan penambahan kunci. View mencerminkan perubahan dictionary berikutnya. Ulangi view atau konversi dengan list() untuk memakai indeks.

Sintaks

dictionary.values()

Nilai yang dikembalikan

dict_values — View dict_values; tidak dapat diakses langsung dengan indeks.

Contoh

settings = {"mode": "farm", "retries": 3}
values = settings.values()
last_value = list(values)[-1]             # mengembalikan 3

dict.clear_method

Hapus setiap pasangan kunci/nilai dari kamus.

Sintaks

dictionary.clear()

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Kamus menjadi kosong.

Contoh

settings = {"mode": "farm", "retries": 3}
settings.clear()
text(str(len(settings)))   # mengembalikan 0

dict.for_loop

Ulangi kunci dictionary sesuai urutan penambahan, termasuk kunci yang ditambahkan setelah dibuat.

Sintaks

for key in dictionary:

Parameter

NamaDeskripsi
keyAny
Current key inside the loop.
Wajib · Posisi atau nama
Tanpa nilai bawaan
dictionarydict
The dictionary to iterate.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

None — Tidak ada nilai pengembalian langsung. Perulangan berjalan satu kali per kunci.

Contoh

settings = {"mode": "farm", "retries": 3}
for key in settings:
    text(str(settings[key]))   # mengembalikan None

dict.truthy_check

Periksa apakah kamus memiliki setidaknya satu entri. Kamus kosong dianggap salah.

Sintaks

if dictionary | if not dictionary

Parameter

NamaDeskripsi
dictionarydict
The dictionary used in the condition.
Wajib · Posisi atau nama
Tanpa nilai bawaan

Nilai yang dikembalikan

Boolean condition — benar jika kamus tidak kosong, salah jika kamus kosong.

Contoh

settings = {}
if not settings:
    text("No settings")       # mengembalikan None