浏览表中的行

UltraLite C++ API 提供了几种浏览表的方法，以执行各种浏览任务。有关 ULTable 类的详细信息，请参见ULTable 类。

ULTable 对象提供了以下方法来浏览表：

AfterLast 定位到紧接在最后一行后面的位置。
BeforeFirst 定位到紧接在第一行前面的位置。
First 移至第一行。
Last 移至最后一行。
Next 移至下一行。
Previous 移至上一行。
Relative(offset) 根据带符号的偏移值的指定，相对于当前行移动特定行数。如果偏移值为正，则相对于指针在结果集中的当前位置在结果集中向前移动。如果偏移值为负，则在结果集中向后移动。如果偏移值为零，则不移动当前位置，但可以重新填充行缓冲区。

示例

以下示例打开名为 MyTable 的表并显示每一行名为 MyColumn 的列的值：

char buffer[ 100 ];
ul_column_num column_id;
ULTable * tbl = conn->OpenTable( "MyTable" );
if( tbl == NULL ) {
    const ULError * ulerr;
    ulerr = conn->GetLastError();
    // write code to handle the error
    return;
}
column_id = tbl->GetTableSchema().GetColumnID( "MyColumn" );
if( column_id == 0 ) {
    // the column "MyColumn" likely does not exist.  Handle the error.
    tbl->Close();
    return;
}
while( tbl->Next() ) {
    tbl->GetString( column_id, buffer, 100 );
    printf( "%s\n", buffer );
}
tbl->Close();

打开 ULTable 对象时，应用程序可以访问表中的行。缺省情况下，这些行按主键值排序，但可在打开表时指定一个索引，以便以特定的顺序访问行。

示例

另请参见

使用DocCommentXchange 讨论此页。