Identifier: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Some wiki formatting)
m (Fix Wikipedia link)
Line 29: Line 29:
== Recommendations ==
== Recommendations ==


It is recommended to write '''local variable identifiers''' in {{Wikipedia|Camel case|camel case}} syntax. This makes identifiers more readable:
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:
<sqf>private _myVariableName = 5;</sqf>
<sqf>private _myVariableName = 5;</sqf>


{{Feature|important|
{{Feature|important|
{{Wikipedia|Snake case}} is sometimes encountered but is not recommended and should be avoided:
{{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>
<sqf>_my_variable_name = 5;</sqf>
}}
}}

Revision as of 23:49, 23 February 2023

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