find モードと lookup モードを使用したローの検索

Ultra Light には、データを操作するための操作モードがいくつかあります。検索では、これらのモードのうち、検索とルックアップの 2 つを使用できます。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 オブジェクトは、検索を実行するとき、ローバッファー内の値を使用します。このバッファーは "Smith" として指定されています。このことは、SetString メソッドによって定義されています。FindFirst メソッドは、lname が "Smith" に設定されている最初のローからトラバーサルが開始されることを示します。lname が "Smith" に設定されているローがない場合、ポインターはテーブルの最後のローの後に位置付けられます。GetString メソッドによって fname が取得されます。これは、fname のカラム ID が 3 であるためです。次に、結果が表示され、リソースが解放されます。

参照

DocCommentXchange で意見交換できます