Jika daftar adalah deretan kotak bernomor, kamus Python adalah kumpulan kotak berlabel. Anda menanyakan apa yang Anda inginkan berdasarkan nama, bukan berdasarkan posisi, itulah sebabnya kamus berada di belakang data JSON, konfigurasi, cache, dan sebagian besar Python itu sendiri.

Tutorial ini dimulai dengan dasar-dasar dan beralih ke pola yang digunakan pengembang berpengalaman setiap hari. Kami menjalankan semua contoh di Python 3.13, dan output yang ditampilkan berasal dari proses tersebut.

Apa itu kamus?

Kamus, atau dict, memetakan kunci ke nilai. Setiap kunci hanya muncul satu kali, dan nilai dapat berupa apa saja, termasuk daftar atau kamus lainnya.

Sejak Python 3.7, kamus secara resmi menjaga urutan penyisipan. Banyak tutorial lama yang masih menyebutnya tidak berurutan, dan hal ini tidak lagi benar. Untuk perbandingan yang lebih luas dari tipe lainnya, lihat Daftar Python vs tuple vs set.

Pencarian cepat karena kamus menggunakan tabel hash. Memeriksa kunci memerlukan waktu yang kira-kira sama, baik kamus berisi sepuluh atau satu juta item, sedangkan pencarian daftar menjadi lebih lambat seiring bertambahnya jumlah item.

Buat kamus

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

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

Tanda kurung kurawal adalah bentuk yang paling umum. Satu jebakan: {} membuat kamus kosong, bukan himpunan kosong. Untuk himpunan kosong, Anda memerlukan set().

Baca nilai dengan aman

Ada dua cara untuk membaca suatu nilai, dan perbedaannya menjadi penting ketika kunci mungkin tidak ada:

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

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

Gunakan tanda kurung siku jika kuncinya harus ada, sehingga kunci yang hilang akan gagal dengan keras. Gunakan get() ketika ketidakhadiran adalah hal yang normal, seperti bidang opsional dalam respons API. Untuk memeriksa kunci, gunakan operator in, yang melihat kunci, bukan nilai:

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

Tambahkan, perbarui, dan hapus

Menetapkan kunci akan memperbaruinya jika ada, atau menambahkannya jika tidak:

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

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

Python menawarkan beberapa cara untuk menghapus item:

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

Gunakan pop() bila Anda ingin nilainya kembali. Meneruskan default sebagai argumen kedua akan menghindari kesalahan saat kunci tidak ada. popitem() menghapus dan mengembalikan pasangan yang paling baru ditambahkan.

Ulangi kamus

Perulangan secara langsung memberi Anda kuncinya. Untuk mendapatkan kunci dan nilai, gunakan items():

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

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

# name = Asha
# age = 32

keys(), values() dan items() menampilkan tayangan langsung, bukan salinan, sehingga mencerminkan perubahan selanjutnya. Jangan menambah atau menghapus kunci saat mengulang kamus, karena Python memunculkan RuntimeError. Ulangi list(user) jika Anda perlu melakukan itu.

Lembar contekan metode kamus

Gabungkan kamus

Kebutuhan umum adalah menerapkan pengaturan pengguna di atas default. Ketika kunci berbenturan, pihak kanan menang:

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

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

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

Operator | memerlukan Python 3.9 atau lebih baru, sedangkan versi ** juga berfungsi pada versi yang lebih lama. Keduanya membuat kamus baru. Sebaliknya, defaults.update(saved) dan defaults |= saved mengubah defaults pada tempatnya.

Pemahaman dan penyortiran

Pemahaman kamus membuat kamus baru dalam satu baris yang dapat dibaca, seperti yang dilakukan pemahaman daftar untuk daftar:

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

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

Untuk mengurutkan berdasarkan nilai, teruskan fungsi key ke sorted(). Untuk mencari kunci dengan nilai terbesar, gunakan max():

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

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

Kamus tidak memiliki metode sort(), dan sorted() mengembalikan daftar pasangan. Bungkus hasilnya dalam dict() jika Anda ingin kamus dalam urutan itu.

Pola penghitungan dan pengelompokan

Dua tugas muncul terus-menerus. Yang pertama adalah menghitung, yang dapat Anda lakukan menggunakan get() dengan default nol:

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}

Perpustakaan standar membuat ini lebih pendek dengan Counter:

from collections import Counter

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

Yang kedua adalah pengelompokan, dan defaultdict ideal di sini karena ini menciptakan nilai yang hilang untuk Anda:

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]}

Tanpanya, Anda perlu memeriksa apakah setiap kunci ada sebelum menambahkan. Pola yang sama ini berfungsi dengan baik untuk menggabungkan data API atau baris log. Ketika kamus kosong atau kunci hilang, panduan kami untuk penanganan pengecualian Python menunjukkan cara menangani hasil KeyError.

Data bersarang dan perangkap penyalinan

JSON memetakan langsung ke kamus dan daftar yang disarangkan, sehingga Anda akan sering merangkai kunci. Chaining get() menjaga ini tetap aman ketika suatu level mungkin hilang:

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

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

Berhati-hatilah saat menyalin data yang disarangkan. copy() hanya menduplikasi kamus tingkat atas, sehingga kamus dalam tetap sama dengan kamus aslinya:

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

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

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

Mengubah salinan mengubah aslinya, yang bisa menjadi bug buruk. Gunakan copy.deepcopy(settings) untuk mendapatkan salinan yang sepenuhnya independen.

Apa yang bisa menjadi kunci kamus?

Kunci harus hashable, yang secara umum berarti tidak dapat diubah. String, angka, dan tupel dengan nilai yang tidak dapat diubah semuanya berfungsi. Daftar dan kamus tidak:

{["a"]: 1}

# TypeError: unhashable type: 'list'

Alasannya adalah hash kunci menentukan di mana nilainya disimpan. Jika sebuah kunci dapat berubah, Python tidak lagi dapat menemukannya. Jika Anda memerlukan kunci gabungan, gunakan tuple, seperti {("Pune", 2026): 120}.

Kesalahan umum

• Menggunakan tanda kurung siku pada tombol opsional. Jangkau get() ketika kunci mungkin tidak ada.
• Dengan asumsi get() berarti kuncinya ada. None bisa berarti hilang, atau disimpan None. Gunakan in jika perbedaannya penting.
• Menggunakan default yang bisa diubah. dict.fromkeys(names, []) memberikan setiap kunci daftar yang sama. Gunakan pemahaman sebagai gantinya.
• Mengubah ukuran selama iterasi. Ulangi salinan kunci.
• Menggunakan dikt untuk bidang yang sudah diperbaiki dan diketahui. A dataclass bisa lebih jelas, dan mendeteksi kesalahan ketik pada nama bidang.

Penutup

Kamus menghargai sedikit latihan. Ingat get() untuk kunci opsional, items() untuk loop, dan Counter dan defaultdict untuk dua pekerjaan paling umum. Untuk berlatih, ambil file JSON kecil dan tulis kode untuk menghitung dan mengelompokkan catatannya. Jika Anda baru mengenal bahasa ini, mulailah dengan Tutorial Python untuk pemula kami.

Pertanyaan yang sering diajukan

Teruslah belajar