对于类型化字典,部分方法的参数类型应根据字典键值类型而变化,GDScript不会在传参时进行类型检查,类型不匹配时会造成预期外的情况
dictionary:要拷贝内容的 Dictionary,可以是普通或类型化字典。
用传入的字典替换(进行浅拷贝)当前字典的内容。如果是类型化字典,会尝试进行必要的类型转换。
清空字典中的所有键值对,相当于让它变成一个新的空字典。
deep:是否进行深拷贝。为true时会递归复制嵌套的Dictionary和Array。
返回该字典的副本,deep模式下嵌套的结构也会一起复制。
一个新的 Dictionary,内容与当前字典相同。
key:要移除的键。
如果存在对应的键,则将该键及其值从字典中删除。
一个布尔值,指示是否成功删除了键值对。
value:要查找的值。
查找第一个关联的值等于value的键
找到的键,如果没有找到则为null。
-
key:要查找的键。 -
default(可选):如果没有找到该键时要返回的默认值。
返回 key对应的值,若键不存在则返回 default。
对应的值或 default值。
-
key:要查找或添加的键。 -
default(可选):如果键不存在,将插入并返回该默认值。
如果 key已存在则返回它的值;否则插入key : default并返回default。
键对应的值或插入的 default。
获取字典的键的类型(用 Variant.Type 的数字表示)。如果不是类型化的,就返回 TYPE_NIL
Variant.Type常量值,表示字典的键的类型
获取键的内置类名;如果键不是对象类型就返回空字符串。
唯一字符串形式的键的类型,如果不是对象类型则返回空字符串
获取键关联的脚本(Script)实例,没有则返回null
键所关联的脚本实例(Script类型),如果不存在则返回null
获取字典的值的类型(用 Variant.Type 的数字表示)。如果不是类型化的,就返回 TYPE_NIL
Variant.Type常量值,表示字典的值的类型
获取值的内置类名;如果值不是对象类型就返回空字符串。
唯一字符串形式的值的类型,如果不是对象类型则返回空字符串
获取值关联的脚本(Script)实例,没有则返回null
值所关联的脚本实例(Script类型),如果不存在则返回null
key:要检测的键。
如果该字典包含给定的键 key,则返回 true。只要键存在,即使对应的值为null,也返回 true。
在 GDScript 中,has() 等价于 in 运算符:
一个布尔值,指示给定的键是否存在于字典中
keys:包含多个键的数组。
如果该字典包含 keys中的所有键,则返回 true。
一个布尔值,指示给定数组中的所有键是否全都存在于字典中
返回一个 32 位整数,代表该字典内容的哈希值。
两个字典条目顺序不同哈希值也不同。哈希相同不保证内容完全相同,但哈希不同的字典一定不相同。
表示字典内容的 32 位哈希值。
判断字典是否为空(无任何条目)。
字典为空时返回 true,否则返回 false。
判断字典是否只读。
字典为只读时返回 true,否则返回 false。
dictionary:另一个字典。
判断当前字典与传入字典是否键和值的类型都相同。
类型相同返回 true,否则返回 false。
dictionary:另一个字典。
判断当前字典与传入字典的键的类型是否相同。
键类型相同返回 true,否则返回 false。
dictionary:另一个字典。
判断当前字典与传入字典的值的类型是否相同。
值类型相同返回 true,否则返回 false。
判断该字典是否为类型化字典(键和值类型受限制)。
是类型化字典返回 true,否则 false。
判断该字典的键是否有类型限制。
键有类型限制返回 true,否则 false。
判断该字典的值是否有类型限制。
值有类型限制返回 true,否则 false。
返回该字典中所有键的 Array。
包含所有键的 Array。
将该字典设置为只读,禁止进一步修改。注意,对嵌套内容(如嵌套字典)无效。
-
dictionary:要合并进当前字典的另一个字典。 -
overwrite(可选):是否覆盖已有键(默认为 false)。
将另一个字典的内容合并到当前字典中。默认不会覆盖重复键,除非 overwrite为 true。该方法不进行递归合并。
-
dictionary:用于合并的新字典。 -
overwrite(可选):是否在遇到重复键时覆盖(默认为false)。
返回一个新的字典,包含当前字典与传入字典合并后的内容。与 merge() 不同,该方法不修改原始字典,而是返回合并结果的新副本。
合并后的 Dictionary副本。
-
dictionary:要进行比较的另一个字典。 -
recursion_count:最大递归深度。
判断两个字典是否结构与内容都一致,包括内部嵌套的 Dictionary和 Array,会进行递归比较。
若所有键值都相等则返回 true,否则返回 false。
-
key:要设置的键。 -
value:对应的新值。
将键对应的值设为给定值,相当于 dict[key] = value。
对于类型化字典,类型错误时不会报错
返回 true表示设置成功。
返回该字典中当前的条目数量。
条目的数量(整数)。
按键对字典原地排序,使转换为字符串或序列化时具有稳定顺序。适合用于有序输出或数据库存储。
返回该字典中所有值组成的数组。
一个 Array,包含字典的所有值。