dict

dict.constructor

Creation Method

Tạo dictionary rỗng, copy mapping hoặc iterable các cặp, hoặc tạo entry từ keyword argument.

Cú pháp

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

Tham số

Tên	Mô tả
`mapping_or_pairsdict \| Iterable`	Mapping hoặc iterable các cặp hai phần tử để copy. Tùy dạng gọi · Chỉ truyền theo vị trí Mặc định: `None`
`key=valueAny?`	Các entry keyword được thêm sau mapping nguồn. 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.

Hành vi / tác động

Tạo dictionary rỗng, copy mapping hoặc iterable các cặp, hoặc tạo entry từ keyword argument.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.literal

Creation Method

Tạo dictionary với giá trị kiểu chuỗi, số, boolean, hoặc object.

Cú pháp

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

Tham số

Tên	Mô tả
`keyString`	Key của dict. 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.

Hành vi / tác động

Tạo dictionary với giá trị kiểu chuỗi, số, boolean, hoặc object.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.comprehension

Creation Method

Tạo dictionary từ iterable và giữ thứ tự thêm key.

Cú pháp

{key: value for target in iterable if condition}

Tham số

Tên	Mô 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`	Target nhận phần tử hiện tại. Chưa hỗ trợ starred target. Bắt buộc · Theo vị trí hoặc tên Không có giá trị mặc định
`iterableIterable`	Nguồn giá trị cần lặp. 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.

Hành vi / tác động

Tạo dictionary từ iterable và giữ thứ tự thêm key. Có thể dùng nhiều mệnh đề for/if.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.key_access

Method

Đọc một giá trị theo key.

Cú pháp

dictionary["key"]

Tham số

Tên	Mô 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ị đã lưu cho key đó, hoặc None nếu không có key.

Hành vi / tác động

Đọc một giá trị theo key. Nếu thiếu key thì trả về None.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.key_assignment

Method

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ên	Mô 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ỗ.

Hành vi / tác động

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.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.length

Method

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

Cú pháp

len(dictionary, /)

Tham số

Tên	Mô 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.

Hành vi / tác động

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

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.get_method

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ên	Mô 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.

Hành vi / tác động

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

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.items_method

Method

Lấy các cặp key/value thành list tuple hai phần tử theo thứ tự thêm.

Cú pháp

dictionary.items()

Tham số

Không có

Giá trị trả về

list — List các tuple (key, value).

Hành vi / tác động

Lấy các cặp key/value thành list tuple hai phần tử theo thứ tự thêm.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.pop_method

Method

Xóa một key và trả về value của key đó, hoặc trả về default khi thiếu.

Cú pháp

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

Tham số

Tên	Mô 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ị dự phòng 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ị đã xóa hoặc default dự phòng.

Hành vi / tác động

Xóa một key và trả về value của key đó, hoặc trả về default khi thiếu.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.copy_method

Method

Sao chép dictionary thành một dict mới có thể cập nhật.

Cú pháp

dictionary.copy()

Tham số

Không có

Giá trị trả về

dict — dict mới có cùng các entry.

Hành vi / tác động

Sao chép dictionary thành một dict mới có thể cập nhật.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.update_method

Method

Cập nhật dict này từ mapping khác, iterable các cặp, và keyword entry.

Cú pháp

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

Tham số

Tên	Mô tả
`otherdict \| Iterable`	Mapping hoặc các cặp cần gộp. Tùy chọn · Chỉ truyền theo vị trí Mặc định: `None`
`itemsAny?`	Các entry keyword cần ghi. 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ỗ.

Hành vi / tác động

Cập nhật dict này từ mapping khác, iterable các cặp, và keyword entry.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.setdefault_method

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ên	Mô 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.

Hành vi / tác động

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

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.keys_method

Method

Lấy các key của dictionary thành một list theo đúng thứ tự đã thêm.

Cú pháp

dictionary.keys()

Tham số

Không có

Giá trị trả về

list — Một list các key.

Hành vi / tác động

Lấy các key của dictionary thành một list theo đúng thứ tự đã thêm.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.values_method

Method

Lấy các value của dictionary thành một list theo đúng thứ tự đã thêm.

Cú pháp

dictionary.values()

Tham số

Không có

Giá trị trả về

list — Một list các value.

Hành vi / tác động

Lấy các value của dictionary thành một list theo đúng thứ tự đã thêm.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.clear_method

Method

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

Cú pháp

dictionary.clear()

Tham số

Không có

Giá trị trả về

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

Hành vi / tác động

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

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.for_loop

Method

Lặp qua các key của dictionary theo đúng thứ tự đã viết trong literal.

Cú pháp

for key in dictionary:

Tham số

Tên	Mô 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.

Hành vi / tác động

Lặp qua các key của dictionary theo đúng thứ tự đã viết trong literal.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

dict.truthy_check

Method

Kiểm tra xem dictionary có ít nhất một phần tử hay không.

Cú pháp

if dictionary | if not dictionary

Tham số

Tên	Mô 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.

Hành vi / tác động

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.

Thực thi

Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

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

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

dict

Cú pháp

Tham số

Giá trị trả về

Hành vi / tác động

Thực thi

Ví dụ

Lỗi / giới hạn

API liên quan

Phương thức

dict.constructor

Cú pháp

Tham số

Giá trị trả về

Hành vi / tác động

Thực thi

Ví dụ

Lỗi / giới hạn

API liên quan

dict.literal

Cú pháp

Tham số

Giá trị trả về

Hành vi / tác động

Thực thi

Ví dụ

Lỗi / giới hạn

API liên quan

dict.comprehension

Cú pháp

Tham số

Giá trị trả về

Hành vi / tác động

Thực thi

Ví dụ

Lỗi / giới hạn

API liên quan

dict.key_access

Cú pháp

Tham số

Giá trị trả về

Hành vi / tác động

Thực thi

Ví dụ

Lỗi / giới hạn

API liên quan

dict.key_assignment

Cú pháp

Tham số

Giá trị trả về

Hành vi / tác động

Thực thi

Ví dụ

Lỗi / giới hạn

API liên quan

dict.length

Cú pháp

Tham số

Giá trị trả về

Hành vi / tác động

Thực thi

Ví dụ

Lỗi / giới hạn

API liên quan

dict.get_method

Cú pháp

Tham số

Giá trị trả về

Hành vi / tác động

Thực thi

Ví dụ

Lỗi / giới hạn

API liên quan

dict.items_method

Cú pháp

Tham số

Giá trị trả về

Hành vi / tác động

Thực thi

Ví dụ