BtTable:Seek()

 

<< Click to Display Table of Contents >>

Navigation:  Support Classes > BtTable Class >

 

BtTable:Seek()

 

Previous pageReturn to chapter overviewNext page

 

Purpose

 

 

Seek in the VO/Style with Softseek functionality

 

 

 

Prototype

 

 

METHOD Seek ( uKeys AS USUAL, lSoftSeek AS LOGIC )  AS LOGIC PASCAL CLASS BtTable

 

 

 

Argument(s)

 

 

<uKeys>                One key value or an optional array of key values to seek for. The

                         type of the values must match the (VO equivalent of) the btrieve

                         types that the index consists of

<lSoftSeek>                LOGIC Do we seek for an exact match ?

 

 

 

 

Return

 

 

LOGIC                Was the seek succesfull.

 

 

 

Description

 

 

When seeking multi-segmented indexes, you should pass all segments if you want to do an exact seek. When you want to seek on not all of the segments, you should set the lSoftSeek to TRUE

 

IF there is a scope on the active index, BtTable:Seek() will check the scope and return FALSE and set the server to EOF when the record that is found falls out of the scope.

 

 

 

See Also

 

 

BtTable, BtServer:Seek(), BtTable:SeekEq(), BtTable:SeekGE(), BtTable:SeekGT(), BtTable:SeekLE(), BtTable:SeekLT()