Code: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (sectioned off, updated intro slight)
m (Some wiki formatting)
 
(12 intermediate revisions by 7 users not shown)
Line 1: Line 1:
==Introduction==
'''Code''' represents data consisting of commands and their parameters. The contents of [[SQF Syntax|SQF]] and [[SQS Syntax|SQS]] files, for example are 'Code'.
In turn, it can also be the case that one of the scripting commands gets passed further scripting commands, e.g.
<sqf inline>while { code } do { code }; unit addEventHandler ["EventHandlerType", { code }]; onMapSingleClick "Code"</sqf>.


The '''Code''' type was introduced into with [[ArmA|Armed Assault]], type '''Code''' does not refer to ''Cold War Crisis'' or ''Resistance''. In previous versions it was a prefered style to write such strings in curled braces, but it was not required. With ArmA functions that are marked as requiring '''Code''' must be presented with curled braces.
Code literals (or code '''blocks''') are usually represented by enclosing text into curly braces: <sqf inline>{</sqf> and <sqf inline>}</sqf>.
Any such code is precompiled by the script engine. Sometimes it may become necessary to first read in certain commands as [[String]].
In order to convert code from data type String into data type Code, the command [[compile]] can be used. See [[Code vs. Strings]] for more information on code data typing.




==Description==
== Examples ==


Part of code (compiled), in curled braces:
<sqf>{ _x setDamage 1 } forEach ArrayToKill</sqf>
<sqf>
private _codeToExecute = { hint "it works!" };
private _codeStr = toString _codeToExecute; // ' hint "it works!" '


call _codeToExecute; // identical to
call compile _codeStr;
</sqf>


==Examples==


'''{'''_x [[setDamage]] 1'''}''' [[forEach]] ArrayToKill
[[Category: Data Types]]
 
 
 
[[Category: Types]]

Latest revision as of 14:41, 14 November 2023

Code represents data consisting of commands and their parameters. The contents of SQF and SQS files, for example are 'Code'. In turn, it can also be the case that one of the scripting commands gets passed further scripting commands, e.g. while { code } do { code }; unit addEventHandler ["EventHandlerType", { code }]; onMapSingleClick "Code".

Code literals (or code blocks) are usually represented by enclosing text into curly braces: { and }. Any such code is precompiled by the script engine. Sometimes it may become necessary to first read in certain commands as String. In order to convert code from data type String into data type Code, the command compile can be used. See Code vs. Strings for more information on code data typing.


Examples

{ _x setDamage 1 } forEach ArrayToKill
private _codeToExecute = { hint "it works!" }; private _codeStr = toString _codeToExecute; // ' hint "it works!" ' call _codeToExecute; // identical to call compile _codeStr;