player-03 / classic-for

A library that enables C-style for loops within Haxe.

Classic "for"

A library that enables C-style for loops within Haxe.

Usage

class Example implements ClassicFor {
    public static function add1To10():Int {
        var sum:Int = 0;
        
        @for(var i:Int = 1, i <= 10, i++) {
            sum += i;
        }
        
        return sum;
    }
}

To enable this feature in all of your classes at once, add the following command-line argument:

--macro addGlobalMetadata("com.your.package.here", "@:build(ClassicFor.build())")

In Lime/OpenFL, this would be one of the following:

<haxeflag name="--macro" value="addGlobalMetadata('com.your.package.here', '@:build(ClassicFor.build())')'" />
<haxeflag name="--macro" value="addGlobalMetadata('${ APP_PACKAGE }', '@:build(ClassicFor.build())')'" />

In the former case, you have to type out your package name. The latter is more convenient, but it only works if you define your package using the <meta /> tag, not the <app /> tag.

Notes

• Haxe does not allow semicolons between parentheses, so it is not possible to use the exact same syntax as C.
• If you provide exactly three loop arguments, the macro will treat the loop exactly like a for loop in C. For any other number, it will be forced to guess what the arguments mean.
  • When guessing, the macro searches for an argument that appears to be a boolean expression (or, failing that, one that isn't an assignment). Everything before this argument will be treated as initialization code, running only once at the beginning. Everything after will be treated as increment code, running at the end of each iteration.
  • If no boolean expression is found, the loop will repeat until a break statement is reached.