breakTo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Text replacement - "Nelis.75733126" to "Nelis75733126")
 
(72 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= arma1
|version1= 1.00


|1.00|= Game version
|game2= arma2
____________________________________________________________________________________________
|version2= 1.00


| Breaks block to scope named '''name'''. Nil is returned.
|game3= arma2oa
|version3= 1.50


Scope name can be assigned using [[scopeName]] command. |= Description
|game4= tkoh
____________________________________________________________________________________________
|version4= 1.00


| '''breakTo''' name |= Syntax
|game5= arma3
|version5= 0.50


|p1= name: [[String]] |= Parameter 1
|gr1= Program Flow


| [[Nothing]] |= Return value
|descr= Breaks block to scope named ''name''.


|x1= <code>[[scopeName]] "main";
Scope name can be assigned using the [[scopeName]] command.
while {[[true]]} do {
 
[[scopeName]] "loop1";
|s1= [[breakTo]] name
while {[[true]]} do {
 
[[scopeName]] "loop2";
|p1= name: [[String]]
if (condition1) then {[[breakTo]] "main"}; // Breaks all scopes and return to "main"
 
if (condition2) then {[[breakOut]] "loop2"}; // Breaks scope named "loop2"
|r1= [[Nothing]]
[[sleep]] 1;
 
|x1= <sqf>
scopeName "main";
while { true } do
{
scopeName "loop1";
while { true } do
{
scopeName "loop2";
if (condition1) then { breakTo "main" }; // breaks all scopes and return to "main"
if (condition2) then { breakOut "loop2" }; // breaks scope named "loop2"
sleep 1;
};
};
[[sleep]] 1;
sleep 1;
};
};
</code> |= Example 1
</sqf>
____________________________________________________________________________________________
 
| [[scopeName]], [[breakOut]] |= See also


|seealso= [[scopeName]] [[breakOut]] [[exitWith]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= Nelis75733126
<!-- Note Section BEGIN -->
|timestamp= 20170518181900
|text= I wish to clarify the behaviour of this command by saying that the <sqf inline>breakTo</sqf> command will literally break the scope in which it has been placed, and continue reading whatever is after and outside of that scope.<br>
Example:
<sqf>
scopeName "something";
if true then
{
breakTo "something";
_v = 0; // this line will be skipped
};


<!-- Note Section END -->
_a = 0; // this is where script execution will jump to.
</dl>
</sqf>
 
}}
<h3 style="display:none">Bottom Section</h3>
 
[[Category:Scripting Commands|BREAKTO]]
[[Category:Scripting Commands ArmA|BREAKTO]]
[[Category:Command_Group:_Variables|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Program_Flow|{{uc:{{PAGENAME}}}}]]

Latest revision as of 15:38, 29 June 2024

Hover & click on the images for description

Description

Description:
Breaks block to scope named name. Scope name can be assigned using the scopeName command.
Groups:
Program Flow

Syntax

Syntax:
breakTo name
Parameters:
name: String
Return Value:
Nothing

Examples

Example 1:
scopeName "main"; while { true } do { scopeName "loop1"; while { true } do { scopeName "loop2"; if (condition1) then { breakTo "main" }; // breaks all scopes and return to "main" if (condition2) then { breakOut "loop2" }; // breaks scope named "loop2" sleep 1; }; sleep 1; };

Additional Information

See also:
scopeName breakOut exitWith

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Nelis75733126 - c
Posted on May 18, 2017 - 18:19 (UTC)
I wish to clarify the behaviour of this command by saying that the breakTo command will literally break the scope in which it has been placed, and continue reading whatever is after and outside of that scope.
Example:
scopeName "something"; if true then { breakTo "something"; _v = 0; // this line will be skipped }; _a = 0; // this is where script execution will jump to.