Identifier: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (removed toc)
m (Text replacement - "[[OFPEC tags" to "[[Scripting Tags")
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
An [[Identifier]] is the name given to a [[Variables|variable]] that the scripter can choose: It is the name that ''identifies'' the variable.
An [[Identifier]] is the name given to a [[Variables|variable]] that the scripter can choose: It is the name that ''identifies'' the variable.


== Rules ==
== Rules ==
{| class="wikitable" style="float: right; margin-left: 1em"
{| class="wikitable float-right"
! Valid !! Invalid
|+ Regex: {{hl|[a-zA-Z_][a-zA-Z0-9_]*}}
! Valid
! Invalid
|-
|-
|
|
Line 24: Line 25:
* Identifiers are '''case-insensitive'''.
* Identifiers are '''case-insensitive'''.
* Identifiers '''cannot be the same as reserved words''' (e.g [[:Category:Scripting Commands|commands]] and [[:Category:Functions|functions]]).
* Identifiers '''cannot be the same as reserved words''' (e.g [[:Category:Scripting Commands|commands]] and [[:Category:Functions|functions]]).


== Recommendations ==
== Recommendations ==
It is recommended to write '''local variable identifiers''' in {{Wikipedia|Camel_case|camel case}} syntax. This makes identifiers more readable:
<code>[[private]] _myVariableName = 5;</code>


It is also recommended to prefix '''global variable identifiers''' with '''your''' [[OFPEC tags|tag]] in order to avoid any potential conflict between addons, scripts and missions:
It is recommended to write '''local variable identifiers''' in {{Link|https://en.wikipedia.org/wiki/Camel_case|camel case}} syntax. This makes identifiers more readable:
<code>{{cc|<span style{{=}}"color: purple; font-weight: bold">Tag</span>_identifier}}
<sqf>private _myVariableName = 5;</sqf>
<span style="color: purple; font-weight: bold">UNIQUETAG</span>_player = [[player]];</code>
 
{{Feature|important|
{{Link|https://en.wikipedia.org/wiki/Snake_case}} is sometimes encountered but is not recommended and should be avoided:
<sqf>_my_variable_name = 5;</sqf>
}}
 
 
It is also recommended to prefix '''global variable identifiers''' with '''your''' [[Scripting Tags|tag]] in order to avoid any potential conflict between addons, scripts and missions:
{{cc|'''{{Color|purple|Tag}}'''_identifier}}
<span style="color: purple; font-weight: bold">UNIQUETAG</span>_player = [[player]];
 


A less encountered naming format is separating all sub-words with underscores:
<code>_my_variable_name = 5;</code>


== See also ==
== See also ==
* [[Variables]]
* [[Variables]]




[[Category: Syntax]]
[[Category: Syntax]]

Latest revision as of 12:01, 2 October 2024

An Identifier is the name given to a variable that the scripter can choose: It is the name that identifies the variable.

Rules

Regex: [a-zA-Z_][a-zA-Z0-9_]*
Valid Invalid
  • variable1
  • _my_local_variable
  • _1variable
  • _player
  • 1variable
  • _my#localVar
  • _guy1&2var
  • player

Binding rules for identifiers:

  • Identifiers may consist of any ASCII text characters (a-z, A-Z), numbers (0-9) and underscores (_).
  • Identifiers must not start with a number (e.g "9myVariable" is invalid).
  • Identifiers of local variables must start with an underscore.
  • Identifiers are case-insensitive.
  • Identifiers cannot be the same as reserved words (e.g commands and functions).


Recommendations

It is recommended to write local variable identifiers in camel case syntax. This makes identifiers more readable:

private _myVariableName = 5;

Snake case is sometimes encountered but is not recommended and should be avoided:
_my_variable_name = 5;


It is also recommended to prefix global variable identifiers with your tag in order to avoid any potential conflict between addons, scripts and missions:

// Tag_identifier
UNIQUETAG_player = player;


See also