dict

เก็บค่าภายใต้คีย์และอ่านด้วยคีย์ คีย์คงลำดับที่เพิ่ม การเขียนคีย์เดิมจะแทนที่ค่าโดยไม่ย้ายตำแหน่งคีย์ แต่ละคีย์มีหนึ่งค่า

รูปแบบคำสั่ง

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

ค่าที่ส่งกลับ

ตัวอย่าง

settings = dict(mode="farm", retries=3)
mode = settings.get("mode")   # คืนค่า farm
keys = settings.keys()

for key in settings:
    text(str(settings[key]))   # คืนค่า None

เมธอด

17 เมธอด

dict.constructor

สร้าง dictionary ว่าง หรือคัดลอกจาก dictionary อื่นหรือแหล่งข้อมูลคู่ (key, value) อาร์กิวเมนต์แบบระบุชื่อจะเพิ่มข้อมูลภายหลังและแทนที่คีย์ที่ตรงกัน ค่าที่ซ้อนอยู่ยังใช้ร่วมกับต้นทาง

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
mapping_or_pairsdict | Iterable
dict หรือแหล่งข้อมูลที่วนอ่านได้ โดยแต่ละรายการต้องเป็น list หรือ tuple ที่มีสองส่วนพอดี: คีย์และค่า
ขึ้นอยู่กับรูปแบบการเรียก · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: ()
key=valueAny?
ข้อมูลที่เขียนแบบ key=value เพิ่มหลังข้อมูลจากต้นทาง และแทนที่ค่าของคีย์ที่ตรงกัน
ไม่บังคับ · จำนวนอาร์กิวเมนต์ยืดหยุ่น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

dict — พจนานุกรมที่ไม่แน่นอนใหม่

ตัวอย่าง

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

dict.literal

สร้าง dictionary โดยเขียนคู่ key: value ในวงเล็บปีกกา หากคีย์ซ้ำจะใช้ค่าสุดท้าย

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
keyAny
คีย์ที่ระบุค่า ใช้ตัวเลข สตริง และ tuple ของคีย์ที่ใช้ได้ แต่ใช้ list, dictionary หรือ set ไม่ได้ True, 1 และ 1.0 ระบุคีย์เดียวกัน
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
valueAny?
Value stored for that key.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

dict — พจนานุกรมใหม่ที่รักษาลำดับรายการตามตัวอักษร

ตัวอย่าง

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

dict.comprehension

สร้าง dictionary จากคู่ key: value ที่คำนวณขณะวนลูปผ่านแหล่งข้อมูล คีย์ซ้ำจะแทนที่ค่าก่อนหน้า ใช้ if เพื่อกรองรายการ และใช้ for/if ได้หลายชุด ตัวแปรลูปอยู่เฉพาะในนิพจน์นี้

รูปแบบคำสั่ง

{key: value for target in iterable if condition}

พารามิเตอร์

ชื่อคำอธิบาย
keyAny
dict key calculated for each accepted item.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
valueAny?
Value stored for that key.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
targetName | destructuring target
ตัวแปรหรือกลุ่มตัวแปรที่รับรายการปัจจุบัน ไม่รองรับตัวรับแบบ *rest
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
iterableIterable
แหล่งข้อมูลที่วนลูปได้ เช่น สตริง คอลเลกชัน หรือ generator หากเป็น dictionary จะได้คีย์
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
conditionBoolean
Optional filter checked before storing an entry.
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: True

ค่าที่ส่งกลับ

dict — พจนานุกรมที่ไม่แน่นอนใหม่

ตัวอย่าง

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

dict.key_access

อ่านค่าที่เก็บภายใต้ key หากไม่มีคีย์จะแจ้ง KeyError ใช้ get() เมื่อต้องการค่าปริยาย

รูปแบบคำสั่ง

dictionary["key"]

พารามิเตอร์

ชื่อคำอธิบาย
dictionarydict
The source dictionary.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
keyAny
Key to look up.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Any? — ค่าที่เก็บ ซึ่งอาจเป็น None หากไม่มีคีย์จะแจ้ง KeyError

ตัวอย่าง

settings = {"mode": "farm", "retries": 3}
mode = settings["mode"]        # คืนค่า farm
missing = settings.get("unknown")  # คืนค่า None

dict.key_assignment

เขียนหรือแทนที่รายการคีย์/ค่าหนึ่งรายการด้วยไวยากรณ์การกำหนดวงเล็บเหลี่ยม

รูปแบบคำสั่ง

dictionary[key] = value

พารามิเตอร์

ชื่อคำอธิบาย
dictionarydict
The mutable dictionary to update.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
keyAny
Key to write or replace.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
valueAny?
Value to store for that key.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

None — ไม่มีค่าตอบแทนโดยตรง พจนานุกรมได้รับการอัปเดตแล้ว

ตัวอย่าง

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

dict.length

นับจำนวนคู่คีย์/ค่าในพจนานุกรม

รูปแบบคำสั่ง

len(dictionary, /)

พารามิเตอร์

ชื่อคำอธิบาย
dictionarydict
The dictionary to count.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Int — จำนวนรายการในพจนานุกรม

ตัวอย่าง

settings = {"mode": "farm", "retries": 3}
count = len(settings)          # คืนค่า 2

dict.get_method

อ่านค่าตามคีย์และเลือกที่จะถอยกลับไปเป็นค่าเริ่มต้น

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
keyAny
Key to look up.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
defaultAny?
Fallback value returned when the key is missing.
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: None

ค่าที่ส่งกลับ

Any? — ค่าที่เก็บไว้สำหรับคีย์นั้น หรือค่าเริ่มต้นที่ให้ไว้

ตัวอย่าง

settings = {"mode": "farm"}
mode = settings.get("mode")           # คืนค่า farm
retry = settings.get("retries", 0)    # คืนค่า 0

dict.items_method

คืน view ของ tuple (key, value) ตามลำดับที่เพิ่ม ซึ่งสะท้อนการเปลี่ยนแปลง dictionary ภายหลัง วนลูปผ่าน view หรือแปลงด้วย list() เพื่อใช้ดัชนี

รูปแบบคำสั่ง

dictionary.items()

ค่าที่ส่งกลับ

dict_items — view แบบ dict_items ซึ่งอ่านด้วยดัชนีโดยตรงไม่ได้

ตัวอย่าง

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

dict.pop_method

ลบคีย์และคืนค่าของคีย์นั้น หากไม่มีคีย์ จะคืน default ที่ส่งมาอย่างชัดเจน รวมถึง None หากไม่ส่ง default จะแจ้ง KeyError

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
keyAny
Key to remove.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
defaultAny?
ค่าที่คืนเมื่อไม่มีคีย์ ใช้เฉพาะเมื่อส่งอาร์กิวเมนต์นี้ หากไม่ส่งและไม่มีคีย์จะแจ้ง KeyError
ขึ้นอยู่กับรูปแบบการเรียก · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Any? — ค่าที่ลบ หรือ default ที่ส่งมาอย่างชัดเจนเมื่อไม่มีคีย์

ตัวอย่าง

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

dict.copy_method

คืน dictionary ใหม่ที่มีข้อมูลเดิม การเพิ่ม ลบ หรือแทนที่ข้อมูลไม่เปลี่ยนต้นฉบับ แต่คอลเลกชันที่ซ้อนอยู่ยังใช้ร่วมกัน

รูปแบบคำสั่ง

dictionary.copy()

ค่าที่ส่งกลับ

dict — dict ใหม่ โดยชุดข้อมูลที่ซ้อนอยู่จะไม่ถูกคัดลอก

ตัวอย่าง

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

dict.update_method

เพิ่มข้อมูลลงใน dictionary นี้จาก dictionary อื่นหรือแหล่งข้อมูลคู่ (key, value) แล้วใช้ค่าจากอาร์กิวเมนต์แบบระบุชื่อ คีย์ที่ตรงกันจะถูกแทนที่ค่าโดยไม่ย้ายตำแหน่ง

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
otherdict | Iterable
dict หรือแหล่งข้อมูลที่มี list หรือ tuple สองส่วน ได้แก่คีย์และค่า
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: ()
itemsAny?
ข้อมูลที่เขียนแบบ key=value จะแทนที่ข้อมูลที่มีคีย์ตรงกันจาก other
ไม่บังคับ · จำนวนอาร์กิวเมนต์ยืดหยุ่น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

None — ไม่มีค่าตอบแทนโดยตรง พจนานุกรมได้รับการอัปเดตแล้ว

ตัวอย่าง

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.

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
keyAny
Key to read or create.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
defaultAny?
Value stored when the key is absent.
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: None

ค่าที่ส่งกลับ

Any? — Existing value or inserted default.

ตัวอย่าง

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

dict.keys_method

คืน view ของคีย์ตามลำดับที่เพิ่ม ซึ่งสะท้อนการเปลี่ยนแปลง dictionary ภายหลัง วนลูปผ่าน view หรือแปลงด้วย list() เพื่อใช้ดัชนี

รูปแบบคำสั่ง

dictionary.keys()

ค่าที่ส่งกลับ

dict_keys — view แบบ dict_keys ซึ่งอ่านด้วยดัชนีโดยตรงไม่ได้

ตัวอย่าง

settings = {"mode": "farm", "retries": 3}
keys = settings.keys()
first_key = list(keys)[0]                 # คืนค่า mode

dict.values_method

คืน view ของค่าตามลำดับที่เพิ่มคีย์ ซึ่งสะท้อนการเปลี่ยนแปลง dictionary ภายหลัง วนลูปผ่าน view หรือแปลงด้วย list() เพื่อใช้ดัชนี

รูปแบบคำสั่ง

dictionary.values()

ค่าที่ส่งกลับ

dict_values — view แบบ dict_values ซึ่งอ่านด้วยดัชนีโดยตรงไม่ได้

ตัวอย่าง

settings = {"mode": "farm", "retries": 3}
values = settings.values()
last_value = list(values)[-1]             # คืนค่า 3

dict.clear_method

ลบคู่คีย์/ค่าทุกคู่ออกจากพจนานุกรม

รูปแบบคำสั่ง

dictionary.clear()

ค่าที่ส่งกลับ

None — ไม่มีค่าตอบแทนโดยตรง พจนานุกรมว่างเปล่า

ตัวอย่าง

settings = {"mode": "farm", "retries": 3}
settings.clear()
text(str(len(settings)))   # คืนค่า 0

dict.for_loop

วนลูปผ่านคีย์ dictionary ตามลำดับที่เพิ่ม รวมถึงคีย์ที่เพิ่มหลังสร้าง

รูปแบบคำสั่ง

for key in dictionary:

พารามิเตอร์

ชื่อคำอธิบาย
keyAny
Current key inside the loop.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
dictionarydict
The dictionary to iterate.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

None — ไม่มีค่าตอบแทนโดยตรง การวนซ้ำจะทำงานหนึ่งครั้งต่อคีย์

ตัวอย่าง

settings = {"mode": "farm", "retries": 3}
for key in settings:
    text(str(settings[key]))   # คืนค่า None

dict.truthy_check

ตรวจสอบว่าพจนานุกรมมีอย่างน้อยหนึ่งรายการหรือไม่ พจนานุกรมเปล่าจะถือเป็นเท็จ

รูปแบบคำสั่ง

if dictionary | if not dictionary

พารามิเตอร์

ชื่อคำอธิบาย
dictionarydict
The dictionary used in the condition.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Boolean condition — จริงเมื่อพจนานุกรมไม่ว่างเปล่า เป็นเท็จ เมื่อพจนานุกรมว่างเปล่า

ตัวอย่าง

settings = {}
if not settings:
    text("No settings")       # คืนค่า None