UnigineScript
Core Library
Engine Library
Node-Related Classes
GUI-Related Classes
Plugins Library
High-Level Systems
Samples
C++ API
API Reference
Integration Samples
Usage Examples
C++ Plugins
Content Creation
Materials
Unigine Material Library
Tutorials

Forloop

Since one often uses simple expressions as loop conditions, and loops often iterate over numerical sequences, there is an accelerated variant of the for loop, which runs 1,5–2 times faster.

Syntax

Source code (UnigineScript)
forloop(initial_instruction; maximum_value; step) { 
	// some_code;
}
				

Parts

  • initial_instruction is executed before the first loop iteration starts.
  • maximum_value is an expression.
  • step is an expression. step can be omitted, it is 1 by default.
Notice
The loop counter of forloop must always increase, so step must be a positive value or you will get stuck in an infinite loop.

Examples

  • Common form:
    Source code (UnigineScript)
    forloop(int i = 0; 10; 2) {
    	log.message("%d ",i);
    }
    
    //the output is: 0 2 4 6 8
  • Reduced form:
    Source code (UnigineScript)
    int stop = 10;
    
    forloop(int i = 0; stop) {
    	log.message("%d ",i);
    }
    
    //the result is: 0 1 2 3 4 5 6 7 8 9
  • Another way to use forloop:
    Source code (UnigineScript)
    class Foo {
    	int a = 10;
    	int foo() { return a; }
    };
    
    int a = 10;
    Foo f = new Foo();
    
    forloop(int i = 0; f.foo() + 1) {
    	log.message("%d ",i);
    }
    
    //the output is: 0 1 2 3 4
Last update: 2017-07-03