🚀 Add loop-counter & Improve loops

[AyhamAl-Ali]

Description

This PR adds a new feature to loops

• Add loop-(counter|iteration)[-X] for both normal and while loop
• Improve performance for ExprLoopValue (regex pattern)
• Add Loop interface (see use in code)
• Improve examples
• Improve related classes that uses SecLoop and SecWhile checks such as EffExit and EffReturn

Usage example:

while player is online:
    give player 1 stone
    wait 5 ticks
    if loop-counter > 30:
        stop loop

loop {top-balances::*}:
    if loop-iteration <= 10:
        broadcast "##%loop-iteration% %loop-index% has $%loop-value%"

Test Code:

on command:
	loop 2 times:
		loop 2 times:
			loop 2 times:
				broadcast "&a%loop-counter-1% - &c%loop-counter-2% - &b%loop-counter-3%"

	broadcast "------------------"

	add "a" and "b" to {_1::*} and {_2::*} and {_3::*}
	loop {_1::*}:
		loop {_2::*}:
			loop {_3::*}:
				broadcast "&a%loop-value-1% - &c%loop-value-2% - &b%loop-value-3%"

Showcase

Thanks to TPGamesNL for helping me with this

---

Target Minecraft Versions: Any
Requirements: None
Related Issues:

• [SUGGESTIONS] Add failure limit to while loops #4126
• proposal loop-iteration / loop-increment[ation] on loop %objects% and while %condition% #1549
• Suggestion: "loop-number" expression for all types of loops #862

[AyhamAl-Ali]

Converting to Draft as this is still in progress to support outer loops and look into a while loop bug that is mentioned in the second commit message

[Pikachu920]

honestly, I'm not sure if I like the syntax or concept . I think @FranKusmiruk's idea of iteration count is a better fit

[AyhamAl-Ali]

That syntax is up-for-debate, the original idea was to shorten this to 1 line instead of using something like this

while 1 = 1:
    # code
    if iteration count > 30:
        exit loop

[Moderocky]

while 1 = 1:
    # code
    if iteration count > 30:
        exit loop

That is a better alternative, but remember it would need to support multiple loops like loop-value-n does.

[AyhamAl-Ali]

while 1 = 1:
    # code
    if iteration count > 30:
        exit loop

That is a better alternative, but remember it would need to support multiple loops like loop-value-n does.

Yes, that's why it's in draft right now 👌

[Moderocky]

Coming back to this, I think the iteration count syntax should be while-number to go with loop-number. Nested while loops could use while-number-X.
This ought to make it simpler for users.

[AyhamAl-Ali]

Coming back to this, I think the iteration count syntax should be while-number to go with loop-number. Nested while loops could use while-number-X. This ought to make it simpler for users.

This can be an alternative syntax, because the purpose has become a bit bigger, the iteration count should also work for loops like

loop {top-players::*}:
    iteration count <= 10
    # code