Zeilennavigation

Die UltraLite C++-API bietet Ihnen mehrere Methoden zur Navigation durch eine Tabelle, um diverse Navigationsaufgaben durchzuführen.

Das ULTable-Objekt bietet Ihnen die folgenden Methoden zur Navigation durch eine Tabelle:

AfterLast Bewegt den Cursor hinter die letzte Zeile.
BeforeFirst Bewegt den Cursor vor die erste Zeile.
First Bewegt den Cursor in die erste Zeile.
Last Bewegt den Cursor in die letzte Zeile.
Next Bewegt den Cursor in die nächste Zeile.
Previous Bewegt den Cursor in die vorige Zeile.
Relative(offset) Bewegt den Cursor um eine bestimmte Anzahl von Zeilen, der im Offsetwert angegeben ist, relativ zur aktuellen Zeile. Positive Offsetwerte bewegen den Cursor in der Ergebnismenge vorwärts, relativ zur aktuellen Position des Cursors in der Ergebnismenge. Negative Offsetwerte bewegen ihn rückwärts in der Ergebnismenge. Der Offsetwert Null ändert die Cursorposition nicht, ermöglicht aber das Einlesen von Daten in den Zeilenpuffer.

Beispiel

Der Code im folgenden Beispiel öffnet die Tabelle MyTable und zeigt den Wert der Spalte MyColumn für jede Zeile an:

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();

Die Zeilen der Tabelle werden der Anwendung vorgelegt, wenn Sie das ULTable-Objekt öffnen. Standardmäßig werden die Zeilen in der Reihenfolge des Primärschlüsselwertes sortiert, Sie können jedoch einen Index angeben und eine Tabelle öffnen, um in einer bestimmten Reihenfolge auf die Zeilen zuzugreifen.

Beispiel

Kommentieren Sie diese Seite in DocCommentXchange.

Zeilennavigation

Siehe auch

Beispiel

Beispiel