Identifier: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (fixed link to Category:Scripting Commands)
(Quick drive-by edit: Added TOC, small text and format improvements)
Line 1: Line 1:
An '''identifier''' is a name given to a [[Variables|variable]] that the scripter can choose: It is the name that ''identifies'' the variable.
{{TOC|side}}


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 ==
Line 18: Line 19:
|}
|}
Binding rules for identifiers:
Binding rules for identifiers:
* Identifiers may consist of any ASCII text characters (a-z, A-Z), numbers (0-9) and underscores (_)
* 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 '''must not''' start with a number (e.g "9myVariable" is invalid).
* Identifiers of [[Variables|local variables]] '''must''' start with an underscore
* Identifiers of [[Variables|local variables]] '''must''' start with an underscore.
* 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:
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>
<code>[[private]] _myVariableName = 5;</code>
Line 36: Line 35:
A less encountered naming format is separating all sub-words with underscores:
A less encountered naming format is separating all sub-words with underscores:
<code>_my_variable_name = 5;</code>
<code>_my_variable_name = 5;</code>


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




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

Revision as of 15:35, 30 December 2020

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

Rules

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;

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;

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

See also