Scripting:Syntax

2010-11-04T19:13:11Z

Glest Durnham: /* Loops */

Scripting:Syntax

2010-11-04T19:12:50Z

Glest Durnham: /* Loops */

Scripting:Operators

2010-09-20T12:37:13Z

Glest Durnham: /* Precedence */

[[Category:Scripting]]
{{ScriptingMenu}}

== Table ==
In this section, a and b represent either literal values, object references or expressions evaluating to the appropriate type.

=== String operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Concatenation || a & b
|}

=== Comparison operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Equals || a = b
|-
| References equal || a Is b
|-
| Not equal to || a <> b
|-
| Greater than || a > b
|-
| Less than || a = b
|-
| Less than or equal to || a <= b
|}

=== Arithmetic operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Assignment || a = b
|-
| Addition || a + b
|-
| Subtraction || a - b
|-
| Multiplication || a * b
|-
| Division || a / b
|-
| Increment || a++
|-
| Increment || ++a
|-
| Decrement || a--
|-
| Decrement || --a
|}

=== Logical operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Logical NOT || NOT a
|-
| Logical AND || a AND b
|-
| Logical OR || a OR b
|}

=== Other operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Function call || a()
|-
| Function reference || AddressOf a
|-
| Member (b of a) || a.b
|}

== Precedence ==

The exact operator precedence is unknown. However, the following order of precedence seems to apply:

* Member, Function call
* Increment, Decrement
* Multiplication
* Addition, Subtraction
* Comparison
* Logical NOT
* Logical OR, Logical AND
* Assignment

Operators with the same precedence seem to be applied from left to right. Keep in mind that the logical AND and OR are lazy. That is, if the left argument already dictates the outcome, the right argument is not evaluated. This is mainly important for arguments with side effects, such as function calls or the increment/decrement operators. It can also prevent referencing a NULL reference.

== Notes ==

=== Assignment operator v.s. equals operator ===

The {{code | assignment}} operator and the {{code | equals}} operator use the same symbol. It depends on the context which operator is used. The {{code | assignment}} operator is used when a line of code follows the syntax {{code | Identifier {{=}} Value;}}. In all other cases, the {{code | equals}} operator is used.

=== Increment and decrement operators ===

There are two versions of the increment and decrement operators, namely the suffix and the prefix versions. The suffix versions increment or decrements the value hold by the identifier and then returns the old value. The prefix versions increment or decrement the value and return the result.

For example:
Var i As Integer = 5;
WriteLine(i++); // Writes 5
WriteLine(i); // Writes 6
WriteLine(i--) // Writes 6
WriteLine(i); // Writes 5

i = 5;
WriteLine(++i); // Writes 6
WriteLine(i); // Writes 6
WriteLine(--i); // Writes 5
WriteLine(i); // Writes 5

=== References equal ===

The {{code | References equal}} operator returns true if both identifiers hold the same reference (or: point to the same object).

For example:
Var i As String = "a";
Var j As String = "a";
WriteLine(i Is j); // false

i = j;
WriteLine(i Is j); // true

For types defined as Struct in the Object Explorer, this operator will never return true. When assigning one struct variable to another, the value is copied instead of the reference.

=== AddressOf ===

The {{code | AddressOf}} operator actually returns a CDelegate instance.

An example:
Var Delegate As CDelegate = AddressOf MyFunction;

Function MyFunction() {
WriteLine("Hello universe!");
}

Delegate.Invoke(); // Writes "Hello universe!";

Scripting:Operators

2010-09-20T12:34:50Z

Glest Durnham:

[[Category:Scripting]]
{{ScriptingMenu}}

== Table ==
In this section, a and b represent either literal values, object references or expressions evaluating to the appropriate type.

=== String operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Concatenation || a & b
|}

=== Comparison operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Equals || a = b
|-
| References equal || a Is b
|-
| Not equal to || a <> b
|-
| Greater than || a > b
|-
| Less than || a = b
|-
| Less than or equal to || a <= b
|}

=== Arithmetic operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Assignment || a = b
|-
| Addition || a + b
|-
| Subtraction || a - b
|-
| Multiplication || a * b
|-
| Division || a / b
|-
| Increment || a++
|-
| Increment || ++a
|-
| Decrement || a--
|-
| Decrement || --a
|}

=== Logical operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Logical NOT || NOT a
|-
| Logical AND || a AND b
|-
| Logical OR || a OR b
|}

=== Other operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Function call || a()
|-
| Function reference || AddressOf a
|-
| Member (b of a) || a.b
|}

== Precedence ==

The exact operator precedence is unknown. However, the following order of precedence seems to apply:

[*] Member, Function call
[*] Increment, Decrement
[*] Multiplication
[*] Addition, Subtraction
[*] Comparison
[*] Logical NOT
[*] Logical OR, Logical AND
[*] Assignment

Operators with the same precedence seem to be applied from left to right. Keep in mind that the logical AND and OR are lazy. That is, if the left argument already dictates the outcome, the right argument is not evaluated. This is mainly important for arguments with side effects, such as function calls or the increment/decrement operators. It can also prevent referencing a NULL reference.

== Notes ==

=== Assignment operator v.s. equals operator ===

The {{code | assignment}} operator and the {{code | equals}} operator use the same symbol. It depends on the context which operator is used. The {{code | assignment}} operator is used when a line of code follows the syntax {{code | Identifier {{=}} Value;}}. In all other cases, the {{code | equals}} operator is used.

=== Increment and decrement operators ===

There are two versions of the increment and decrement operators, namely the suffix and the prefix versions. The suffix versions increment or decrements the value hold by the identifier and then returns the old value. The prefix versions increment or decrement the value and return the result.

For example:
Var i As Integer = 5;
WriteLine(i++); // Writes 5
WriteLine(i); // Writes 6
WriteLine(i--) // Writes 6
WriteLine(i); // Writes 5

i = 5;
WriteLine(++i); // Writes 6
WriteLine(i); // Writes 6
WriteLine(--i); // Writes 5
WriteLine(i); // Writes 5

=== References equal ===

The {{code | References equal}} operator returns true if both identifiers hold the same reference (or: point to the same object).

For example:
Var i As String = "a";
Var j As String = "a";
WriteLine(i Is j); // false

i = j;
WriteLine(i Is j); // true

For types defined as Struct in the Object Explorer, this operator will never return true. When assigning one struct variable to another, the value is copied instead of the reference.

=== AddressOf ===

The {{code | AddressOf}} operator actually returns a CDelegate instance.

An example:
Var Delegate As CDelegate = AddressOf MyFunction;

Function MyFunction() {
WriteLine("Hello universe!");
}

Delegate.Invoke(); // Writes "Hello universe!";

Abbreviations

2010-09-11T10:36:50Z

Glest Durnham: /* Loops */

Scripting:Interfaces

2010-09-11T10:34:18Z

Glest Durnham: /* ColoniePortal */

[[Category:Scripting]]
{{ScriptingMenu}}

Interfaces extend the possibilities of scripts by registering pre-defined variables.
For example, the {{code|Web}} interface provides two variables representing the HTTP request and response.
Using this interface, scripts can generate HTML output and get some information about the HTTP request.

You can use an interface in a script by going to the settings tab in the script editor and ticking the interfaces you want to use.
You can also do it manually by adding this code at the top of the script:
#UseInterface Web, ShipPortal // a comma separated list of interfaces

== Web ==
The {{code|Web}} interface provides a script with the ability to generate HTML output and to read some information about the HTTP request.

=== Registered variables ===
; {{code|Response As CWebResponse}}
: This represents the root element for your script's HTML response. By adding elements to Response, the script can generate HTML output.
; {{code|Request As CWebRequest}}
: This contains some data describing the HTTP request and some additional data added by STNE. Most notably, it contains the submitted form data.

== ShipPortal ==
The {{code|ShipPortal}} interface enables a script to be used as a ship portal.
Ship portals can be installed on a ship.
Anyone with a ship in the same sector can enter the ship's portal, and they will see the HTML output generated by the script.
By adding forms to the output you can also have the guest enter data which will be available to the script when the form is submitted.
See the 'Web' interface on details how to generate output.

The interface provides a few variables exposing on which ship the portal is running, and the user and ship that entered the portal.
It also seems to include everything the {{code|Web}} interface provides.
However, it is recommended to also include the {{code|Web}} interface whenever you include this interface.

=== Registered variables ===
; {{code|MyShip As CMyShip}}
: This is the ship the portal is running on.
; {{code|GuestShip As CShip}}
: This is the ship that the guest entered the portal from.
; {{code|GuestUser As CUser}}
: The user who entered the portal.

== ColoniePortal ==
The {{code|ColoniePortal}} interface enables a script to be used as a colony portal.
Colony portals can be installed on a colony.
Anyone with a ship in the same sector can enter the colony's portal, and they will see the HTML output generated by the script.
By adding forms to the output you can also have the guest enter data which will be available to the script when the form is submitted.
See the {{code|Web}} interface on details how to generate output.

The interface provides a few variables exposing on which ship the portal is running, and the user and ship that entered the portal.
It also seems to include everything the {{code|Web}} interface provides.
However, it is recommended to also include the {{code|Web}} interface whenever you include this interface.

=== Registered variables ===
; {{code|MyColony As CMyColony}}
: This is the colony the portal is running on.
; {{code|GuestShip As CShip}}
: This is the ship that the guest entered the portal from.
; {{code|GuestUser As CUser}}
: The user who entered the portal.

2010-09-10T16:48:23Z

Glest Durnham:

Scripting:Operators

2010-09-10T16:47:21Z

Glest Durnham:

[[Category:Scripting]]
{{ScriptingMenu}}

== Table ==
In this section, a and b represent either literal values, object references or expressions evaluating to the appropriate type.

=== String operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Concatenation || a & b
|}

=== Comparison operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Equals || a = b
|-
| References equal || a Is b
|-
| Not equal to || a <> b
|-
| Greater than || a > b
|-
| Less than || a = b
|-
| Less than or equal to || a <= b
|}

=== Arithmetic operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Assignment || a = b
|-
| Addition || a + b
|-
| Subtraction || a - b
|-
| Multiplication || a * b
|-
| Division || a / b
|-
| Increment || a++
|-
| Increment || ++a
|-
| Decrement || a--
|-
| Decrement || --a
|}

=== Logical operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Logical NOT || NOT a
|-
| Logical AND || a AND b
|-
| Logical OR || a OR b
|}

=== Other operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Function call || a()
|-
| Function reference || AddressOf a
|-
| Member b of a || a.b
|}

== Notes ==

=== Assignment operator v.s. equals operator ===

The {{code | assignment}} operator and the {{code | equals}} operator use the same symbol. It depends on the context which operator is used. The {{code | assignment}} operator is used when a line of code follows the syntax {{code | Identifier {{=}} Value;}}. In all other cases, the {{code | equals}} operator is used.

=== Increment and decrement operators ===

There are two versions of the increment and decrement operators, namely the suffix and the prefix versions. The suffix versions increment or decrements the value hold by the identifier and then returns the old value. The prefix versions increment or decrement the value and return the result.

For example:
Var i As Integer = 5;
WriteLine(i++); // Writes 5
WriteLine(i); // Writes 6
WriteLine(i--) // Writes 6
WriteLine(i); // Writes 5

i = 5;
WriteLine(++i); // Writes 6
WriteLine(i); // Writes 6
WriteLine(--i); // Writes 5
WriteLine(i); // Writes 5

=== References equal ===

The {{code | References equal}} operator returns true if both identifiers hold the same reference (or: point to the same object).

For example:
Var i As String = "a";
Var j As String = "a";
WriteLine(i Is j); // false

i = j;
WriteLine(i Is j); // true

For types defined as Struct in the Object Explorer, this operator will never return true. When assigning one struct variable to another, the value is copied instead of the reference.

=== AddressOf ===

The {{code | AddressOf}} operator actually returns a CDelegate instance.

An example:
Var Delegate As CDelegate = AddressOf MyFunction;

Function MyFunction() {
WriteLine("Hello universe!");
}

Delegate.Invoke(); // Writes "Hello universe!";

2010-09-10T16:44:00Z

Glest Durnham:

Scripting:Syntax

2010-09-10T16:42:27Z

Glest Durnham:

[[Category:Scripting|Syntax]]
__TOC__

This page describes the syntax of the STNE scripting engine.

As with C style languages, function calls, variable declarations and assignments have to be terminated by a semicolon.

== Variable declaration ==
Variables are declared using the syntax {{code|Var [VarName] As [VarType]}}. This is best illustrated with a small example:
Var WelcomeMessage As String; // Declares a variable named 'WelcomeMessage' of type String
Var DataTable As CTable; // Declares a variable named 'DataTable' of type CTable

/* It is also possible to immediately assign a value when declaring variables */

Var WelcomeMessage As String = "Hello galaxy!"; // Declares a string and assigns it a value
Var DataTable As CTable = New CTable(); // Declares a variable and assigns a newly created CTable to it
Var InfoTable As New CTable(); // Also declares a variable and assigns a newly created CTable to it, but with less code

== Conditional statements ==
It is possible to wrap code in conditional code blocks by using {{code|If}}, {{code|Else}} and {{code|ElseIf}} statements.
{{code|If}} and {{code|ElseIf}} statements are followed by a boolean expression between round brackets.
Code blocks following the {{code|If}}/{{code|Else}}/{{code|ElseIf}} statements have to be wrapped in curly brackets.

An example:
If (x <= 5) {
WriteLine("Five or less.");
}
ElseIf (x <= 10) {
WriteLine("More than five.");
WriteLine("Ten or less.");
}
Else {
WriteLine("More than ten.");
}

== Loops ==
There are a few kind of loop statements: {{code|For}}, {{code|For Each}}, {{code|While}} and {{code|Do...While}} loops.
They work similar to the equally named loops in other programming languages.

The {{code|For}} loop will increment a specified counter by a given step until a certain value is reached. The initial value, limit and step can be negative values and (negative) floating point values. If a step is omitted, the default value of 1 will be used.

The {{code|For Each}} loop iterates all elements of a class implementing the interface {{code|ICollection}}.
You can recognize classes implementing this interface by the few methods in the interface.
Note that using {{code|For Each}} on dictionaries and hash tables will loop the {{code|DictionaryEntry}} structs in the dictionary and not the keys or values.
You can however loop {{code|Dictionary.Keys}} or {{code|Dictionary.Values}} if you are only interested in either the keys or the values.
If you need both the keys and values, it is recommended to loop the {{code|DictionaryEntry}} structs.

The {{code|While}} and {{code|Do...While}} loops continue to loop while a boolean expression results in True.
The difference between the {{code|While}} and {{code|Do...While}} loops is when the boolean expression is evaluated.
{{code|While}} loops check the expression at the beginning of each iteration, {{code|Do...While}} loops check the expression at the end of each iteration.
As a result, {{code|Do...While}} loops are always executed at least once.

An example:
/* This will print each number from 0 to 10. 0 and 10 included. */
Var i As Integer;
For (i = 0 To 10) {
WriteLine(i);
}

/* This will print all even numbers from 10 to 0. 10 and 0 included, in reverse order. */
Var i As Integer;
For (i = 10 To 0 Step -2) {
WriteLine(i);
}

/* This will print the name of each ship in the SRS report of the ship with NCC 123456 */
Var MyShip As New CMyShip(123456);
Var Current As CShip;
For (Each Current In MyShip.SRS) {
WriteLine(Current.Name);
}

/* This will print each number from 0 to 10. 0 and 10 included. */
i = 0;
While (i <= 10) {
WriteLine(i++); // i++ increases i by one and returns the old value, see [[Scripting:Operators|Operators]] for details.
}

/* This will print each number from 0 to 11. 0 and 11 included! */
i = 0;
Do {
WriteLine(i++);
}
While(i <= 10)

== Functions (user defined) ==

You may define your own functions using the following syntax: {{code|Function [Name]([Param1Name] As [Param1Type], ...) As [ReturnType]}} followed by a code block wrapped in curly braces.
Functions can have zero or more parameters.
The return type is optional.
You can define multiple functions with the same name, as long as they have a different amount of parameters.
Different types of parameters is not enough for user defined functions.
Functions can return a value with the keyword {{code|Return [value];}}.
If a function has no return type, {{code|Return;}} will exit the function.

A few examples:
/* This function simply prints "Hello" */
Function WriteHello() {
WriteLine("Hello");
}

/* It is possible to defined multiple functions with the same name, if they have a different amount of parameters.
Functions without return type can use Return to quickly exit the function. */
Function WriteHello(DoSomething As Boolean) {
If (NOT DoSomething) {
Return;
}
WriteLine("Hello");
}

/* This function prints the message passed to it as the first parameter */
Function WriteMsg(Msg As String) {
WriteLine(Msg);
}

/* This function returns True if A is higher than B, False otherwise */
Function isHigher(A As Integer, B As Integer) As Boolean {
Return A > B;
}

WriteHello(); // This will now print "Hello";
WriteHello(True); // This also prints "Hello"
WriteHello(False); // This will not do anything;
WriteMsg("Hello"); // This also prints "Hello"
WriteLine(isHigher(10, 5)); // This will print "True" (the Boolean return value is implicitly cast to a String)

Scripting:Syntax

2010-09-10T16:41:57Z

Glest Durnham:

[[Category:Scripting|Syntax]]
__TOC__

This page describes the syntax of the STNE scripting engine.

As with C style languages, function calls, variable declarations and assignments have to be terminated by a semicolon (;).

== Variable declaration ==
Variables are declared using the syntax {{code|Var [VarName] As [VarType]}}. This is best illustrated with a small example:
Var WelcomeMessage As String; // Declares a variable named 'WelcomeMessage' of type String
Var DataTable As CTable; // Declares a variable named 'DataTable' of type CTable

/* It is also possible to immediately assign a value when declaring variables */

Var WelcomeMessage As String = "Hello galaxy!"; // Declares a string and assigns it a value
Var DataTable As CTable = New CTable(); // Declares a variable and assigns a newly created CTable to it
Var InfoTable As New CTable(); // Also declares a variable and assigns a newly created CTable to it, but with less code

== Conditional statements ==
It is possible to wrap code in conditional code blocks by using {{code|If}}, {{code|Else}} and {{code|ElseIf}} statements.
{{code|If}} and {{code|ElseIf}} statements are followed by a boolean expression between round brackets.
Code blocks following the {{code|If}}/{{code|Else}}/{{code|ElseIf}} statements have to be wrapped in curly brackets.

An example:
If (x <= 5) {
WriteLine("Five or less.");
}
ElseIf (x <= 10) {
WriteLine("More than five.");
WriteLine("Ten or less.");
}
Else {
WriteLine("More than ten.");
}

== Loops ==
There are a few kind of loop statements: {{code|For}}, {{code|For Each}}, {{code|While}} and {{code|Do...While}} loops.
They work similar to the equally named loops in other programming languages.

The {{code|For}} loop will increment a specified counter by a given step until a certain value is reached. The initial value, limit and step can be negative values and (negative) floating point values. If a step is omitted, the default value of 1 will be used.

The {{code|For Each}} loop iterates all elements of a class implementing the interface {{code|ICollection}}.
You can recognize classes implementing this interface by the few methods in the interface.
Note that using {{code|For Each}} on dictionaries and hash tables will loop the {{code|DictionaryEntry}} structs in the dictionary and not the keys or values.
You can however loop {{code|Dictionary.Keys}} or {{code|Dictionary.Values}} if you are only interested in either the keys or the values.
If you need both the keys and values, it is recommended to loop the {{code|DictionaryEntry}} structs.

The {{code|While}} and {{code|Do...While}} loops continue to loop while a boolean expression results in True.
The difference between the {{code|While}} and {{code|Do...While}} loops is when the boolean expression is evaluated.
{{code|While}} loops check the expression at the beginning of each iteration, {{code|Do...While}} loops check the expression at the end of each iteration.
As a result, {{code|Do...While}} loops are always executed at least once.

An example:
/* This will print each number from 0 to 10. 0 and 10 included. */
Var i As Integer;
For (i = 0 To 10) {
WriteLine(i);
}

/* This will print all even numbers from 10 to 0. 10 and 0 included, in reverse order. */
Var i As Integer;
For (i = 10 To 0 Step -2) {
WriteLine(i);
}

/* This will print the name of each ship in the SRS report of the ship with NCC 123456 */
Var MyShip As New CMyShip(123456);
Var Current As CShip;
For (Each Current In MyShip.SRS) {
WriteLine(Current.Name);
}

/* This will print each number from 0 to 10. 0 and 10 included. */
i = 0;
While (i <= 10) {
WriteLine(i++); // i++ increases i by one and returns the old value, see [[Scripting:Operators|Operators]] for details.
}

/* This will print each number from 0 to 11. 0 and 11 included! */
i = 0;
Do {
WriteLine(i++);
}
While(i <= 10)

== Functions (user defined) ==

You may define your own functions using the following syntax: {{code|Function [Name]([Param1Name] As [Param1Type], ...) As [ReturnType]}} followed by a code block wrapped in curly braces.
Functions can have zero or more parameters.
The return type is optional.
You can define multiple functions with the same name, as long as they have a different amount of parameters.
Different types of parameters is not enough for user defined functions.
Functions can return a value with the keyword {{code|Return [value];}}.
If a function has no return type, {{code|Return;}} will exit the function.

A few examples:
/* This function simply prints "Hello" */
Function WriteHello() {
WriteLine("Hello");
}

/* It is possible to defined multiple functions with the same name, if they have a different amount of parameters.
Functions without return type can use Return to quickly exit the function. */
Function WriteHello(DoSomething As Boolean) {
If (NOT DoSomething) {
Return;
}
WriteLine("Hello");
}

/* This function prints the message passed to it as the first parameter */
Function WriteMsg(Msg As String) {
WriteLine(Msg);
}

/* This function returns True if A is higher than B, False otherwise */
Function isHigher(A As Integer, B As Integer) As Boolean {
Return A > B;
}

WriteHello(); // This will now print "Hello";
WriteHello(True); // This also prints "Hello"
WriteHello(False); // This will not do anything;
WriteMsg("Hello"); // This also prints "Hello"
WriteLine(isHigher(10, 5)); // This will print "True" (the Boolean return value is implicitly cast to a String)

Scripting:Main page

2010-09-10T16:39:44Z

Glest Durnham:

[[Category:Scripting|Main page]]
{{ScriptingMenu}}
{{CreateScriptingArticle}}

This section of the Wiki is intended to document the scripting engine found in the game. Most scripting related pages in STNE can be found from the main menu trough Database -> Scripting.

=== Topics: ===
* [[Scripting:Syntax|Syntax]]
* [[Scripting:Operators|Operators]]
* [[Scripting:Interfaces|Interfaces]]

* [[Scripting:Basic course|Basic course]] (untranslated)

Scripting:Operators

2010-09-10T16:39:17Z

Glest Durnham: /* Notes */

== Table ==
In this section, a and b represent either literal values, object references or expressions evaluating to the appropriate type.

=== String operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Concatenation || a & b
|}

=== Comparison operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Equals || a = b
|-
| References equal || a Is b
|-
| Not equal to || a <> b
|-
| Greater than || a > b
|-
| Less than || a = b
|-
| Less than or equal to || a <= b
|}

=== Arithmetic operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Assignment || a = b
|-
| Addition || a + b
|-
| Subtraction || a - b
|-
| Multiplication || a * b
|-
| Division || a / b
|-
| Increment || a++
|-
| Increment || ++a
|-
| Decrement || a--
|-
| Decrement || --a
|}

=== Logical operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Logical NOT || NOT a
|-
| Logical AND || a AND b
|-
| Logical OR || a OR b
|}

=== Other operators ===

{| cellpadding="3"
! Operator name !! Syntax
|-
| Function call || a()
|-
| Function reference || AddressOf a
|-
| Member b of a || a.b
|}

== Notes ==

=== Assignment operator v.s. equals operator ===

The {{code | assignment}} operator and the {{code | equals}} operator use the same symbol. It depends on the context which operator is used. The {{code | assignment}} operator is used when a line of code follows the syntax {{code | Identifier {{=}} Value;}}. In all other cases, the {{code | equals}} operator is used.

=== Increment and decrement operators ===

There are two versions of the increment and decrement operators, namely the suffix and the prefix versions. The suffix versions increment or decrements the value hold by the identifier and then returns the old value. The prefix versions increment or decrement the value and return the result.

For example:
Var i As Integer = 5;
WriteLine(i++); // Writes 5
WriteLine(i); // Writes 6
WriteLine(i--) // Writes 6
WriteLine(i); // Writes 5

i = 5;
WriteLine(++i); // Writes 6
WriteLine(i); // Writes 6
WriteLine(--i); // Writes 5
WriteLine(i); // Writes 5

=== References equal ===

The {{code | References equal}} operator returns true if both identifiers hold the same reference (or: point to the same object).

For example:
Var i As String = "a";
Var j As String = "a";
WriteLine(i Is j); // false

i = j;
WriteLine(i Is j); // true

For types defined as Struct in the Object Explorer, this operator will never return true. When assigning one struct variable to another, the value is copied instead of the reference.

=== AddressOf ===

The {{code | AddressOf}} operator actually returns a CDelegate instance.

An example:
Var Delegate As CDelegate = AddressOf MyFunction;

Function MyFunction() {
WriteLine("Hello universe!");
}

Delegate.Invoke(); // Writes "Hello universe!";

Scripting:Operators

2010-09-10T16:38:16Z

Glest Durnham: /* Increment and decrement operators */