class_dictionary.rst 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117
  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_clear>` **(** **)** |
  15. +--------------------------------------+----------------------------------------------------------------------------------------------------------------------------+
  16. | :ref:`Dictionary<class_Dictionary>` | :ref:`duplicate<class_Dictionary_duplicate>` **(** :ref:`bool<class_bool>` deep=False **)** |
  17. +--------------------------------------+----------------------------------------------------------------------------------------------------------------------------+
  18. | :ref:`bool<class_bool>` | :ref:`empty<class_Dictionary_empty>` **(** **)** |
  19. +--------------------------------------+----------------------------------------------------------------------------------------------------------------------------+
  20. | :ref:`bool<class_bool>` | :ref:`erase<class_Dictionary_erase>` **(** :ref:`Variant<class_Variant>` key **)** |
  21. +--------------------------------------+----------------------------------------------------------------------------------------------------------------------------+
  22. | :ref:`Variant<class_Variant>` | :ref:`get<class_Dictionary_get>` **(** :ref:`Variant<class_Variant>` key, :ref:`Variant<class_Variant>` default=Null **)** |
  23. +--------------------------------------+----------------------------------------------------------------------------------------------------------------------------+
  24. | :ref:`bool<class_bool>` | :ref:`has<class_Dictionary_has>` **(** :ref:`Variant<class_Variant>` key **)** |
  25. +--------------------------------------+----------------------------------------------------------------------------------------------------------------------------+
  26. | :ref:`bool<class_bool>` | :ref:`has_all<class_Dictionary_has_all>` **(** :ref:`Array<class_Array>` keys **)** |
  27. +--------------------------------------+----------------------------------------------------------------------------------------------------------------------------+
  28. | :ref:`int<class_int>` | :ref:`hash<class_Dictionary_hash>` **(** **)** |
  29. +--------------------------------------+----------------------------------------------------------------------------------------------------------------------------+
  30. | :ref:`Array<class_Array>` | :ref:`keys<class_Dictionary_keys>` **(** **)** |
  31. +--------------------------------------+----------------------------------------------------------------------------------------------------------------------------+
  32. | :ref:`int<class_int>` | :ref:`size<class_Dictionary_size>` **(** **)** |
  33. +--------------------------------------+----------------------------------------------------------------------------------------------------------------------------+
  34. | :ref:`Array<class_Array>` | :ref:`values<class_Dictionary_values>` **(** **)** |
  35. +--------------------------------------+----------------------------------------------------------------------------------------------------------------------------+
  36. Description
  37. -----------
  38. Dictionary type. Associative container which contains values referenced by unique keys. Dictionaries are always passed by reference.
  39. Method Descriptions
  40. -------------------
  41. .. _class_Dictionary_clear:
  42. - void **clear** **(** **)**
  43. Clear the dictionary, removing all key/value pairs.
  44. .. _class_Dictionary_duplicate:
  45. - :ref:`Dictionary<class_Dictionary>` **duplicate** **(** :ref:`bool<class_bool>` deep=False **)**
  46. Creates a copy of the dictionary, and returns it.
  47. .. _class_Dictionary_empty:
  48. - :ref:`bool<class_bool>` **empty** **(** **)**
  49. Return true if the dictionary is empty.
  50. .. _class_Dictionary_erase:
  51. - :ref:`bool<class_bool>` **erase** **(** :ref:`Variant<class_Variant>` key **)**
  52. Erase a dictionary key/value pair by key.
  53. .. _class_Dictionary_get:
  54. - :ref:`Variant<class_Variant>` **get** **(** :ref:`Variant<class_Variant>` key, :ref:`Variant<class_Variant>` default=Null **)**
  55. 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.
  56. .. _class_Dictionary_has:
  57. - :ref:`bool<class_bool>` **has** **(** :ref:`Variant<class_Variant>` key **)**
  58. Return true if the dictionary has a given key.
  59. .. _class_Dictionary_has_all:
  60. - :ref:`bool<class_bool>` **has_all** **(** :ref:`Array<class_Array>` keys **)**
  61. Return true if the dictionary has all of the keys in the given array.
  62. .. _class_Dictionary_hash:
  63. - :ref:`int<class_int>` **hash** **(** **)**
  64. Return a hashed integer value representing the dictionary contents.
  65. .. _class_Dictionary_keys:
  66. - :ref:`Array<class_Array>` **keys** **(** **)**
  67. Return the list of keys in the ``Dictionary``.
  68. .. _class_Dictionary_size:
  69. - :ref:`int<class_int>` **size** **(** **)**
  70. Return the size of the dictionary (in pairs).
  71. .. _class_Dictionary_values:
  72. - :ref:`Array<class_Array>` **values** **(** **)**
  73. Return the list of values in the ``Dictionary``.