dict

Lưu giá trị dưới các khóa và đọc bằng khóa. Khóa giữ thứ tự thêm vào; ghi vào khóa đã có sẽ thay giá trị mà không đổi vị trí khóa. Mỗi khóa có một giá trị.

Cú pháp

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

Giá trị trả về

Ví dụ

settings = dict(mode="farm", retries=3)
mode = settings.get("mode")   # trả về farm
keys = settings.keys()

for key in settings:
    text(str(settings[key]))   # trả về None

Phương thức

17 phương thức

dict.constructor

Tạo dictionary rỗng hoặc sao chép dictionary khác hay nguồn các cặp (key, value). Tham số có tên thêm cặp sau đó và thay giá trị của khóa trùng. Giá trị lồng bên trong dùng chung với nguồn.

Cú pháp

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

Tham số

TênMô tả
mapping_or_pairsdict | Iterable
Một dict hoặc nguồn có thể lặp qua; mỗi phần tử phải là list hoặc tuple có đúng hai phần tử: khóa và giá trị.
Tùy dạng gọi · Chỉ truyền theo vị trí
Mặc định: ()
key=valueAny?
Các cặp viết dạng key=value, được thêm sau nguồn; khóa trùng sẽ được thay giá trị.
Tùy chọn · Số lượng đối số linh hoạt
Không có giá trị mặc định

Giá trị trả về

dict — Một dictionary mới có thể cập nhật.

Ví dụ

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

dict.literal

Tạo dictionary bằng các cặp key: value trong ngoặc nhọn. Khóa lặp lại giữ giá trị được viết sau cùng.

Cú pháp

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

Tham số

TênMô tả
keyAny
Khóa xác định giá trị. Cho phép số, chuỗi và tuple chứa khóa hợp lệ; không cho phép list, dictionary hay set. True, 1 và 1.0 xác định cùng một khóa.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
valueAny?
Giá trị được lưu cho key đó.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

dict — dict mới giữ nguyên thứ tự các cặp key/value trong literal.

Ví dụ

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

dict.comprehension

Tạo dictionary từ các cặp key: value tính khi lặp qua nguồn. Khóa trùng thay giá trị trước đó. Dùng if để lọc phần tử; có thể dùng nhiều mệnh đề for/if. Biến vòng lặp chỉ có trong biểu thức này.

Cú pháp

{key: value for target in iterable if condition}

Tham số

TênMô tả
keyAny
Key được tính cho mỗi phần tử đạt điều kiện.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
valueAny?
Giá trị được lưu cho key đó.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
targetName | destructuring target
Biến hoặc nhóm biến nhận phần tử hiện tại. Chưa hỗ trợ cách nhận như *rest.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
iterableIterable
Nguồn có thể lặp qua, như chuỗi, collection hay generator; dictionary cung cấp các khóa.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
conditionBoolean
Bộ lọc tùy chọn, được kiểm tra trước khi lưu entry.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: True

Giá trị trả về

dict — Một dictionary mới có thể cập nhật.

Ví dụ

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

dict.key_access

Đọc giá trị lưu dưới key. Thiếu khóa gây KeyError; dùng get() để cung cấp giá trị mặc định.

Cú pháp

dictionary["key"]

Tham số

TênMô tả
dictionarydict
dict nguồn.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
keyAny
Key cần tra cứu.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Any? — Giá trị được lưu, có thể là None. Thiếu khóa gây KeyError.

Ví dụ

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

dict.key_assignment

Ghi mới hoặc thay thế một cặp key/value bằng cú pháp gán trong ngoặc vuông.

Cú pháp

dictionary[key] = value

Tham số

TênMô tả
dictionarydict
dict có thể cập nhật.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
keyAny
Key cần ghi mới hoặc thay thế.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
valueAny?
Giá trị cần lưu cho key đó.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

None — Không trả về trực tiếp. dict được cập nhật ngay tại chỗ.

Ví dụ

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

dict.length

Đếm xem dictionary có bao nhiêu cặp key/value.

Cú pháp

len(dictionary, /)

Tham số

TênMô tả
dictionarydict
dict cần đếm.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

Int — Số phần tử có trong dictionary.

Ví dụ

settings = {"mode": "farm", "retries": 3}
count = len(settings)          # trả về 2

dict.get_method

Đọc giá trị theo key và có thể dùng giá trị mặc định nếu thiếu key.

Cú pháp

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

Tham số

TênMô tả
keyAny
Key cần tra cứu.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
defaultAny?
Giá trị dự phòng được trả về khi thiếu key.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: None

Giá trị trả về

Any? — Giá trị đã lưu cho key đó, hoặc giá trị mặc định đã truyền vào.

Ví dụ

settings = {"mode": "farm"}
mode = settings.get("mode")           # trả về farm
retry = settings.get("retries", 0)    # trả về 0

dict.items_method

Trả về view các tuple (key, value) theo thứ tự thêm vào, phản ánh cả thay đổi dictionary sau đó. Lặp qua view hoặc chuyển bằng list() để dùng chỉ số.

Cú pháp

dictionary.items()

Giá trị trả về

dict_items — View dict_items; không thể đọc trực tiếp bằng chỉ số.

Ví dụ

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

dict.pop_method

Xóa khóa và trả về giá trị của khóa. Nếu không có khóa, trả về default được truyền rõ, kể cả None; bỏ qua default sẽ gây KeyError.

Cú pháp

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

Tham số

TênMô tả
keyAny
Key cần xóa.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
defaultAny?
Giá trị trả về khi thiếu khóa, chỉ áp dụng khi truyền tham số này. Bỏ qua tham số sẽ gây KeyError nếu thiếu khóa.
Tùy dạng gọi · Chỉ truyền theo vị trí
Không có giá trị mặc định

Giá trị trả về

Any? — Giá trị đã xóa, hoặc default được truyền rõ khi không có khóa.

Ví dụ

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

dict.copy_method

Trả về dictionary mới có cùng các cặp khóa và giá trị. Thêm, xóa hay thay thế cặp trong bản sao không đổi dictionary gốc; collection lồng bên trong vẫn dùng chung.

Cú pháp

dictionary.copy()

Giá trị trả về

dict — Một dict mới; các tập hợp lồng bên trong không được sao chép.

Ví dụ

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

dict.update_method

Thêm cặp vào dictionary này từ dictionary khác hay nguồn các cặp (key, value), rồi áp dụng tham số có tên. Khóa trùng được thay giá trị mà không đổi vị trí.

Cú pháp

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

Tham số

TênMô tả
otherdict | Iterable
Một dict hoặc nguồn các list hay tuple có hai phần tử là khóa và giá trị.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: ()
itemsAny?
Các cặp viết dạng key=value; chúng thay giá trị của khóa trùng từ other.
Tùy chọn · Số lượng đối số linh hoạt
Không có giá trị mặc định

Giá trị trả về

None — Không trả về trực tiếp. dict được cập nhật ngay tại chỗ.

Ví dụ

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

dict.setdefault_method

Trả về value đang có, hoặc lưu rồi trả về default khi thiếu key.

Cú pháp

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

Tham số

TênMô tả
keyAny
Key cần đọc hoặc tạo.
Bắt buộc · Chỉ truyền theo vị trí
Không có giá trị mặc định
defaultAny?
Giá trị được lưu khi chưa có key.
Tùy chọn · Chỉ truyền theo vị trí
Mặc định: None

Giá trị trả về

Any? — Value đang có hoặc default vừa thêm.

Ví dụ

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

dict.keys_method

Trả về view các khóa theo thứ tự thêm vào, phản ánh cả thay đổi dictionary sau đó. Lặp qua view hoặc chuyển bằng list() để dùng chỉ số.

Cú pháp

dictionary.keys()

Giá trị trả về

dict_keys — View dict_keys; không thể đọc trực tiếp bằng chỉ số.

Ví dụ

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

dict.values_method

Trả về view các giá trị theo thứ tự thêm khóa, phản ánh cả thay đổi dictionary sau đó. Lặp qua view hoặc chuyển bằng list() để dùng chỉ số.

Cú pháp

dictionary.values()

Giá trị trả về

dict_values — View dict_values; không thể đọc trực tiếp bằng chỉ số.

Ví dụ

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

dict.clear_method

Xóa toàn bộ cặp key/value trong dictionary.

Cú pháp

dictionary.clear()

Giá trị trả về

None — Không trả về trực tiếp. dict sẽ trở thành rỗng.

Ví dụ

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

dict.for_loop

Lặp qua khóa dictionary theo thứ tự thêm vào, gồm cả khóa được thêm sau khi tạo.

Cú pháp

for key in dictionary:

Tham số

TênMô tả
keyAny
Key hiện tại trong vòng lặp.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
dictionarydict
dict cần lặp.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

None — Không trả về trực tiếp. Vòng lặp chạy một lần cho mỗi key.

Ví dụ

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

dict.truthy_check

Kiểm tra xem dictionary có ít nhất một phần tử hay không. dict rỗng sẽ được xem là false.

Cú pháp

if dictionary | if not dictionary

Tham số

TênMô tả
dictionarydict
dict được dùng trong điều kiện.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định

Giá trị trả về

Boolean condition — true khi dictionary không rỗng, false khi dictionary rỗng.

Ví dụ

settings = {}
if not settings:
    text("No settings")       # trả về None