BIS fnc onLoad: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<br />" to "<br>")
m (Text replacement - "<code>([^<]+)<\/code>" to "<sqf>$1</sqf>")
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Function|= Comments
{{RV|type=function
____________________________________________________________________________________________


| tkoh |Game name=
|game1= tkoh
|version1= 1.00


|1.00|Game version=
|game2= arma3
____________________________________________________________________________________________
|version2= 0.50


| Register code to be executed after a mission load (from a save, for example).
|gr1= Event Handlers
{{Important|Replaced by [[Arma 3: Event Handlers/addMissionEventHandler#Loaded|"loaded" mission event handler]].<br>
This function now exists only because of backward compatibility}} |Description=
____________________________________________________________________________________________


| parameter call [[BIS_fnc_onLoad]] |Syntax=
|descr= Register code to be executed after a mission load (from a save, for example).
{{Feature|important|Replaced by [[Arma 3: Mission Event Handlers#Loaded|"loaded" mission event handler]].<br>
This function now exists only because of backward compatibility}}
 
|s1= parameter call [[BIS_fnc_onLoad]]


|p1= parameter: [[Code]] or [[Number]]:
|p1= parameter: [[Code]] or [[Number]]:
* [[Code]] - code to be executed on mission load
* [[Code]] - code to be executed on mission load
* [[Number]] - index of code to remove
* [[Number]] - index of code to remove
&nbsp; |Parameter 1=
&nbsp;


| [[Number]] - index of onLoad code |Return value=
|r1= [[Number]] - index of onLoad code
____________________________________________________________________________________________


|x1= <code>_codeIndex = { [[hint]] "Welcome back!"; } [[call]] [[BIS_fnc_onLoad]];</code> |Example 1=
|x1= <sqf>private _codeIndex = { hint "Welcome back!"; } call BIS_fnc_onLoad;</sqf>


|x2= <code>0 [[call]] [[BIS_fnc_onLoad]]; {{codecomment|// removes code with index 0}}</code> |Example 2=
|x2= <sqf>0 call BIS_fnc_onLoad; // removes code with index 0</sqf>
____________________________________________________________________________________________


| [[Arma 3: Event Handlers/addMissionEventHandler|Mission Event Handlers]], [[addMissionEventHandler]] |See also=
|seealso= [[Arma 3: Mission Event Handlers|Mission Event Handlers]] [[addMissionEventHandler]]
}}
}}
<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Function Group: Misc|{{uc:onLoad}}]]
[[Category:Functions|{{uc:onLoad}}]]
[[Category:{{Name|tkoh}}: Functions|{{uc:onLoad}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:onLoad}}]]

Latest revision as of 17:11, 13 July 2022

Hover & click on the images for description

Description

Description:
Register code to be executed after a mission load (from a save, for example).
Replaced by "loaded" mission event handler.
This function now exists only because of backward compatibility
Execution:
call
Groups:
Event Handlers

Syntax

Syntax:
parameter call BIS_fnc_onLoad
Parameters:
parameter: Code or Number:
  • Code - code to be executed on mission load
  • Number - index of code to remove
 
Return Value:
Number - index of onLoad code

Examples

Example 1:
private _codeIndex = { hint "Welcome back!"; } call BIS_fnc_onLoad;
Example 2:
0 call BIS_fnc_onLoad; // removes code with index 0

Additional Information

See also:
Mission Event Handlers addMissionEventHandler

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