Wormbo: New page: The '''break''' statement can be used within do, while, for and foreach loops and within switch blocks. Its effect is, that it immediately exits the inner-most surround...

2008-10-23T14:44:24Z

New page: The '''break''' statement can be used within do, while, for and foreach loops and within switch blocks. Its effect is, that it immediately exits the inner-most surround...

New page

The '''break''' statement can be used within [[do]], [[while]], [[for]] and [[foreach]] loops and within [[switch]] blocks. Its effect is, that it immediately exits the inner-most surrounding loop or switch block.

==Syntax==
It's as simple as it can get:
'''break;'''
That's all. Just "break" and a semicolon.

==Examples==
When you use the '''break''' statement, you'll usually do it in the following way:
<uscript>
while (/* condition */) {
// some code

if (/* required condition */)
break;

// more code
}
// break jumps here
</uscript>

In nested loops, '''break''' only exits the inner-most loop:
<uscript>
for (i = 0; i < 10; i++) {
for (j = 0; i < 10; j++) {
if (j > 5)
break;
}
// break jumps here!
}
</uscript>
Note that UnrealScript provides no way to specify the loop to exit. It ''always'' exits the inner-most loop or switch.

Sometimes you want to look for a single instance of a certain type of actor, for example a GameReplicationInfo:
<uscript>
local GameReplicationInfo GRI;

foreach AllActors(class'GameReplicationInfo', GRI)
break;
</uscript>
The ''AllActors'' iterator is canceled early here. This means, if there's any actor of class GameReplicationInfo, it'll end up being in the GRI variable. Without the '''break''' statement, the ''AllActors'' iterator would not only not stop at the first GameReplicationInfo. Additionally, the final content of the GRI variable is not defined. It might be the last GameReplicationInfo found, but it could also be [[None]]! The behavior depends on the implementation of the iterator function.

{{navbox unrealscript}}

Break statement - Revision history

Wormbo: New page: The '''break''' statement can be used within do, while, for and foreach loops and within switch blocks. Its effect is, that it immediately exits the inner-most surround...