The All-in-One Database Software Solution

Online Help System

Back to Brilliant Database Web-Site | Write to Support | Help Index

Cycles

Introduction

Cycles (loops) allow performing the same actions (cycle body) over different objects or under different conditions. For example, you can calculate the total of numbers 1 through 100, perform operations over several records stored in the recordset variable at once or print individual lines from a text.

A cycle always begins with the For... string. To identify the end of a cycle body, type Next Item:

Lines between the For (2) and Next (4) lines make the cycle body. In this example, the cycle body contains only one line (3).

This program uses cycles of three types that differ by the cycle subject:

For Interval (1,2,3...)

This cycle type changes the value of a specified variable in a specified range with a specified step and performs enclosed commands. Example:

In this example, the [$i] variable changes its value from 2 to 20 with step 2. For each of these values, the program will perform the commands contained in line (3), and the user will see 10 messages with the following text:

Variable Value: 2
Variable Value: 4
Variable Value: 6
Variable Value: 8
...
Variable Value: 20

For each line from text

This cycle type splits text to lines, and performs the enclosed actions over each line. Example:

In this example:

Line 1: Write the list of three cities in the [$cities] variable.
Lines 2, 5: Define the cycle, in which the [$line] variable will consecutively contain a value from the list. In our case, that's the list of cities contained in the [$cities] variable.
Lines 3, 4: Cycle body. Line 3 creates a new record, and line 4 writes the city name to the Title field of the record.

Thus, upon completion of this script, we will have 3 records with titles respectively London, Paris, and Moscow.

Any data source can be used with this cycle - data from file (see Read File), field values from DB records, etc.

For Each record from recordset

This cycle type allows performing operations over a set of records in a database. The records are defined in the recordset variable that can be created with a query, relational field, etc. Learn more about recordsets...

In this example:

Line 1: Places the set of records created by the All Records query to the [$rset] variable.
Lines 2, 4: Define the cycle, in which all operations will apply to records stored in the [$rset] variable instead of the current record.
Line 3: Cycle body. Increments the value of [Field A] by one.