class_dictionary.rst 6.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the Dictionary.xml source instead.
  3. .. The source is found in doc/classes or modules/<name>/doc_classes.
  4. .. _class_Dictionary:
  5. Dictionary
  6. ==========
  7. **Category:** Built-In Types
  8. Brief Description
  9. -----------------
  10. Dictionary type.
  11. Methods
  12. -------
  13. +-------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
  14. | void | :ref:`clear<class_Dictionary_method_clear>` **(** **)** |
  15. +-------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
  16. | :ref:`Dictionary<class_Dictionary>` | :ref:`duplicate<class_Dictionary_method_duplicate>` **(** :ref:`bool<class_bool>` deep=False **)** |
  17. +-------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
  18. | :ref:`bool<class_bool>` | :ref:`empty<class_Dictionary_method_empty>` **(** **)** |
  19. +-------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
  20. | :ref:`bool<class_bool>` | :ref:`erase<class_Dictionary_method_erase>` **(** :ref:`Variant<class_Variant>` key **)** |
  21. +-------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
  22. | :ref:`Variant<class_Variant>` | :ref:`get<class_Dictionary_method_get>` **(** :ref:`Variant<class_Variant>` key, :ref:`Variant<class_Variant>` default=Null **)** |
  23. +-------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
  24. | :ref:`bool<class_bool>` | :ref:`has<class_Dictionary_method_has>` **(** :ref:`Variant<class_Variant>` key **)** |
  25. +-------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
  26. | :ref:`bool<class_bool>` | :ref:`has_all<class_Dictionary_method_has_all>` **(** :ref:`Array<class_Array>` keys **)** |
  27. +-------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
  28. | :ref:`int<class_int>` | :ref:`hash<class_Dictionary_method_hash>` **(** **)** |
  29. +-------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
  30. | :ref:`Array<class_Array>` | :ref:`keys<class_Dictionary_method_keys>` **(** **)** |
  31. +-------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
  32. | :ref:`int<class_int>` | :ref:`size<class_Dictionary_method_size>` **(** **)** |
  33. +-------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
  34. | :ref:`Array<class_Array>` | :ref:`values<class_Dictionary_method_values>` **(** **)** |
  35. +-------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+
  36. Description
  37. -----------
  38. Dictionary type. Associative container which contains values referenced by unique keys. Dictionaries are always passed by reference.
  39. Erasing elements while iterating over them **is not supported**.
  40. Method Descriptions
  41. -------------------
  42. .. _class_Dictionary_method_clear:
  43. - void **clear** **(** **)**
  44. Clear the dictionary, removing all key/value pairs.
  45. .. _class_Dictionary_method_duplicate:
  46. - :ref:`Dictionary<class_Dictionary>` **duplicate** **(** :ref:`bool<class_bool>` deep=False **)**
  47. Creates a copy of the dictionary, and returns it.
  48. .. _class_Dictionary_method_empty:
  49. - :ref:`bool<class_bool>` **empty** **(** **)**
  50. Return true if the dictionary is empty.
  51. .. _class_Dictionary_method_erase:
  52. - :ref:`bool<class_bool>` **erase** **(** :ref:`Variant<class_Variant>` key **)**
  53. Erase a dictionary key/value pair by key. Do not erase elements while iterating over the dictionary.
  54. .. _class_Dictionary_method_get:
  55. - :ref:`Variant<class_Variant>` **get** **(** :ref:`Variant<class_Variant>` key, :ref:`Variant<class_Variant>` default=Null **)**
  56. Returns the current value for the specified key in the ``Dictionary``. If the key does not exist, the method returns the value of the optional default argument, or Null if it is omitted.
  57. .. _class_Dictionary_method_has:
  58. - :ref:`bool<class_bool>` **has** **(** :ref:`Variant<class_Variant>` key **)**
  59. Return true if the dictionary has a given key.
  60. .. _class_Dictionary_method_has_all:
  61. - :ref:`bool<class_bool>` **has_all** **(** :ref:`Array<class_Array>` keys **)**
  62. Return true if the dictionary has all of the keys in the given array.
  63. .. _class_Dictionary_method_hash:
  64. - :ref:`int<class_int>` **hash** **(** **)**
  65. Return a hashed integer value representing the dictionary contents.
  66. .. _class_Dictionary_method_keys:
  67. - :ref:`Array<class_Array>` **keys** **(** **)**
  68. Return the list of keys in the ``Dictionary``.
  69. .. _class_Dictionary_method_size:
  70. - :ref:`int<class_int>` **size** **(** **)**
  71. Return the size of the dictionary (in pairs).
  72. .. _class_Dictionary_method_values:
  73. - :ref:`Array<class_Array>` **values** **(** **)**
  74. Return the list of values in the ``Dictionary``.