Dictionary | NN n/a IE 4.0 ECMA n/a |
Объект Dictionary предназначен для создания словарей. Словарь в JScript аналогичен ассоциативному массиву языка PERL и представляет собой набор пар key/value. Значения могут быть данными любого типа. При этом каждое значение ассоциируется с уникальным ключом, который используется для его поиска и выборки из словаря. Обычно в качестве ключа используются числа или текстовые строки, хотя ключ может быть чем угодно, кроме массива. Следующий пример демонстрирует использование словаря: var d = new ActiveXObject("Scripting.Dictionary");
// Создаем словарь d Объект Dictionary реализован как управляющий элемент ActiveX, интегрированный в библиотеку типов исполняющей системы JScript. |
|
Создание:
new ActiveXObject("Scripting.Dictionary") |
Свойства:
CompareMode | NN n/a IE 4.0 ECMA n/a |
Чтение/изменение | |
Свойство CompareMode позволяет задать способ сравнения текстовых ключей в словаре. Оно может принимать следующие значения:
Значения, большие двух, могут использоваться для сравнения ключей в определенной кодировке символов и в этом случае они должны быть равны идентификатору кодировки (LCID). Значение этого свойства может быть считано в любое время, но задается оно до занесения в словарь любых значений. Попытка задать способ сравнения ключей для непустого словаря приводит к ошибке исполнения. |
|
Пример: |
|
Возвращаемое значение: Строка |
Count | NN n/a IE 4.0 ECMA n/a |
Только чтение | |
Значением свойства Count является размер объекта, т. е. количество содержащихся в нем пар key/value. |
|
Возвращаемое значение: Целое положительное число |
Item | NN n/a IE 4.0 ECMA n/a |
Чтение/изменение | |
Значением свойства Item является значение словаря, соответствующее ключу. Точнее говоря, при чтении этого свойства:
При задании нового значения этого свойства:
|
|
Пример: |
|
Возвращаемое значение: Строка |
Key | NN n/a IE 4.0 ECMA n/a |
Только изменение | |
Свойство Key используется для изменения ключа в словаре. При этом
|
|
Пример: |
|
Возвращаемое значение: Нет |
Методы:
Add() | NN n/a IE 4.0 ECMA n/a | ||||
some_dictionary_object.Add(key, value) | |||||
Метод Add добавляет в словарь some_dictionary_object новую пару key/value. Если данный ключ уже имеется в словаре, то возникает ошибка. |
|||||
Возвращаемое значение Нет |
|||||
Параметры
|
Exists() | NN n/a IE 4.0 ECMA n/a | ||
some_dictionary_object.Exists(key) | |||
Метод Exists возвращает true, если ключ имеется в словаре some_dictionary_object и false в противном случае. |
|||
Возвращаемое значение Булево значение |
|||
Параметры
|
Items() | NN n/a IE 4.0 ECMA n/a |
Метод Items возвращает массив значений словаря объект. Возвращаемый массив имеет формат VBScript |
|
Возвращаемое значение Массив VBScript |
|
Параметры Нет |
Keys() | NN n/a IE 4.0 ECMA n/a |
Метод Keys возвращает массив ключей словаря объект. Возвращаемый массив имеет формат VBScript |
|
Возвращаемое значение Массив VBScript |
|
Параметры Нет |
Remove() | NN n/a IE 4.0 ECMA n/a | ||
some_dictionary_object.Remove(key) | |||
Метод Remove удаляет из словаря some_dictionary_object пару с заданным ключом. Если данного ключа нет в словаре, то возникает ошибка. |
|||
Возвращаемое значение Нет |
|||
Параметры
|
RemoveAll() | NN n/a IE 4.0 ECMA n/a |
some_dictionary_object.RemoveAll() | |
Метод RemoveAll очищает словарь some_dictionary_object, т. е. удаляет из него все пары. |
|
Возвращаемое значение Ничего |
|
Параметры Нет |
HIVE: All information for read only. Please respect copyright! |