scripting dictionary что это

Объект Dictionary

Объект, который хранит пары ключа и элемента.

Синтаксис

Scripting.Dictionary

Примечания

Объект Dictionary является эквивалентом ассоциативного массива языка PERL. Элементы, представляющие собой любую форму данных, хранятся в массиве. Каждый элемент ассоциируется с уникальным ключом. Ключ используется для получения отдельного элемента и обычно является набором или строкой, но может быть чем угодно, кроме массива.

В следующем коде показано, как создать объект Dictionary.

Методы

Свойства

См. также

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.

Источник

VBA Excel. Объект Dictionary (свойства, методы, примеры)

Создание объекта Dictionary с помощью кода VBA Excel. Раннее и позднее связывание. Методы и свойства словаря и синтаксис выражений с ними. Примеры кода.

Создание объекта Dictionary

Раннее связывание:

Позднее связывание:

Чтобы использовать раннее связывание, необходимо подключить в редакторе VBA ссылку на библиотеку Microsoft Scripting Runtime, если она еще не подключена (в меню Tools–>References…):

Раннее связывание позволяет использовать при написании кода VBA Excel лист выбора и вставки свойств и методов объекта Dictionary (лист подсказок):

Лист подсказок отображается автоматически после ввода точки или, в иных случаях, вызывается сочетанием клавиш «Ctrl+Пробел».

Методы и свойства словаря

Методы объекта Dictionary

Метод Add
Метод Add добавляет в словарь новую пару ключ–элемент.

Если добавляемый ключ в словаре уже есть, VBA Excel сгенерирует ошибку.

Метод Exists
Метод Exists возвращает логическое значение, указывающее, существует ли в словаре указанный ключ. True – указанный ключ существует, False – указанный ключ не существует.

Источник

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.

Methods

Properties

See also

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.

Источник

Упрощаем работу с помощью объекта Scripting Dictionary

В примерах сценариев, которые я приводил в статьях в течение последних месяцев, рассматривались возможности достаточно редко применяемого разработчиками объекта Scripting::Dictionary. И все равно те читатели, с которыми мне довелось общаться, говорят, что по-прежнему почти не используют Dictionary в своих сценариях. Поэтому я решил продемонстрировать, как объект Scripting::Dictionary позволяет упростить реализацию ряда функций в некоторых типах сценариев. Давайте рассмотрим Scripting::Dictionary более углубленно

Dictionary. Свойства и методы

Объект Dictionary имеет шесть методов и четыре свойства, которые описаны в статье MSDN, доступной по адресу: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/script56/html/jsobjdictionary.asp?frame=true. Создание объекта Dictionary осуществляется следующим образом:

Имя объектной переменной можно выбирать по своему усмотрению. Лично я предпочитаю для обозначения переменных такого типа использовать префикс dic, но это не обязательно. Итак, теперь у нас есть объект Dictionary и мы можем записать в него элемент данных. Для этого служит метод Dictionary::Add, который использует два аргумента: ключ (key) и то значение, на которое должен ссылаться данный ключ (item). Ниже показано несколько примеров:

При желании любую из этих четырех строк можно использовать в своих сценариях. В данных примерах первый аргумент (т.е. «1», «2», «servername», и «serverIP») является ключом, а второй аргумент, соответственно, значением. Если попытаться использовать в методе Dictionary::Add ключ, который уже существует, система выдаст сообщение об ошибке. Но при этом существующему ключу можно присвоить новое значение, для этого используется свойство Dictionary::Item с именем требуемого ключа. Пример приведен ниже:

Проверить наличие в Dictionary того или иного ключа можно с помощью метода Dictionary::Exists, используя в качестве аргумента имя интересующего ключа:

В данном примере с помощью метода Exists выполняется обычная проверка логического значения.

Удаление пары ключ-значение осуществляется с помощью метода Dictionary::Remove, где в качестве аргумента также используется имя соответствующего ключа:

Если такого ключа нет, то генерируется сообщение об ошибке. В тех случаях, когда требуется очистить объект Dictionary от всех содержащихся в нем данных, используется метод Dictionary::RemoveAll. Пример приведен ниже:

Чтение данных из объекта Dictionary

Считывать данные из объекта Dictionary можно несколькими способами. Если требуется прочитать какое-либо конкретное значение, можно воспользоваться описанным выше свойством Item. Здесь следует отметить, что с помощью свойства Item можно как считывать, так и записывать данные в объект Dictionary. Если интересующее значение является отображаемым, то для его вывода можно воспользоваться следующей командой:

Как отмечалось выше, с помощью свойства Item можно как считывать, так и записывать данные, поэтому если окажется, что ключ, заданный в качестве аргумента в свойстве Item, не существует, то для него в Dictionary будет создана новая запись, в которой в поле item будет записано пустое значение. Сценарий, приведенный в Листинге 1, является примером того, как объект Dictionary реагирует на попытку считывания данных по несуществующему ключу «servername». В результате выполнения данного сценария последовательно выводятся три значения: 0, пустая строка и 1. Из данного примера видно, что перед попыткой считывания данных по несуществующему ключу объект не содержал никаких данных, а после попытки считывания в нем уже находился один элемент.

Нужно также иметь в виду, что если с помощью свойства Item требуется присвоить и ключу, и самой величине заданные значения, и окажется, что указанный ключ не существует, то в этом случае в Dictionary будет создана новая строка, содержащая как сам ключ, так и заданное значение. Подобная ситуация иллюстрируется сценарием, показанным в Листинге 2, где сначала выводится значение 0, затем в Dictionary добавляется пара ключ-значение, после чего выводится значение 1.

Два рассмотренных подхода иллюстрируют ключевой (в прямом смысле также) момент, касающийся работы с объектом Dictionary. Речь идет о том, что, зная ключ, мы можем найти значение, однако нет простого способа найти соответствующий ключ по известному значению. Таким образом, в сценарии Листинга 4, зная значение «10.123.123.123», нам не удастся найти соответствующий ключ «serverIP». В принципе, у объекта Dictionary есть свойство Key, но, в отличие от свойства Dictionary::Item, здесь интерфейс на чтение не предусмотрен. С помощью данного свойства можно только изменять значение заданного ключа. Это делается следующим образом:

Если указанного ключа не существует, то в результате выполнения данного оператора в Dictionary будет добавлена строка с заданным значением ключа и пустым значением item. Учитывая все сказанное, можно сформулировать следующие практические рекомендации для работы с объектом Dictionary: если вас интересуют только значения данных, но не их ключи – используйте Dictionary::Items; если же требуются как сами данные, так и соответствующие им ключи, работайте с Dictionary::Keys.

Третий способ получения полного набора данных из объекта Dictionary заключается в применении к данному объекту цикла For Each. Next. Этот алгоритм можно применить и к коллекции для последовательного извлечения из Dictionary всех ключей. Данный подход иллюстрирует сценарий, показанный в Листинге 5.

Встроенные механизмы сравнения

Завершая изучение объекта Dictionary, давайте рассмотрим еще одно свойство, которое в ряде ситуаций может оказаться весьма полезным. Если в процессе разработки используется язык VBScript, то ключи будут являться строковыми значениями. При этом в некоторых случаях может возникнуть необходимость в использовании ключей, содержащих символы в разных регистрах, например «SRV» и «srv»; «File», «FILE» и «file»; или «voID» и «VOID». Для того чтобы в подобной ситуации избежать ошибок, необходимо сделать так, чтобы объект Dictionary умел различать регистры. А объект Dictionary как раз по умолчанию является чувствительным к регистру. Если же требуется установить нечувствительный к регистру режим сравнения строк, то это можно сделать с помощью свойства Dictionary::CompareMode, которое доступно как для чтения, так и для записи. По умолчанию это свойство имеет значение 0, что соответствует двоичному (binary) режиму сравнения. Если для данного свойства установить значение 1, будет активизирован текстовый (textual) режим сравнения данных. В принципе данное свойство допускает установку значения 2 и выше, но все эти значения используются только в Microsoft Access, в сценариях же они не актуальны. Изменение значения свойства CompareMode должно выполняться после того, как соответствующий объект создан, но до начала записи в него каких-либо данных. Пример показан ниже:

Если вы попытаетесь изменить значение CompareMode для непустого объекта Dictionary, то получите сообщение об ошибке. Отмечу также, что поскольку используемые здесь константы являются встроенными в VBScript, вместо значений 1 и 0 можно использовать, соответственно, vbTextCompare и vbBinaryCompare, что позволит сделать код сценария более удобным для восприятия.

Сопоставление файлов

У системных администраторов часто возникает необходимость сравнить два файла. Допустим, имеется файл номер 1, содержащий уникальные имена пользователей и компьютеров, и файл номер 2, в котором находятся уникальные имена компьютеров и соответствующие IP-адреса. Требуется найти в файле 1 те имена компьютеров, для которых в файле 2 нет информации об IP-адресах, а также те компьютеры из файла 2, для которых в файле 1 нет данных об имени пользователя. Или, например, такая ситуация: имеется два файла, каждый из которых содержит сотни, или даже тысячи строк данных, состоящих из ключей и соответствующих им значений. При этом известно, что в принципе они содержат одинаковые значения, но данные никак не отсортированы, к тому же возможны пропуски данных, что еще более усложняет процедуру сравнения. Давайте посмотрим, какими средствами мы располагаем для решения подобных задач.

Так как вторую проблему решить проще, начнем с нее. К сожалению, нельзя просто взять и отсортировать содержимое файлов, а затем выполнить их построчное сравнение, потому что как только в одном из файлов обнаружится отсутствующая строка, при переходе к следующей строке будет сгенерировано сообщение об ошибке. В принципе данную ситуацию можно обойти, создав соответствующую процедуру, которая при обнаружении отсутствующей строки будет ее игнорировать и переходить к обработке следующей. Другой вариант состоит в том, чтобы считать содержимое обоих файлов и преобразовать их в соответствующие массивы, после чего, организовав циклические процедуры для каждого из массивов, выполнить для каждого элемента массива 1 проверку, существует ли такой элемент в массиве 2. Однако если мы воспользуемся возможностями объекта Dictionary, это позволит нам существенно упростить код.

Сначала выполняется обработка объекта dicData1 циклом For Each. Next. В ходе его выполнения считывается значение каждого ключа, которое затем записывается в переменную strKey. После этого с помощью метода Dictionary::Exists выполняется проверка, существует ли данный ключ в dicData2. Если в dicData2 такой ключ найден не был, то в выходной файл результатов записывается строка, в которой указывается, что данный ключ существует только в dicData1. Если этот ключ есть и в dicData1, и в dicData2, внутри цикла выполняется сравнение значений полей item, для чего вызывается метод Dictionary::Item с переменной strKey в качестве аргумента. Если значения совпадают, то никаких действий не предпринимается, если же выясняется, что они различны, то этот факт также регистрируется в файле выходных данных.

После того как первый цикл выполнит для каждого ключа объекта dicData1 проверку, существует ли такой ключ в dicData2, запускается еще один цикл. Он проверяет, имеются ли в dicData2 такие ключи, которые отсутствуют в dicData1. Если выясняется, что ключ есть и в dicData1, и в dicData2, тогда для него внутри цикла выполняется сравнение значений полей item, для чего вызывается метод Dictionary::Item с переменной strKey в качестве аргумента. В конце сценария для каждого из входных файлов выполняется обращение к свойству Dictionary::Count для записи в выходной файл информации о количестве содержащихся в них строк, после чего этот файл закрывается. В дальнейшем выходной файл может обрабатываться любым способом в зависимости от необходимости – например, можно распечатать содержащиеся в нем данные. Для проверки работы описанного сценария можно воспользоваться двумя тестовыми входными файлами небольшого объема.

С помощью сценария, показанного в Листинге 6, можно решить первую из двух задач, сформулированных в самом начале этого пункта. В данном примере файл Users.csv содержит пары «имя пользователя» и «имя компьютера», а в файле Clients.csv находятся пары, состоящие из имени компьютера и соответствующего IP-адреса. За исключением того, что здесь используются другие имена переменных (например, dicUsers вместо dicData1), в целом структура циклов For. Each похожа на ту, которую мы видим в сценарии Листинга 5. Но поскольку в данном случае ключевое поле dicClients является полем item для dicUsers, в циклы внесены изменения, учитывающие этот нюанс. В ходе выполнения первого цикла происходит последовательная запись каждого имени пользователя (strKey) и имени компьютера (strItem) в объект Users и выполняется проверка, существует ли данный элемент strItem в качестве ключа в объекте Clients. Если его там нет, то этот факт регистрируется в выходном файле. Второй цикл работает с объектом Clients. Здесь нужно выявить соответствие между каждым клиентом (strKey) и полем item в объекте Users. Процедура, проверяющая, соответствует ли данному ключу какой-либо элемент item в объекте Users, использует метод Dictionary::Items, с помощью которого формируется массив, содержащий все элементы item. После этого все элементы созданного массива просматриваются в цикле с целью обнаружения совпадения какого-либо из них со значением переменной strKey. Если совпадение найдено, то логической переменной bolFound присваивается значение TRUE (изначально ей было присвоено значение FALSE). Если же после того как цикл сопоставил все элементы из Clients с содержимым объекта Users, переменная bolFound по-прежнему имеет значение FALSE, в файл выходных данных будет сделана запись о том, что компьютер с этим именем имеется только в списке Clients.

В заключение приведу краткую статистику: по моим наблюдениям, использование объекта Dictionary дает примерно восьмикратный выигрыш во времени по сравнению с обработкой стандартных массивов. А если мы работаем с данными объемом в десятки тысяч строк, разница будет особенно заметна.

Источник

Scripting dictionary что это

Элементы пронумерованы и доступны по номеру индекса. Индекс всегда числовой.

А вот, что из себя представляет Dictionary (словарь):

С другой стороны нечто подобное можно же сделать, используя массив. Давайте объявим двумерный массив:

Должно быть у словаря есть какие-то преимущества перед таким использованием массивов? И это действительно так!

Давайте пока просто перечислим важнейшие преимущества:

Словарь контролирует уникальность ключей. Два одинаковых ключа не могут быть добавлены в словарь. Это важное свойство, так как программисту очень часто требуется обеспечить или проконтролировать уникальность каких-либо наборов значений, и в этом может с успехом быть использован Dictionary ;

Словарь очень эффективно (при помощи встроенного алгоритма бинарного поиска) осуществляет извлечение элементов по известному ключу. В десятки раз быстрее, чем обычный перебор;

У словаря есть встроенный метод ( Exists ), при помощи которого можно понять, добавлен ли некий ключ в коллекцию;

Словарь позволяет добавлять новые элементы и удалять любые элементы, что, работая с массивами, сделать гораздо сложнее;

Словарь может вернуть все ключи и все элементы в виде отдельных одномерных массивов.

2. Создание Dictionary

3. Свойства и методы объекта Dictionary

4. Наполнение словаря

4.1. Типы данных ключа и элемента

Dictionary наполняется по одному элементу. Не существует способов наполнить словарь массово. Чтобы добавить в словарь новый элемент вы должны иметь уникальный ключ и сам элемент, который под этим ключом будет храниться в словаре.

В качестве типа данных для элемента может быть использовано практически всё что угодно: числа, логический тип, строки (в том числе пустые), дата-время, массивы, любые объекты (листы, диапазоны, коллекции, другие словари, пустой указатель Nothing ).

В качестве типа данных для ключа могут быть использованы: числа, строки, дата-время, объекты, но не массивы.

4.2. Через метод Add

4.3. Через свойство Item

4.4. Неявное добавление ключа в Dictionary

И ещё один неожиданный и я бы сказал экзотический способ пополнения словаря. Если упомянуть свойство Item по ПРАВУЮ сторону оператора присваивания, то он оказывается добавит в словарь key с пустым item, если данного key не существует в коллекции. Если же такой key уже существует, то никаких действий предпринято не будет.

Ещё раз хочу обратить ваше внимание, что элемент (item) при таком пополнении коллекции будет пустым ( Empty ). Это можно использовать, если вам нет необходимости что-то хранить в элементах в качестве полезной нагрузки (например, когда вы просто строите список уникальных значений, встречающихся в столбце таблицы).

5. Удаление элементов

Есть 2 варианта удаления элементов из словаря:

Источник