%DeepSee.SetBuilder.Find

At minimum, ContainsItem() must be supported. It returns 1 iff the given pItem is in the set S

For a given .pChunk, return the corresponding actual bitmap string

Inherited description:

This method simulates the usage of $ORDER() to traverse through the chunks of a bitmap index or a bitmap temp-file that would represent the set S.

For a given chunk number pChunk, find the first chunk number > pChunk and return it in .pChunk, with the method return value being the corresponding actual bitmap string. Return .pChunk="" if none found.

Note that when returning a positive .pChunk, it's OK for the returned bitmap b to have no bits set to 1, including b="" . On the other hand, it's also OK for the method implementation to skip such a chunk and proceed to the next pChunk.

This method must be implemented when %FIND is used.

Inherited description:

The NextItem(), NextItemInclusive(), PreviousItem(), and PreviousItemInclusive() methods are required when %INSUB is used. They emulate the usage of $ORDER() to iterate over the set of values S as if it was stored in a subscript, similar to a subscript layer in a regular index. The input parameter pItem and the returned item iterate in a sequence through all the elements of S, following the normal Cache subscript order ( "]]" ), starting and ending with "", exactly as $ORDER() does.

For a given pItem, return the first item > pItem

Inherited description:

This method simulates the usage of $ORDER() to traverse backwards through the chunks of a bitmap index or a bitmap temp-file that would represent the set S.

For a given chunk number pChunk, find the first chunk number < pChunk and return it in .pChunk, with the method return value being the corresponding actual bitmap string. Return .pChunk="" if none found.

Note that when returning a positive .pChunk, it's OK for the returned bitmap b to have no bits set to 1, including b="" . On the other hand, it's also OK for the method implementation to skip such a chunk and proceed to the next pChunk.

This method must be implemented when %FIND is used.

For a given pItem, return the first item