Andrew Branscom: 1 revision

2013-08-05T23:16:29Z

1 revision

Andrew Branscom: /* Temp Variables */

2011-01-23T00:31:01Z

Temp Variables

New page

==Variables==

Like any other programming language, SCI contains variables. Variables are areas in memory used to store data which can be manipulated. Variables can be used for virtually anything. You can store numbers in them, characters, pointers to objects, strings, said blocks, and more.

There are five different types of variables in SCI games: '''local''' , '''global''', '''parameter''', '''temp''' and '''property'''.

* '''Local variables''' are declared in each script. They can be accessed by any of the methods or procedures within the same script.
* '''Global variables''' are similar to local variables, except they can be accessed by the methods and procedures of any script. These are infact the local variables of script.000 (main.sc). All of the local variables in main.sc can be accessed by any method or property in any of the 1000 possible scripts.
* '''Parameter variables''' are those which are sent to methods and procedures. These will be discussed in detail in Chapter 12.
* '''Temp variables''' operate like any other variable, but can only be accessed from within the method or procedure in which they are declared.
* '''Property variables''' are declared in each object. They can be accessed one of two ways. They can be accessed from within the object's methods by name, or from other objects and procedures using the send command.

== Manipulating Variables ==

To manipulate variables, you use [[Operators|operators]]. We'll start with the basic operators: '''[[#Addition|addition (+)]]''', '''[[#Subtraction|subtraction (-)]]''', '''[[#Multiplication|multiplication (*)]]''', '''[[#Division|division (/)]]''' and '''[[#Assignment|assignment (=)]]'''.

===Assignment===

The  assignment operator assigns a value to a variable.

<blockquote><div class="CodeBlockHeader">Example:</div>
<syntaxhighlight lang="sci" class="cs">= score 100</syntaxhighlight>

In this example, the variable named "score" is set to contain 100 as it's value.
</blockquote>

===Addition===

The addition operator adds two values

<blockquote><div class="CodeBlockHeader">Example:</div>
<syntaxhighlight lang="sci" class="cs">=score (+ 100 20)</syntaxhighlight>

In this example, the variable named "score" is set to contain 120 as it's value (100 + 20).
</blockquote>

===Subtraction===

The subtraction operator subtracts two values

<blockquote><div class="CodeBlockHeader">Example:</div>
<syntaxhighlight lang="sci" class="cs">= score (- 100 20)</syntaxhighlight>

In this example, the variable named "score" is set to contain 80 as it's value (100 - 20).
</blockquote>

===Multiplication===

The multiplication operator multiplies two values

<blockquote><div class="CodeBlockHeader">Example:</div>
<syntaxhighlight lang="sci" class="cs">= score (* 100 20)</syntaxhighlight>

In this example, the variable named "score" is set to contain 2000 as it's value (100 * 20).
</blockquote>

===Division===

The division operator divides two values

<blockquote><div class="CodeBlockHeader">Example:</div>
<syntaxhighlight lang="sci" class="cs">= score (/ 100 20)</syntaxhighlight>

In this example, the variable named "score" is set to contain 5 as it's value (100 / 20).
</blockquote>

==Declaring and Using Variables==

===Local & Global Variables===

Local and global variables are set up in the local segment, as discussed briefly in chapter 9. The variables each begin with a name label to create an identifier for them. Following the label, you can optionally specify the array size if it will be used as an array, or the value if you wish to set it to something.

<blockquote><div class="CodeBlockHeader">An example of declaring the variables:</div>
<syntaxhighlight lang="sci" class="cs">( local
// a variable with no set value, so it will be set to 0
aVariable
// A variable set to 30
anotherVariable = 30
// 30 word sized variables (60 bytes total), all set to zero
anArray [30]
// The six variables in the array are set, the rest will be zero
aDeclaredArray [10] = (0 1 2 $ABCD 3 4 )
)
</syntaxhighlight><br />

<div class="CodeBlockHeader">Examples of using the variables:</div>
<syntaxhighlight lang="sci" class="cs">= aVariable 100
Wait(aVariable)
= anotherVariable (* aVariable 2)
= anArray [ 0] 5
(for (= aVariable 0) (< aVariable 10) (++aVariable )
= anArray [ aVariable ]123
)</syntaxhighlight>

The use of variables is very straight forward. For more information on the local segment, refer to the <html><a href="javascript:void(0)" onclick="window.open('http://sierrahelp.com/SCI/Definitions/Variables.html', 'Variables','width=750,height=900,scrollbars=yes')">Variables section</a></html> from the SCI Studio Help File.
</blockquote>

===Parameter Variables===

Parameter variables are sent to methods and procedures when called, and can be accessed within them. The variables' labels are defined in the method or procedure's definition.

<blockquote><div class="CodeBlockHeader">An example of declaring and using the variables:</div>
<syntaxhighlight lang="sci" class="cs">// two params are defined. The first named aParam, the second named anotherParam.
(procedure (aProc aParam anotherParam)
FormatPrint ("The first variable is: %d, the second is: %d." aParam anotherParam)
)</syntaxhighlight>

The "aProc" is the name of the procedure. The "aParam" and "anotherParam" are the names of the parameters. This is because the SCI language is derived from the "Lisp" language.<br />

The use of variables is very straight forward. For further information, refer to the <html><a href="javascript:void(0)" onclick="window.open('http://sierrahelp.com/SCI/Definitions/Procedures.html', 'Procedures','width=750,height=750,scrollbars=yes,location=no')">Procedures section</a></html> from the SCI Studio Help File.
</blockquote>

===Temp Variables===

Temp variables are allocated at the beginning of methods and procedures. They operate like any other variable, but are only accessible within the method or procedure which they are declared.

<blockquote>
<div class="CodeBlockHeader">An example of declaring and using the variables:</div>
<syntaxhighlight lang="sci" class="cs">( procedure (aProc )
/* three variables are defined. The first named aVariable is not initialized, the second named anotherVariable is initialized to 30, the last named anArray is an uninitialized 30 variable array.*/
( var aVariable , anotherVariable= 30, anArray [ 30])

= aVariable 100
Wait(aVariable )
= anotherVariable (* aVariable 2)
= anArray [0] 5
(for (= aVariable 0 ) (< aVariable 10 ) (++aVariable)
= anArray [aVariable] 123
)
)
</syntaxhighlight>

The use of variables is very straight forward. For more information on the local segment, refer to the <html><a href="javascript:void(0)" onclick="window.open('http://sierrahelp.com/SCI/Definitions/Variables.html', 'Variables','width=750,height=900,scrollbars=yes')">Variables section</a></html> from the SCI Studio Help File.
</blockquote>

===Property Variables===

Property variables are the properties of classes and instances. When accessing them from within their owner object, they operate like any other variable. When accessing them from outside the class, the send operation is used (discussed in the previous chapter).

<blockquote>
<div class="CodeBlockHeader">An example of declaring and using the properties within a class:</div>
<syntaxhighlight lang="sci" class="cs">( class aClass
( properties
aProperty 123
anotherProperty 2456
)
( method (someMethod )
= aProperty 100
Wait(aProperty )
= anotherProperty (* aProperty 2)
)
)
</syntaxhighlight>

The use of variables is very straight forward. For further information, refer to the section in the <html><a href="http://sierrahelp.com/SCI/SCIStudio3Help/" target="_blank">SCI Studio help File</a></html>.
</blockquote>

That sums up the variables of a script. If you don't fully understand them yet, don't worry. Continue on with the tutorial, doing the step by step examples. When done, you should have a good grasp on them. If you still do not, come back to this chapter and read it again, and look at the links to the help file.

 

<span style="float: left">[[SCI_Studio_Tutorial_Chapter_10_-_Getting_Familiar_With_Objects|< Previous: Chapter 10 - Getting Familiar With Objects]]</span><span style="float: right">[[SCI_Studio_Tutorial_Chapter_12_-_Methods_and_Procedures|Next: Chapter 12 - Methods and Procedures >]]</span>

 

[[Category:Variables]]
[[Category:Tutorials]]

SCI Studio Tutorial Chapter 11 - Variables - Revision history

Andrew Branscom: 1 revision

Andrew Branscom: /* Temp Variables */