CogniTabDokumentasyon ng Script
/

Runtime v2.81 · Na-update noong Set 30, 2026

dict

Collection

Isang koleksyon ng susi/halaga na nagpapanatili ng pagkakasunud-sunod ng pagpapasok at maaaring basahin o i-update sa panahon ng pagpapatupad ng script.

Syntax

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

Mga parameter

Wala

Ibinabalik na halaga

dict

Pagkilos / epekto

Isang koleksyon ng susi/halaga na nagpapanatili ng pagkakasunud-sunod ng pagpapasok at maaaring basahin o i-update sa panahon ng pagpapatupad ng script.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

settings = dict(mode="farm", retries=3)
mode = settings.get("mode")   # nagbabalik ng farm
keys = settings.keys()

for key in settings:
    text(str(settings[key]))   # nagbabalik ng None

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

Wala

Mga method

17 method

dict.constructor

Creation Method

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

Syntax

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

Mga parameter

PangalanPaglalarawan
mapping_or_pairsdict | Iterable
Mapping or iterable of two-item pairs to copy.
Depende sa paraan ng pagtawag · Ayon lang sa posisyon
Default: None
key=valueAny?
Keyword entries to add after the source mapping.
Opsyonal · Nagbabagong dami ng argumento
Walang default

Ibinabalik na halaga

dict — Isang bagong nababagong diksyunaryo.

Pagkilos / epekto

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

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.literal

Creation Method

Gumawa ng diksyunaryo na may string, numero, boolean, o mga halaga ng object.

Syntax

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

Mga parameter

PangalanPaglalarawan
keyString
dict key.
Kailangan · Ayon sa posisyon o pangalan
Walang default
valueAny?
Value stored for that key.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

dict — Isang bagong diksyunaryo na nagpapanatili ng literal na pagkakasunud-sunod ng pagpasok.

Pagkilos / epekto

Gumawa ng diksyunaryo na may string, numero, boolean, o mga halaga ng object.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.comprehension

Creation Method

Bumuo ng diksyunaryo mula sa isang iterable habang pinapanatili ang pagkakasunud-sunod ng pagpapasok.

Syntax

{key: value for target in iterable if condition}

Mga parameter

PangalanPaglalarawan
keyAny
dict key calculated for each accepted item.
Kailangan · Ayon sa posisyon o pangalan
Walang default
valueAny?
Value stored for that key.
Kailangan · Ayon sa posisyon o pangalan
Walang default
targetName | destructuring target
Loop target for the current item. Starred targets are not supported.
Kailangan · Ayon sa posisyon o pangalan
Walang default
iterableIterable
Source values to loop through.
Kailangan · Ayon sa posisyon o pangalan
Walang default
conditionBoolean
Optional filter checked before storing an entry.
Opsyonal · Ayon lang sa posisyon
Default: True

Ibinabalik na halaga

dict — Isang bagong nababagong diksyunaryo.

Pagkilos / epekto

Bumuo ng diksyunaryo mula sa isang iterable habang pinapanatili ang pagkakasunud-sunod ng pagpapasok. Maramihang para/kung ang mga sugnay ay sinusuportahan.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.key_access

Method

Basahin ang isang halaga sa pamamagitan ng susi.

Syntax

dictionary["key"]

Mga parameter

PangalanPaglalarawan
dictionarydict
The source dictionary.
Kailangan · Ayon sa posisyon o pangalan
Walang default
keyAny
Key to look up.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Any? — Ang nakaimbak na halaga para sa key na iyon, o Wala kapag wala ang key.

Pagkilos / epekto

Basahin ang isang halaga sa pamamagitan ng susi. Ang mga nawawalang susi ay nagbabalik Wala.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

settings = {"mode": "farm", "retries": 3}
mode = settings["mode"]        # nagbabalik ng farm
missing = settings["unknown"]  # nagbabalik ng None

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.key_assignment

Method

Sumulat o palitan ang isang key/value entry ng bracket assignment syntax.

Syntax

dictionary[key] = value

Mga parameter

PangalanPaglalarawan
dictionarydict
The mutable dictionary to update.
Kailangan · Ayon sa posisyon o pangalan
Walang default
keyAny
Key to write or replace.
Kailangan · Ayon lang sa posisyon
Walang default
valueAny?
Value to store for that key.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Ang diksyunaryo ay na-update sa lugar.

Pagkilos / epekto

Sumulat o palitan ang isang key/value entry ng bracket assignment syntax.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.length

Method

Bilangin kung ilang key/value pairs ang nasa diksyunaryo.

Syntax

len(dictionary, /)

Mga parameter

PangalanPaglalarawan
dictionarydict
The dictionary to count.
Kailangan · Ayon lang sa posisyon
Walang default

Ibinabalik na halaga

Int — Bilang ng mga entry sa diksyunaryo.

Pagkilos / epekto

Bilangin kung ilang key/value pairs ang nasa diksyunaryo.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

settings = {"mode": "farm", "retries": 3}
count = len(settings)          # nagbabalik ng 2

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.get_method

Method

Magbasa ng value sa pamamagitan ng key at opsyonal na bumalik sa default.

Syntax

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

Mga parameter

PangalanPaglalarawan
keyAny
Key to look up.
Kailangan · Ayon lang sa posisyon
Walang default
defaultAny?
Fallback value returned when the key is missing.
Opsyonal · Ayon lang sa posisyon
Default: None

Ibinabalik na halaga

Any? — Ang nakaimbak na halaga para sa key na iyon, o ang ibinigay na default.

Pagkilos / epekto

Magbasa ng value sa pamamagitan ng key at opsyonal na bumalik sa default.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

settings = {"mode": "farm"}
mode = settings.get("mode")           # nagbabalik ng farm
retry = settings.get("retries", 0)    # nagbabalik ng 0

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.items_method

Method

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

Syntax

dictionary.items()

Mga parameter

Wala

Ibinabalik na halaga

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

Pagkilos / epekto

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

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.pop_method

Method

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

Syntax

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

Mga parameter

PangalanPaglalarawan
keyAny
Key to remove.
Kailangan · Ayon lang sa posisyon
Walang default
defaultAny?
Fallback returned when the key is missing.
Opsyonal · Ayon lang sa posisyon
Default: None

Ibinabalik na halaga

Any? — Removed value or fallback default.

Pagkilos / epekto

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

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.copy_method

Method

Copy the dictionary into a new mutable dictionary.

Syntax

dictionary.copy()

Mga parameter

Wala

Ibinabalik na halaga

dict — A new dictionary with the same entries.

Pagkilos / epekto

Copy the dictionary into a new mutable dictionary.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.update_method

Method

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

Syntax

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

Mga parameter

PangalanPaglalarawan
otherdict | Iterable
Mapping or pairs to merge.
Opsyonal · Ayon lang sa posisyon
Default: None
itemsAny?
Keyword entries to write.
Opsyonal · Nagbabagong dami ng argumento
Walang default

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Ang diksyunaryo ay na-update sa lugar.

Pagkilos / epekto

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

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.setdefault_method

Method

Return an existing value, or store and return the default when the key is missing.

Syntax

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

Mga parameter

PangalanPaglalarawan
keyAny
Key to read or create.
Kailangan · Ayon lang sa posisyon
Walang default
defaultAny?
Value stored when the key is absent.
Opsyonal · Ayon lang sa posisyon
Default: None

Ibinabalik na halaga

Any? — Existing value or inserted default.

Pagkilos / epekto

Return an existing value, or store and return the default when the key is missing.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

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

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.keys_method

Method

Kunin ang mga key ng diksyunaryo bilang isang listahan sa pagkakasunud-sunod ng pagpapasok.

Syntax

dictionary.keys()

Mga parameter

Wala

Ibinabalik na halaga

list — Isang listahan ng mga susi.

Pagkilos / epekto

Kunin ang mga key ng diksyunaryo bilang isang listahan sa pagkakasunud-sunod ng pagpapasok.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

settings = {"mode": "farm", "retries": 3}
keys = settings.keys()
first_key = keys[0]                 # nagbabalik ng mode

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.values_method

Method

Kunin ang mga halaga ng diksyunaryo bilang isang listahan sa pagkakasunud-sunod ng pagpapasok.

Syntax

dictionary.values()

Mga parameter

Wala

Ibinabalik na halaga

list — Isang listahan ng mga halaga.

Pagkilos / epekto

Kunin ang mga halaga ng diksyunaryo bilang isang listahan sa pagkakasunud-sunod ng pagpapasok.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

settings = {"mode": "farm", "retries": 3}
values = settings.values()
last_value = values[-1]             # nagbabalik ng 3

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.clear_method

Method

Alisin ang bawat key/value pair sa diksyunaryo.

Syntax

dictionary.clear()

Mga parameter

Wala

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Ang diksyunaryo ay nagiging walang laman.

Pagkilos / epekto

Alisin ang bawat key/value pair sa diksyunaryo.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

settings = {"mode": "farm", "retries": 3}
settings.clear()
text(str(len(settings)))   # nagbabalik ng 0

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.for_loop

Method

I-loop ang mga key ng diksyunaryo sa parehong pagkakasunud-sunod ng pagkakasulat sa mga ito sa literal.

Syntax

for key in dictionary:

Mga parameter

PangalanPaglalarawan
keyAny
Current key inside the loop.
Kailangan · Ayon sa posisyon o pangalan
Walang default
dictionarydict
The dictionary to iterate.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

None — Walang direktang pagbabalik na halaga. Ang loop ay tumatakbo nang isang beses sa bawat key.

Pagkilos / epekto

I-loop ang mga key ng diksyunaryo sa parehong pagkakasunud-sunod ng pagkakasulat sa mga ito sa literal.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

settings = {"mode": "farm", "retries": 3}
for key in settings:
    text(str(settings[key]))   # nagbabalik ng None

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API

dict.truthy_check

Method

Suriin kung ang diksyunaryo ay may kahit isang entry.

Syntax

if dictionary | if not dictionary

Mga parameter

PangalanPaglalarawan
dictionarydict
The dictionary used in the condition.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Boolean condition — totoo kapag walang laman ang diksyunaryo, mali kapag walang laman.

Pagkilos / epekto

Suriin kung ang diksyunaryo ay may kahit isang entry. Ang isang walang laman na diksyunaryo ay itinuturing na hindi totoo.

Pagpapatakbo

  • Naghihintay matapos: Hindi
  • Kaligtasan ng sabayang paggamit: Gumamit ng hiwalay na object sa bawat flow
  • Sabayang pagpapatakbo: Oo

Tumatakbo ang mga operasyon sa value sa tumawag na flow nang walang sadyang paghihintay sa capture, gesture, o input. Gumawa ng hiwalay na nababagong container at builder sa bawat flow; ang isolation ay hindi garantiya ng synchronization ng shared object.

Halimbawa

settings = {}
if not settings:
    text("No settings")       # nagbabalik ng None

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API