From 940b4d1848e8c70ab7642901a68594e8016caffc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 27 Apr 2024 18:51:28 +0200 Subject: Adding upstream version 1:7.0.4. Signed-off-by: Daniel Baumann --- .../source/text/sbasic/shared/03090202.xhp | 124 +++++++++++++++++++++ 1 file changed, 124 insertions(+) create mode 100644 helpcontent2/source/text/sbasic/shared/03090202.xhp (limited to 'helpcontent2/source/text/sbasic/shared/03090202.xhp') diff --git a/helpcontent2/source/text/sbasic/shared/03090202.xhp b/helpcontent2/source/text/sbasic/shared/03090202.xhp new file mode 100644 index 000000000..7fc43cdf4 --- /dev/null +++ b/helpcontent2/source/text/sbasic/shared/03090202.xhp @@ -0,0 +1,124 @@ + + + + + + + For...Next Statement + /text/sbasic/shared/03090202.xhp + + + + + + +

+ + For statement + For Each statement + In keyword + Next keyword + Step keyword + To keyword + Step keyword + + + +

For...Next Statement

+ Repeats the statements between the For...Next block a specified number of times. +

+ +

Syntax:

+ +

For Statement diagram + + +For counter=start To end [Step step] + statement-block + [Exit For] + statement-block +Next [counter] + + +

For Each Statement diagram + + + For Each item In list + statement-block + [Exit For] + statement-block + Next [item] + + +

Variables:

+ counter: Loop counter initially assigned the value to the right of the equal sign (start). Only numeric variables are valid. The loop counter increases or decreases according to the variable step until end is passed. + start: Numeric variable that defines the initial value at the beginning of the loop. + end: Numeric variable that defines the final value at the end of the loop. + step: Sets the value by which to increase or decrease the loop counter. If step is not specified, the loop counter is incremented by 1. In this case, end must be greater than start. If you want to decrease counter, end must be less than start, and step must be assigned a negative value. +The For...Next loop repeats all of the statements in the loop for the number of times that is specified by the parameters. +As the counter variable is decreased, %PRODUCTNAME Basic checks if the end value has been reached. As soon as the counter passes the end value, the loop automatically terminates. +It is possible to nest For...Next statements. If you do not specify a variable following the Next statement, Next automatically refers to the most recent For statement. +If you specify an increment of 0, the statements between For and Next are repeated continuously. +When counting down the counter variable, %PRODUCTNAME Basic checks for overflow or underflow. The loop ends when counter exceeds end (positive Step value) or is less than end (negative Step value). +Use the Exit For statement to exit the loop unconditionally. This statement must be within a For...Next loop. Use the If...Then statement to test the exit condition as follows: + + For... + statement-block + If condition = True Then Exit For + statement-block + Next + + +In nested For...Next loops, if you exit a loop unconditionally with Exit For, only one loop is exited. + +

Examples

+The following example uses two nested loops to sort a string array with 10 elements ( sEntry() ), that is filled with various contents: + +Sub ExampleSort +Dim sEntry(9) As String +Dim iCount As Integer, iCount2 As Integer +Dim sTemp As String + sEntry = Array("Jerry","Patty","Kurt","Thomas","Michael",_ + "David","Cathy","Susie","Edward","Christine") + For iCount = 0 To 9 + For iCount2 = iCount + 1 To 9 + If sEntry(iCount) > sEntry(iCount2) Then + sTemp = sEntry(iCount) + sEntry(iCount) = sEntry(iCount2) + sEntry(iCount2) = sTemp + End If + Next iCount2 + Next iCount + For iCount = 0 To 9 + Print sEntry(iCount) + Next iCount +End Sub + +This explores the content of an array to display each item it contains. + + Sub list_iteration + cutlery = Array("fork", "knife", "spoon") + For Each item in cutlery + Print item + Next ' item + End Sub + + + + \ No newline at end of file -- cgit v1.2.3