_DBRewind( ), API-Bibliotheksroutine

Funktioniert wie der Visual FoxPro-Befehl GO TO****im angegebenen Arbeitsbereich und gibt anschließend die aktuelle Datensatznummer zurück.

long _DBRewind(int workarea)
int workarea;               /* Work area. */

Beispiel

Im folgenden Beispiel wird _DBRewind( ) für die im aktuellen Arbeitsbereich geöffnete Tabelle aufgerufen. Dies hat dieselben Auswirkungen wie der Visual FoxPro-Befehl GO TOP.

Visual FoxPro-Code

SET LIBRARY TO DBREWIND
DO CreateTest
GO BOTTOM
? RECNO()
? DBREWIND()    && returns 1
? RECNO()  && yes, we're at record 1

PROCEDURE CreateTest
   CREATE TABLE test (ABC C(20))
   APPEND BLANK
   REPLACE ABC WITH "This is record 1"
   APPEND BLANK
   REPLACE ABC WITH "This is record 2"
   APPEND BLANK
   REPLACE ABC WITH "This is record 3"
   APPEND BLANK
   REPLACE ABC WITH "This is record 4"
   GO TOP
RETURN

C-Code

#include <pro_ext.h>

FAR Example(ParamBlk FAR *parm)
{
   _RetInt(_DBRewind(-1), 10);
}
FoxInfo myFoxInfo[] = {
   {"DBREWIND", (FPFI) Example, 0, ""},
};
FoxTable _FoxTable = {
   (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};

Siehe auch

_DBSkip( ), API-Bibliotheksroutine | _DBUnwind( ), API-Bibliotheksroutine | GO | GOTO-Befehl | Zugreifen auf die Visual FoxPro-API