comment: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Some wiki formatting)
 
(86 intermediate revisions by 22 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofpr |= Game name
|game1= ofp
|version1= 1.85


|1.85|= Game version
|game2= ofpe
____________________________________________________________________________________________
|version2= 1.00


| Define a comment. Mainly used in a [[Function]], as you're able to introduce comment lines with semicolons in a  [[Script]]. |= Description
|game3= arma1
____________________________________________________________________________________________
|version3= 1.00


| '''comment''' comment |= Syntax
|game4= arma2
|version4= 1.00


|p1= comment: [[String]] - the comment that you'd like to write here |= Parameter 1
|game5= arma2oa
|version5= 1.50


| [[Nothing]] |= Return value
|game6= tkoh
____________________________________________________________________________________________
|version6= 1.00
 
|x1= script.sqs <pre>comment "This is a commented line"</pre> |= Example 1
|x2= function.sqf <pre>comment "This is a commented line";</pre> |= Example 2
____________________________________________________________________________________________


| |= See also
|game7= arma3
|version7= 0.50


|gr1= Strings
|descr= Defines a comment. See {{Link|SQF Syntax#Comments}} to learn more about comments.
{{Feature|warning|
This command is evaluated during execution, and as such is infinitely slower than other SQF comment methods (<sqf inline>// comment</sqf> or <sqf inline>/* comment */</sqf>) which get preprocessed and do not exist at runtime).
See [[SQF Syntax|SQF Syntax]] for additional documentation on comments.
}}
{{Feature|informative|
This command is only used to place comments in unpreprocessed codes, such as trigger On Activation field, object init field, etc.
Alternatively, one can use a plain string followed by a semicolon as a way to comment; e.g <sqf inline>"Some comment";</sqf>.
}}
}}


<h3 style="display:none">Notes</h3>
|s1= [[comment]] text
<dl class="command_description">
 
<!-- Note Section BEGIN -->
|p1= text: [[String]] - the comment
<dd class="notedate">Posted on December 17, 2006 - 19:13</dd>
 
<dt class="note">'''[[User:Pennywise|Pennywise]]'''</dt><dd class="note">ArmA 1.0-1.2 brackets, {}, can no longer be used with comment. The following examples, which worked in OFP, no long work for ArmA:
|r1= [[Nothing]]
* comment {string...};  
 
* comment { CoC Network Service 2.0
|x1= In a preprocessed SQF script (e.g. when doing <sqf inline>execVM "myScript.sqf"</sqf>)
            CoC bn880 28/02/2004; example comment};
<sqf>
[[User:Pennywise|Pennywise]] 08:23, 17 December 2006 (CET)</dd>
comment "This is a commented line"; // bad
"This is a commented line"; // slightly better
// This is a commented line // perfect
</sqf>
 


<!-- Note Section END -->
|x2= In an object init field (in editor):
</dl>
<sqf>
comment "This comment works";
"This comment works too";
// This doesn't work
/* This doesn't work either */
</sqf>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[Control Structures]]
}}


[[Category:Scripting Commands|COMMENT]]
{{Note
[[Category:Scripting Commands OFP 1.96|COMMENT]]
|user= Tom_48_97
[[Category:Scripting Commands ArmA|COMMENT]]
|timestamp= 20090912195000
|text= Like {{arma1}}, you can not use brackets to make a multi-lines comment. But, in a sqf file, you can make a comment as follow :
<sqf>
comment "
first line
seconde line";
</sqf>
}}

Latest revision as of 19:56, 7 April 2024

Hover & click on the images for description

Description

Description:
Defines a comment. See SQF Syntax - Comments to learn more about comments.
This command is evaluated during execution, and as such is infinitely slower than other SQF comment methods (// comment or /* comment */) which get preprocessed and do not exist at runtime). See SQF Syntax for additional documentation on comments.
This command is only used to place comments in unpreprocessed codes, such as trigger On Activation field, object init field, etc. Alternatively, one can use a plain string followed by a semicolon as a way to comment; e.g "Some comment";.
Groups:
Strings

Syntax

Syntax:
comment text
Parameters:
text: String - the comment
Return Value:
Nothing

Examples

Example 1:
In a preprocessed SQF script (e.g. when doing execVM "myScript.sqf")
comment "This is a commented line"; // bad "This is a commented line"; // slightly better // This is a commented line // perfect
Example 2:
In an object init field (in editor):
comment "This comment works"; "This comment works too"; // This doesn't work /* This doesn't work either */

Additional Information

See also:
Control Structures

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
Tom_48_97 - c
Posted on Sep 12, 2009 - 19:50 (UTC)
Like Armed Assault, you can not use brackets to make a multi-lines comment. But, in a sqf file, you can make a comment as follow :
comment " first line seconde line";