The Script Programming Language/Definitions - Revision history

Andrew Branscom at 05:51, 7 March 2016

2016-03-07T05:51:57Z

Andrew Branscom: /* synonyms: */

2015-12-03T01:14:04Z

synonyms:

Andrew Branscom: /* synonyms: */

2015-12-03T00:53:35Z

synonyms:

Andrew Branscom: /* synonyms: */

2015-11-30T00:31:26Z

synonyms:

Andrew Branscom at 00:30, 30 November 2015

2015-11-30T00:30:47Z

Andrew Branscom at 23:19, 29 November 2015

2015-11-29T23:19:21Z

Andrew Branscom at 22:15, 29 November 2015

2015-11-29T22:15:45Z

Andrew Branscom: Created page with "sss"

2015-11-29T22:07:06Z

Created page with "sss"

New page

sss

← Older revision		Revision as of 05:51, 7 March 2016
Line 156:		Line 156:
	[[Category:Scripting]]		[[Category:Scripting]]
	[[Category:Definitions]]		[[Category:Definitions]]
		+	[[Category:Define]]

← Older revision		Revision as of 01:14, 3 December 2015
Line 154:		Line 154:

	[[Category:SCI Documentation]]		[[Category:SCI Documentation]]
		+	[[Category:Scripting]]
	[[Category:Definitions]]		[[Category:Definitions]]

← Older revision		Revision as of 00:53, 3 December 2015
Line 154:		Line 154:

	[[Category:SCI Documentation]]		[[Category:SCI Documentation]]
		+	[[Category:Definitions]]

← Older revision		Revision as of 00:31, 30 November 2015
Line 148:		Line 148:

	[[The Script Programming Language \| Table of Contents]]		[[The Script Programming Language \| Table of Contents]]
−
−	~~ ~~

	<span style="float: left">[[The Script Programming Language/Files \| < Previous: Files]]</span><span style="float: right">[[The Script Programming Language/Data Types and Variables \| Next: Data Types and Variables >]]</span>		<span style="float: left">[[The Script Programming Language/Files \| < Previous: Files]]</span><span style="float: right">[[The Script Programming Language/Data Types and Variables \| Next: Data Types and Variables >]]</span>

← Older revision		Revision as of 00:30, 30 November 2015
Line 1:		Line 1:
	[[The Original SCI Documentation]]<br />		[[The Original SCI Documentation]]<br />
		+
		+	<div align="center">
		+	Chapter:
		+	[[The Script Programming Language/Introduction\|1]] \|
		+	[[The Script Programming Language/Files\|2]] \|
		+	[[The Script Programming Language/Definitions\|3]] \|
		+	[[The Script Programming Language/Data Types and Variables\|4]] \|
		+	[[The Script Programming Language/Primitive Procedures\|5]] \|
		+	[[The Script Programming Language/Control Flow\|6]] \|
		+	[[The Script Programming Language/Procedures\|7]] \|
		+	[[The Script Programming Language/Using SC\|8]] \|
		+	[[The Script Programming Language/Index\|Index]]
		+	</div><br />

	<div align="center"><span style="font-size: 22pt">The Script Programming Language</span><br />		<div align="center"><span style="font-size: 22pt">The Script Programming Language</span><br />

@@ Line 1: / Line 1: @@
 == <br /> Definitions ==
@@ Line 54: / Line 62: @@
 ===<br /> enum: ===
-A construct for easing the definition of various states of a state-variable
+A construct for easing the definition of various states of a state-variable is enum.  Say you want to walk an actor from the door of a room across the floor, up the stairs, and through another door.  You have a state-variable called actor-pos which will take on a number of values, which could be defined with defines:
 <blockquote>
@@ Line 89: / Line 93: @@
 </blockquote>
-Enum defaults its first symbol to 0.  If you want a different starting
+Enum defaults its first symbol to 0.  If you want a different starting value, put it right after the word enum:
 <blockquote>
@@ Line 121: / Line 124: @@
 </blockquote>
-defines the words synonym1, synonym2, etc. to be synonyms of main-word.  In
+defines the words synonym1, synonym2, etc. to be synonyms of main-word. In input being interpreted by the script in which the synonym statement is defined, user input of synonym1 will be interpreted as if the user had typed main-word.
 input being interpreted by the script in which the synonym statement is
 defined, user input of synonym1 will be interpreted as if the user had typed
-main-word.
+&nbsp;

← Older revision		Revision as of 22:15, 29 November 2015
Line 1:		Line 1:
−	~~sss~~	+	== <br /> Definitions ==
		+
		+	===<br /> define: ===
		+
		+	The define statement allows you to define a symbol which will stand for a
		+	string of text:
		+
		+	<blockquote>
		+	<div class="CodeBlockHeader">Code:</div>
		+	<syntaxhighlight lang="sci">
		+	(define symbol lots of text)
		+	</syntaxhighlight>
		+	</blockquote>
		+
		+	will replace symbol, wherever it is encountered as a token, with lots of
		+	text and then continue scanning at the beginning of the replacement text.
		+	Thus, if we write
		+
		+	<blockquote>
		+	<div class="CodeBlockHeader">Code:</div>
		+	<syntaxhighlight lang="sci">
		+	(define symbol some text)
		+	(define some even more)
		+	</syntaxhighlight>
		+	</blockquote>
		+
		+	then
		+
		+	<blockquote>
		+	<div class="CodeBlockHeader">Code:</div>
		+	<syntaxhighlight lang="sci">
		+	(symbol)
		+	</syntaxhighlight>
		+	</blockquote>
		+
		+	will become
		+
		+	<blockquote>
		+	<div class="CodeBlockHeader">Code:</div>
		+	<syntaxhighlight lang="sci">
		+	(some text)
		+	</syntaxhighlight>
		+	</blockquote>
		+
		+	which then becomes
		+
		+	<blockquote>
		+	<div class="CodeBlockHeader">Code:</div>
		+	<syntaxhighlight lang="sci">
		+	(even more text)
		+	</syntaxhighlight>
		+	</blockquote>
		+
		+	===<br /> enum: ===
		+
		+	A construct for easing the definition of various states of a state-variable
		+	is enum. Say you want to walk an actor from the door of a room across the
		+	floor, up the stairs, and through another door. You have a state-variable
		+	called actor-pos which will take on a number of values, which could be
		+	defined with defines:
		+
		+	<blockquote>
		+	<div class="CodeBlockHeader">Code:</div>
		+	<syntaxhighlight lang="sci">
		+	(local actor-pos
		+	(define at-front-door 0)
		+	(define in-room 1)
		+	(define on-stairs 2)
		+	(define top-of-stairs 3)
		+	(define upper-door 4)
		+	)
		+	</syntaxhighlight>
		+	</blockquote>
		+
		+	or you could get the same result with enum:
		+
		+	<blockquote>
		+	<div class="CodeBlockHeader">Code:</div>
		+	<syntaxhighlight lang="sci">
		+	(local actor-pos
		+	(enum
		+	at-front-door
		+	in-room
		+	on-stairs
		+	top-of-stairs
		+	upper-door
		+	)
		+	)</syntaxhighlight>
		+	</blockquote>
		+
		+	Enum defaults its first symbol to 0. If you want a different starting
		+	value, put it right after the word enum:
		+
		+	<blockquote>
		+	<div class="CodeBlockHeader">Code:</div>
		+	<syntaxhighlight lang="sci">
		+	(enum 7
		+	at-front-door
		+	in-room
		+	on-stairs
		+	top-of-stairs
		+	upper-door
		+	)
		+	</syntaxhighlight>
		+	</blockquote>
		+
		+	sets at-front-door to 7, in-room to 8, etc.
		+
		+	===<br /> synonyms: ===
		+
		+	The synonyms statement defines synonyms of words. All words must have been defined in the vocabulary file (see separate Vocabulary documentation). The statement
		+
		+	<blockquote>
		+	<div class="CodeBlockHeader">Code:</div>
		+	<syntaxhighlight lang="sci">
		+	(synonyms
		+	(main-word synonym1 synonym2 ...)
		+	...
		+	)
		+	</syntaxhighlight>
		+	</blockquote>
		+
		+	defines the words synonym1, synonym2, etc. to be synonyms of main-word. In
		+	input being interpreted by the script in which the synonym statement is
		+	defined, user input of synonym1 will be interpreted as if the user had typed
		+	main-word.