Runtime v2.81 · Diperbarui 30 Sep 2026

dict

Kumpulan kunci/nilai yang menyimpan urutan penyisipan dan dapat dibaca atau diperbarui selama eksekusi skrip.

Sintaks

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

Parameter

Tidak ada

Nilai yang dikembalikan

dict

Perilaku / efek samping

Kumpulan kunci/nilai yang menyimpan urutan penyisipan dan dapat dibaca atau diperbarui selama eksekusi skrip.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

Tidak ada

Metode

17 metode

dict.constructor

Create an empty dictionary, copy a mapping or iterable of pairs, or build entries from keyword arguments.

Sintaks

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

Parameter

NamaDeskripsi
mapping_or_pairsdict | Iterable
Mapping or iterable of two-item pairs to copy.
Bergantung pada bentuk pemanggilan · Hanya posisi
Default: None
key=valueAny?
Keyword entries to add after the source mapping.
Opsional · Jumlah argumen fleksibel
Tanpa nilai bawaan

Nilai yang dikembalikan

dict — Kamus baru yang bisa berubah.

Perilaku / efek samping

Create an empty dictionary, copy a mapping or iterable of pairs, or build entries from keyword arguments.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

dict.literal

Buat kamus dengan nilai string, angka, boolean, atau objek.

Sintaks

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

Parameter

NamaDeskripsi
keyString
dict key.
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.

Perilaku / efek samping

Buat kamus dengan nilai string, angka, boolean, atau objek.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

dict.comprehension

Bangun kamus dari iterable sambil mempertahankan urutan penyisipan.

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
Loop target for the current item. Starred targets are not supported.
Wajib · Posisi atau nama
Tanpa nilai bawaan
iterableIterable
Source values to loop through.
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.

Perilaku / efek samping

Bangun kamus dari iterable sambil mempertahankan urutan penyisipan. Beberapa klausa for/if didukung.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

dict.key_access

Baca satu nilai demi kunci.

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 untuk kunci tersebut, atau Tidak Ada jika kunci tidak ada.

Perilaku / efek samping

Baca satu nilai demi kunci. Kunci yang hilang akan mengembalikan Tidak Ada.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

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.

Perilaku / efek samping

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

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

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.

Perilaku / efek samping

Hitung berapa banyak pasangan kunci/nilai dalam kamus.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

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.

Perilaku / efek samping

Membaca nilai berdasarkan kunci dan secara opsional kembali ke default.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

dict.items_method

Get key/value pairs as a list of two-item tuples in insertion order.

Sintaks

dictionary.items()

Parameter

Tidak ada

Nilai yang dikembalikan

list — A list of (key, value) tuples.

Perilaku / efek samping

Get key/value pairs as a list of two-item tuples in insertion order.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

dict.pop_method

Remove one key and return its value, or return the default when missing.

Sintaks

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

Parameter

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

Nilai yang dikembalikan

Any? — Removed value or fallback default.

Perilaku / efek samping

Remove one key and return its value, or return the default when missing.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

dict.copy_method

Copy the dictionary into a new mutable dictionary.

Sintaks

dictionary.copy()

Parameter

Tidak ada

Nilai yang dikembalikan

dict — A new dictionary with the same entries.

Perilaku / efek samping

Copy the dictionary into a new mutable dictionary.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

dict.update_method

Update this dictionary from another mapping, pairs iterable, and keyword entries.

Sintaks

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

Parameter

NamaDeskripsi
otherdict | Iterable
Mapping or pairs to merge.
Opsional · Hanya posisi
Default: None
itemsAny?
Keyword entries to write.
Opsional · Jumlah argumen fleksibel
Tanpa nilai bawaan

Nilai yang dikembalikan

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

Perilaku / efek samping

Update this dictionary from another mapping, pairs iterable, and keyword entries.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

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.

Perilaku / efek samping

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

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

dict.keys_method

Dapatkan kunci kamus sebagai daftar dalam urutan penyisipan.

Sintaks

dictionary.keys()

Parameter

Tidak ada

Nilai yang dikembalikan

list — Daftar kunci.

Perilaku / efek samping

Dapatkan kunci kamus sebagai daftar dalam urutan penyisipan.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

dict.values_method

Dapatkan nilai kamus sebagai daftar dalam urutan penyisipan.

Sintaks

dictionary.values()

Parameter

Tidak ada

Nilai yang dikembalikan

list — Daftar nilai.

Perilaku / efek samping

Dapatkan nilai kamus sebagai daftar dalam urutan penyisipan.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

dict.clear_method

Hapus setiap pasangan kunci/nilai dari kamus.

Sintaks

dictionary.clear()

Parameter

Tidak ada

Nilai yang dikembalikan

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

Perilaku / efek samping

Hapus setiap pasangan kunci/nilai dari kamus.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

dict.for_loop

Ulangi kunci kamus dengan urutan yang sama dengan penulisan literalnya.

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.

Perilaku / efek samping

Ulangi kunci kamus dengan urutan yang sama dengan penulisan literalnya.

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait

dict.truthy_check

Periksa apakah kamus memiliki setidaknya satu entri.

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.

Perilaku / efek samping

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

Eksekusi

  • Menunggu selesai: Tidak
  • Keamanan akses bersamaan: Gunakan objek terpisah di tiap alur
  • Eksekusi paralel: Ya

Operasi nilai berjalan dalam alur pemanggil tanpa sengaja menunggu tangkapan layar, gestur selesai, atau masukan pengguna. Buat wadah dan builder yang dapat berubah secara terpisah dalam setiap alur; isolasi bukan jaminan sinkronisasi objek bersama.

Contoh

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

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.

API terkait