搜索行

UltraLite 具有用于处理数据的不同操作模式。您可以将其中两种模式（查找和查寻）用于搜索。ULTable 对象具有对应这些模式的方法，可用于定位表中的特定行。

注意

使用 Find 方法和 Lookup 方法搜索的列必须在用于打开该表的索引中。

Find 方法 按照打开 ULTable 对象时指定的排序顺序，移动到与指定的搜索值完全匹配的第一行。如果找不到搜索值，则应用程序将定位到第一行之前或最后一行之后。
Lookup 方法 按照打开 ULTable 对象时指定的排序顺序，移动到匹配或大于指定的搜索值的第一行。

示例

此示例使用通过以下 SQL 语句创建的名为 MyTable 的表：

CREATE TABLE MyTable( id int primary key, lname char(100), fname char(100) )
CREATE INDEX ix_lname ON MyTable ( lname )

以下代码显示 lname 列为 "Smith" 时的所有 fname 列内容：

ULTable * tbl = conn->OpenTable( "MyTable", "ix_lname" );
char buffer[ 100 ];
bool found;
tbl->FindBegin();  // enter "Find mode"
tbl->SetString( "lname", "Smith" );  // set pointer row buffer to "Smith"
found = tbl->FindFirst();
while( found ) {
    tbl->GetString( 3, buffer, 100 );
    printf( "%s\n", buffer );
	found = tbl->FindNext();
}
tbl->Close();

在此示例中，tbl 变量被设置为使用 ix_lname 索引打开 MyTable，从而使用与 lname 列相同的顺序返回行。ULTable 对象在执行查找时使用行缓冲区中的值。根据 SetString 方法的定义，此缓冲区被指定为 "Smith"。FindFirst 方法表示遍历应从 lname 设为 "Smith" 的第一行开始；如果没有 lname 设为 "Smith" 的行，则指针将定位于表的最后一行。fname 使用 GetString 方法检索，因为 fname 有一列 ID 为 3。然后显示结果，并且释放资源。

另请参见

使用DocCommentXchange 讨论此页。