Scripting:Syntax - Revision history

Glest Durnham: /* Explicit casting */

2011-02-07T12:18:22Z

Explicit casting

← Older revision		Revision as of 12:18, 7 February 2011
Line 216:		Line 216:
	Not all casts can be done implicitly.		Not all casts can be done implicitly.
	The general syntax is as follows: {{code\|CType(Variable, [NewType])}}.		The general syntax is as follows: {{code\|CType(Variable, [NewType])}}.
-	There are also shorthand versions available convenience:	+	There are also shorthand versions available for convenience:

	; {{code\|CStr(Variable)}}		; {{code\|CStr(Variable)}}

Glest Durnham at 20:44, 4 November 2010

2010-11-04T20:44:04Z

Show changes

Glest Durnham: /* Casting */

2010-11-04T20:41:19Z

Casting

← Older revision		Revision as of 20:41, 4 November 2010
Line 177:		Line 177:

	=== Implicit casting ===		=== Implicit casting ===
-	Implicit casting is done by assigning an object to a variable of the desired type or passing it to a function that takes an argument of the desired type. Some examples:	+	Implicit casting is done by assigning an object to a variable of the desired type or passing it to a function that takes an argument of the desired type.
-	<pre style="overflow:auto; padding:~~3px~~;">	+	Some examples:
		+	<pre style="overflow:auto; padding:10px;">
	// Implicit casting by assignment		// Implicit casting by assignment
	Var Obj As Object = "Hello world!"; // This is actually already an implicit cast from a String to an Object.		Var Obj As Object = "Hello world!"; // This is actually already an implicit cast from a String to an Object.
Line 202:		Line 203:

	=== Explicit casting ===		=== Explicit casting ===
-	We can also explicitly cast an object to a different type. Sometimes this can save code, and sometimes it is required. Not all casts can be done implicitly. The general syntax is as follows: {{code\|CType(Variable, [NewType])}}. There are also shorthand versions available convenience:	+	We can also explicitly cast an object to a different type.
		+	Sometimes this can save code, and sometimes it is required.
		+	Not all casts can be done implicitly.
		+	The general syntax is as follows: {{code\|CType(Variable, [NewType])}}.
		+	There are also shorthand versions available convenience:

	; {{code\|CStr(Variable)}}		; {{code\|CStr(Variable)}}
Line 223:		Line 228:

	An example:		An example:
-	<pre style="overflow:auto; padding:~~3px~~;">	+	<pre style="overflow:auto; padding:10px;">
	// Explicit casting		// Explicit casting
	Var HashTable As New CObjectHashTable();		Var HashTable As New CObjectHashTable();

Glest Durnham: /* Casting */

2010-11-04T20:39:41Z

Casting

← Older revision		Revision as of 20:39, 4 November 2010
Line 178:		Line 178:
	=== Implicit casting ===		=== Implicit casting ===
	Implicit casting is done by assigning an object to a variable of the desired type or passing it to a function that takes an argument of the desired type. Some examples:		Implicit casting is done by assigning an object to a variable of the desired type or passing it to a function that takes an argument of the desired type. Some examples:
-	<pre style="overflow:auto">	+	<pre style="overflow:auto; padding:3px;">
	// Implicit casting by assignment		// Implicit casting by assignment
	Var Obj As Object = "Hello world!"; // This is actually already an implicit cast from a String to an Object.		Var Obj As Object = "Hello world!"; // This is actually already an implicit cast from a String to an Object.
Line 223:		Line 223:

	An example:		An example:
-	<pre style="overflow:auto">	+	<pre style="overflow:auto; padding:3px;">
	// Explicit casting		// Explicit casting
	Var HashTable As New CObjectHashTable();		Var HashTable As New CObjectHashTable();

Glest Durnham: /* Breaking from loops */

2010-11-04T20:38:56Z

Breaking from loops

← Older revision		Revision as of 20:38, 4 November 2010
Line 88:		Line 88:
	While(i <= 10)		While(i <= 10)

-	== Breaking from loops ==	+
		+	=== Breaking from loops ===
	Sometimes you may want to exit a loop early. This can be done using {{code\|Exit For}}, {{code\|Exit Do}} and {{code\|Exit While}}. The example below should illustrate this.		Sometimes you may want to exit a loop early. This can be done using {{code\|Exit For}}, {{code\|Exit Do}} and {{code\|Exit While}}. The example below should illustrate this.

Glest Durnham: /* Casting */

2010-11-04T20:38:33Z

Casting

← Older revision		Revision as of 20:38, 4 November 2010
Line 173:		Line 173:

	On occasion, it might be required to cast an object to a different type, for example after retrieving it from a {{Code\|CObjectHashTable}}. There are two ways to go about this: implicit and explicit casting. These two ways will be explained in more detail below. When casting objects to different types, it is important to remember that you can not simply cast an object to a random type. The compiler will not complain when you cast a CObjectHashTable to a CMyShip, but you will encounter a runtime exception if you try to execute the script. In general, you can always cast an object to any parent class and it's actual type. However, there are exceptions to this rule. For one, a lot of data types and classes can be cast to a String.		On occasion, it might be required to cast an object to a different type, for example after retrieving it from a {{Code\|CObjectHashTable}}. There are two ways to go about this: implicit and explicit casting. These two ways will be explained in more detail below. When casting objects to different types, it is important to remember that you can not simply cast an object to a random type. The compiler will not complain when you cast a CObjectHashTable to a CMyShip, but you will encounter a runtime exception if you try to execute the script. In general, you can always cast an object to any parent class and it's actual type. However, there are exceptions to this rule. For one, a lot of data types and classes can be cast to a String.
		+

	=== Implicit casting ===		=== Implicit casting ===

Glest Durnham: /* Casting */

2010-11-04T20:38:07Z

Casting

← Older revision		Revision as of 20:38, 4 November 2010
Line 172:		Line 172:
	== Casting ==		== Casting ==

-	On occasion, it might be required to cast an object to a different type, for example after retrieving it from an {{Code\|~~ObjectHashTable~~}}. There are two ways to go about this: implicit and explicit casting. These two ~~are~~ explained below. When casting objects to different types, it is important to remember that you can not simply cast an object to a random type. The compiler will not complain when you cast a CObjectHashTable to a CMyShip, but you will encounter a runtime exception if you try to execute the script. In general, you can always cast an object to any parent class and it's actual type. However, there are exceptions to this rule. For one, a lot of data types and classes can be cast to a String.	+	On occasion, it might be required to cast an object to a different type, for example after retrieving it from a {{Code\|CObjectHashTable}}. There are two ways to go about this: implicit and explicit casting. These two ways will be explained in more detail below. When casting objects to different types, it is important to remember that you can not simply cast an object to a random type. The compiler will not complain when you cast a CObjectHashTable to a CMyShip, but you will encounter a runtime exception if you try to execute the script. In general, you can always cast an object to any parent class and it's actual type. However, there are exceptions to this rule. For one, a lot of data types and classes can be cast to a String.

-	Implicit casting is done by assigning an object to a variable of a the desired type or passing it to a function that takes an argument of the desired type. ~~An example~~:	+	=== Implicit casting ===
		+	Implicit casting is done by assigning an object to a variable of the desired type or passing it to a function that takes an argument of the desired type. Some examples:
	<pre style="overflow:auto">		<pre style="overflow:auto">
	// Implicit casting by assignment		// Implicit casting by assignment
Line 198:		Line 199:


-	We can also explicitly cast an object to a different type. Sometimes this ~~simply saves~~ code, and sometimes it is required. Not all casts can be done implicitly. The general syntax is as follows: {{code\|CType(Variable, [NewType])}}. There are also shorthand versions available convenience:	+	=== Explicit casting ===
		+	We can also explicitly cast an object to a different type. Sometimes this can save code, and sometimes it is required. Not all casts can be done implicitly. The general syntax is as follows: {{code\|CType(Variable, [NewType])}}. There are also shorthand versions available convenience:

	; {{code\|CStr(Variable)}}		; {{code\|CStr(Variable)}}
Line 231:		Line 233:
	WriteLine(CType(HashTable.Item(EBeamResource.Plasteel), String).Length); // We now explicitly cast the return value to a String, so we can access the String class members.		WriteLine(CType(HashTable.Item(EBeamResource.Plasteel), String).Length); // We now explicitly cast the return value to a String, so we can access the String class members.
	WriteLine(CStr(HashTable.Item(EBeamResource.Plasteel)).Length); // Same as above, but less code		WriteLine(CStr(HashTable.Item(EBeamResource.Plasteel)).Length); // Same as above, but less code
-
	</pre>		</pre>

Glest Durnham: /* Casting */

2010-11-04T20:34:02Z

Casting

← Older revision		Revision as of 20:34, 4 November 2010
Line 175:		Line 175:

	Implicit casting is done by assigning an object to a variable of a the desired type or passing it to a function that takes an argument of the desired type. An example:		Implicit casting is done by assigning an object to a variable of a the desired type or passing it to a function that takes an argument of the desired type. An example:
-	<pre>	+	<pre style="overflow:auto">
	// Implicit casting by assignment		// Implicit casting by assignment
	Var Obj As Object = "Hello world!"; // This is actually already an implicit cast from a String to an Object.		Var Obj As Object = "Hello world!"; // This is actually already an implicit cast from a String to an Object.
Line 219:		Line 219:

	An example:		An example:
-	<pre style="~~width~~: auto;">	+	<pre style="overflow:auto">
	// Explicit casting		// Explicit casting
	Var HashTable As New CObjectHashTable();		Var HashTable As New CObjectHashTable();

Glest Durnham: /* Casting */

2010-11-04T20:31:27Z

Casting

← Older revision		Revision as of 20:31, 4 November 2010
Line 219:		Line 219:

	An example:		An example:
-	<pre>	+	<pre style="width: auto;">
	// Explicit casting		// Explicit casting
	Var HashTable As New CObjectHashTable();		Var HashTable As New CObjectHashTable();

Glest Durnham: /* Casting */

2010-11-04T20:30:20Z

Casting

← Older revision		Revision as of 20:30, 4 November 2010
Line 225:		Line 225:
	HashTable.Add(EBeamResource.Deuterium, "Basic fuel. Raises your voice pitch when inhaled."); // EBeamResource.Deuterium is used as key in the hash table.		HashTable.Add(EBeamResource.Deuterium, "Basic fuel. Raises your voice pitch when inhaled."); // EBeamResource.Deuterium is used as key in the hash table.
	HashTable.Add(EBeamResource.AntiMatter, "Advanced fuel. Should NOT be inhaled.");		HashTable.Add(EBeamResource.AntiMatter, "Advanced fuel. Should NOT be inhaled.");
-	HashTable.Add(EBeamResource.Plasteel, "Building material. Grows from trees until you reach level 8, when you're experienced enough to know it is actually a metal alloy combined with acrylic polymers.");	+	HashTable.Add(EBeamResource.Plasteel, "Building material. Grows from trees until you reach level 8, when you're experienced enough
		+	to know it is actually a metal alloy combined with acrylic polymers.");

	WriteLine(HashTable.Item(EBeamResource.Plasteel).Length); // This won't work, CObjectHashTable.Item() returns an Object, not a String.		WriteLine(HashTable.Item(EBeamResource.Plasteel).Length); // This won't work, CObjectHashTable.Item() returns an Object, not a String.