dict

Collection

คอลเลกชันคีย์/ค่าที่เก็บลำดับการแทรกและสามารถอ่านหรืออัปเดตได้ระหว่างการเรียกใช้สคริปต์

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

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

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

dict

ตัวอย่าง

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

Creation Method

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

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

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

พารามิเตอร์

ชื่อ	คำอธิบาย
`mapping_or_pairsdict \| Iterable`	Mapping or iterable of two-item pairs to copy. ขึ้นอยู่กับรูปแบบการเรียก · ระบุตามตำแหน่งเท่านั้น ค่าเริ่มต้น: `None`
`key=valueAny?`	Keyword entries to add after the source mapping. ไม่บังคับ · จำนวนอาร์กิวเมนต์ยืดหยุ่น ไม่มีค่าเริ่มต้น

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

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

ตัวอย่าง

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

dict.literal

Creation Method

สร้างพจนานุกรมด้วยค่าสตริง ตัวเลข บูลีน หรืออ็อบเจ็กต์

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

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

พารามิเตอร์

ชื่อ	คำอธิบาย
`keyString`	dict key. จำเป็น · ระบุตามตำแหน่งหรือชื่อ ไม่มีค่าเริ่มต้น
`valueAny?`	Value stored for that key. จำเป็น · ระบุตามตำแหน่งหรือชื่อ ไม่มีค่าเริ่มต้น

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

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

ตัวอย่าง

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

dict.comprehension

Creation Method

สร้างพจนานุกรมจากการทำซ้ำได้ในขณะที่รักษาลำดับการแทรก รองรับหลายคำสั่ง 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`	Loop target for the current item. Starred targets are not supported. จำเป็น · ระบุตามตำแหน่งหรือชื่อ ไม่มีค่าเริ่มต้น
`iterableIterable`	Source values to loop through. จำเป็น · ระบุตามตำแหน่งหรือชื่อ ไม่มีค่าเริ่มต้น
`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

Method

อ่านหนึ่งค่าด้วยคีย์ คีย์ที่หายไปส่งคืนไม่มี

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

dictionary["key"]

พารามิเตอร์

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

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

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

ตัวอย่าง

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

dict.key_assignment

Method

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

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

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

Method

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

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

len(dictionary, /)

พารามิเตอร์

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

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

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

ตัวอย่าง

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

dict.get_method

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

Method

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

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

dictionary.items()

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

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

ตัวอย่าง

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

dict.pop_method

Method

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

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

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

พารามิเตอร์

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

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

Any? — Removed value or fallback default.

ตัวอย่าง

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

dict.copy_method

Method

Copy the dictionary into a new mutable dictionary.

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

dictionary.copy()

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

dict — A new dictionary with the same entries.

ตัวอย่าง

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

dict.update_method

Method

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

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

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

พารามิเตอร์

ชื่อ	คำอธิบาย
`otherdict \| Iterable`	Mapping or pairs to merge. ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น ค่าเริ่มต้น: `None`
`itemsAny?`	Keyword entries to write. ไม่บังคับ · จำนวนอาร์กิวเมนต์ยืดหยุ่น ไม่มีค่าเริ่มต้น

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

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

ตัวอย่าง

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

dict.setdefault_method

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

Method

รับคีย์พจนานุกรมเป็นรายการตามลำดับการแทรก

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

dictionary.keys()

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

list — รายการคีย์

ตัวอย่าง

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

dict.values_method

Method

รับค่าพจนานุกรมเป็นรายการตามลำดับการแทรก

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

dictionary.values()

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

list — รายการค่า

ตัวอย่าง

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

dict.clear_method

Method

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

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

dictionary.clear()

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

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

ตัวอย่าง

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

dict.for_loop

Method

วนซ้ำคีย์พจนานุกรมตามลำดับเดียวกับที่เขียนด้วยตัวอักษร

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

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

Method

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

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

if dictionary | if not dictionary

พารามิเตอร์

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

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

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

ตัวอย่าง

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