Dictionary object

Object that stores data key/item pairs.

Syntax

Scripting.Dictionary

Remarks

A Dictionary object is the equivalent of a PERL associative array. Items, which can be any form of data, are stored in the array. Each item is associated with a unique key. The key is used to retrieve an individual item and is usually an integer or a string, but can be anything except an array.

The following code illustrates how to create a Dictionary object.

Dim d                   'Create a variable
Set d = CreateObject("Scripting.Dictionary")
d.Add "a", "Athens"     'Add some keys and items
d.Add "b", "Belgrade"
d.Add "c", "Cairo"
...

Methods

Method	Description
Add	Adds a new key/item pair to a Dictionary object.
Exists	Returns a Boolean value that indicates whether a specified key exists in the Dictionary object.
Items	Returns an array of all the items in a Dictionary object.
Keys	Returns an array of all the keys in a Dictionary object.
Remove	Removes one specified key/item pair from the Dictionary object.
RemoveAll	Removes all the key/item pairs in the Dictionary object.

Properties

Property	Description
CompareMode	Sets or returns the comparison mode for comparing keys in a Dictionary object.
Count	Returns the number of key/item pairs in a Dictionary object.
Item	Sets or returns the value of an item in a Dictionary object.
Key	Sets a new key value for an existing key value in a Dictionary object.

See also

• Dictionary object (Windows Scripting previous version)
• Objects (Visual Basic for Applications)
• Object library reference for Office (members, properties, methods)

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.