SearchResultsIterator
- class HPS.SearchResultsIterator : public HPS.Object
An iterator used for traversing results from a search on an associated SearchResults object.
Public Functions
- override void Dispose ()
- HPS.Key GetItem ()
Returns the item that this iterator is currently pointing at. Throws exception if iterator is not valid. This method is functionally equivalent to the overloaded operator*.
- Return
The current item.
- HPS.Search.Type[] GetResultTypes ()
Retrieves the search criteria that were met for the current search item pointed to by this iterator.
- Return
An array of search types for the current item.
- bool IsValid ()
Queries the validity of this iterator location. Invalid locations would include uninitialized iterators and iterators that had walked past the last element.
- Return
true if this iterator is pointing to a valid item, false otherwise.
- void Next ()
Advances the iterator to the next search result item
- override HPS.Type ObjectType ()
This function returns the type the object, as declared (if the object is derived, this does not give the true type of the derived object).
- Return
The declared type of the object in question, which may differ from the true, underlying type.
- override void Reset ()
Resets iterator to the beginning of the associated search results.
- SearchResultsIterator ()
The default constructor creates a new SearchResultsIterator object that is not associated with any SearchResults object.
- SearchResultsIterator (HPS.SearchResultsIterator in_search_results_iterator)
The copy constructor initializes a new SearchResultsIterator object that is associated with the same SearchResults object as the source and at the same location in the results. Subsequent changes to either iterator will not affect the other.
- Param in_search_results_iterator
The source of the copy.
- void Set (HPS.SearchResultsIterator in_search_results_iterator)
Copies a SearchResultsIterator object, associating this object with the same SearchResults object as the source and at the same location in the results. Subsequent changes to either iterator will not affect the other. This method is functionally equivalent to the overloaded assignment operator except for the return value.
- Param in_search_results_iterator
The source of the copy.