breakOut: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Bot: Replacing category Scripting Commands Arma 3 with Arma 3: Scripting Commands)
m (Text replacement - "<sqf>([^↵][^<]*↵[^<]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(72 intermediate revisions by 5 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 the code execution out of scope {} named ''name''. [[nil]] is returned. Scope name can be assigned using [[scopeName]] command.
|game3= arma2oa
|version3= 1.50


<br><br>
|game4= tkoh
Since Arma 3 v1.47, [[breakOut]] can be used to return a ''value''. It is the closest SQF comes to having "return" like operation. |= Description
|version4= 1.00
____________________________________________________________________________________________


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


|p1= name: [[String]] - name of the scope (previously set with [[scopeName]]) |= Parameter 1
|gr1= Program Flow


| [[Nothing]] |= Return value
|descr= Breaks out of the [[Variables#Scopes|scope]] with given '''name'''.
* An unknown [[scopeName]] name will cause the script error {{hl|Generic error in expression}}
* If multiple scopes with the same '''name''' exist, the command will break out the nearest scope. See {{Link|#Example 3}}.


| s2= value '''breakOut''' name &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (''since Arma 3 v1.47'') |= Syntax
|s1= [[breakOut]]  name


|p21= value: [[Anything]] - a value to return |= Parameter 1
|p1= name: [[String]] - name of the scope which was previously set with [[scopeName]]. <sqf inline>""</sqf> will exit the current scope (see also [[exitWith]])
|p22= name: [[String]] - name of the scope (previously set with [[scopeName]]) |= Parameter 1


| r2= [[Anything]] |= Return value
|r1= [[Nothing]]


|x1= <code>[[scopeName]] "main";
|s2= value [[breakOut]] name
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;
};
</code> |= Example 1


|x2= <code>[[call]] {
|s2since= arma3 1.48
[[scopeName]] "main";
[[call]] {
123 [[breakOut]] "main"
};
345
}; // call returns 123</code> |= Example 2
____________________________________________________________________________________________


| [[scopeName]], [[breakTo]], [[exitWith]] |= See also
|p21= value: [[Anything]] - a value to return


}}
|p22= name: [[String]] - name of the scope which was previously set with [[scopeName]]. <sqf inline>""</sqf> will exit the current scope (see also [[exitWith]])


<h3 style="display:none">Notes</h3>
|r2= [[Anything]] - will return '''value'''
<dl class="command_description">
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on 19 Aug, 2008
<dt class="note">'''[[User:Alef|alef]]'''<dd class="note">
When "name" is nil, the command is ignored.<br>
When "name" is an undefined scope name or "", the script quits current scope.
<code>if (true) then {
hint "1";
breakOut nil;
hint "2";
}; //result "2"


if (true) then {
|x1= <sqf>
hint "1";
scopeName "main";
breakOut "";
while { true } do {
hint "2";
scopeName "loop1";
}; //result "1"
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;
};
</sqf>


if (true) then {
|x2= <sqf>
hint "1";
call {
breakOut "dskfhdsklfh";
scopeName "main";
hint "2";
call {
}; //result "1"
123 breakOut "main"
</code>
};
345
}; // call returns 123
</sqf>


<!-- Note Section END -->
|x3= <sqf>
</dl>
call {
 
scopeName "Main"; // Parent Main
<h3 style="display:none">Bottom Section</h3>
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on August 27, 2015 - 16:09 (UTC)</dd>
<dt class="note">[[User:Polaris|Polaris]]</dt>
<dd class="note">
breakOut can still be used if multiple scopes share identical names. It will simply break out of the nearest scope that matches the name parameter you've used. For example:
<code>call {
scopeName "Main"; //Parent Main
call {
call {
scopeName "Main"; //Child Main
scopeName "Main"; // Child Main
"String" breakOut "Main"; //Will break out of child main and return "String" to parent main
"String" breakOut "Main"; // Will break out of child main and return "String" to parent main
};
};
};
};
</code>
</sqf>
Therefore you are able to consistently reuse scope names such as "Main", "Child", "Primary", "Secondary", etc throughout functions without worrying about having to ensure you create unique names for each scope.
</dd>
</dl>
<!-- DISCONTINUE Notes -->


[[Category:Scripting Commands|BREAKOUT]]
|seealso= [[scopeName]] [[breakTo]] [[exitWith]]
[[Category:Scripting Commands ArmA|BREAKOUT]]
}}
[[Category:Scripting Commands ArmA2|BREAKOUT]]
[[Category:Command Group: Variables|{{uc:{{PAGENAME}}}}]]
[[Category:Command Group: Program Flow|{{uc:{{PAGENAME}}}}]]
[[Category:Arma 3: Scripting Commands]]
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 19:42, 3 September 2024

Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
Breaks out of the scope with given name.
  • An unknown scopeName name will cause the script error Generic error in expression
  • If multiple scopes with the same name exist, the command will break out the nearest scope. See Example 3.
Groups:
Program Flow

Syntax

Syntax:
breakOut name
Parameters:
name: String - name of the scope which was previously set with scopeName. "" will exit the current scope (see also exitWith)
Return Value:
Nothing

Alternative Syntax

Syntax:
value breakOut name
Parameters:
value: Anything - a value to return
name: String - name of the scope which was previously set with scopeName. "" will exit the current scope (see also exitWith)
Return Value:
Anything - will return value

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; };
Example 2:
call { scopeName "main"; call { 123 breakOut "main" }; 345 }; // call returns 123
Example 3:
call { scopeName "Main"; // Parent Main call { scopeName "Main"; // Child Main "String" breakOut "Main"; // Will break out of child main and return "String" to parent main }; };

Additional Information

See also:
scopeName breakTo 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
Retrieved from "https://community.bistudio.com/wiki?title=breakOut&oldid=369282"