Hash iterator — различия между версиями

Текущая версия на 15:19, 19 апреля 2008

Класс hash_iterator выступает в роли указателя на некоторую пару ключ-значение в хеше. Итератор позволяет двигаться вперед по парам значений, а также получать текущие ключ и значение. Итераторы применяются для навигации по хешу, а так же выступают параметрами для некоторых операций с объектами класса hash.

Родители: Object
Методы: key value value= set_value
Реализует операторы: ==, <>, ++, присваивания

[править] оператор ==

operator == (сравниваемый итератор: hash_iterator)
Возвращает: логическое значение

Метод сравнивает текущий итератор с переданным и возвращает истину только в том случае, если оба итератора указывают на одну и ту же запись одного и того же хеша; в остальных случаях возвращается ложь.

[править] оператор <>

Инверсия оператора ==.

Примечание: В K++ используется форма "!=".

[править] оператор ++

Возвращает: текущий объект.

Перемещает итератор на одну позицию вперед, то есть на следующую пару ключ-значение. Обратной операции не существует, поскольку очередь в низкоуровневой реализации хеша односвязная.

Если текущий итератор указывает на последний элемент хеша и к нему применяется оператор ++, то после этого он будет указывать на "конец" хеша, а именно на итератор hash:end.

[править] key

Возвращает: Object

Метод возвращает значение ключа для текущей пары.

[править] value

Возвращает: Object

Метод возвращает связанное с ключом значение для текущей пары.

[править] value=

value= (новое значение)
set_value(новое значение)

Возвращает: текущий объект.

Метод записывает новое значение в текущую пару, которое отныне будет ассоциировано с данным ключом.