@IncrementViewPos

Increments the pointer in VIEWPOS VIEWPOS by 1 to point to the next document in the view and writes the result directly back to VIEWPOS VIEWPOS.
On success this @Function returns TRUE otherwise @Error.

FN FNLEVEL (Optional):
If this parameter is omitted, this @Function always increments the last level.
If a different level (for example the category being navigated in) is to be incremented, it can be specified in FN FNLEVEL.

Example: @IncrementViewPos(VIEWPOS)

VIEWPOS:=@ViewPos(1:1);
@LogReport(VIEWPOS;3);
@IncrementViewPos(VIEWPOS);
@LogReport(VIEWPOS;3);

The script creates the following log entries:
I:VIEWPOS Matches:00000000 Level:01 MaxLevel:00 MinLevel:00 Tumbler[00]:1 Tumbler[01]:1
I:VIEWPOS Matches:00000000 Level:01 MaxLevel:00 MinLevel:00 Tumbler[00]:1 Tumbler[01]:2

The second line shows that the last counter (the last level) has been incremented by 1.

Note : This text was machine-translated and may contain inaccuracies.