mirror of
https://github.com/ganelson/inform.git
synced 2024-07-16 22:14:23 +03:00
3670 lines
176 KiB
HTML
3670 lines
176 KiB
HTML
*=ph_fileready=*
|
||
|
||
<p>This condition is true if the file exists and is marked as being ready to read; that is, it is not in a state where another program is currently writing it. Example:</p>
|
||
<!-- START CODE "c8813" -->
|
||
<a id="c8813"></a><blockquote class="code"><p class="quoted">
|
||
if ready to read the file of Invariants, ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_markfileready=*
|
||
|
||
<p>This phrase marks that we have finished writing to the given file, so that any external program is welcome to read it now. Example:</p>
|
||
<!-- START CODE "c8814" -->
|
||
<a id="c8814"></a><blockquote class="code"><p class="quoted">
|
||
mark the file of Invariants as ready to read;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_markfilenotready=*
|
||
|
||
<p>This phrase marks that we are about to start writing to the given file, so that any external program should wait until we're finished if it wants to read the file. Example:</p>
|
||
<!-- START CODE "c8815" -->
|
||
<a id="c8815"></a><blockquote class="code"><p class="quoted">
|
||
mark the file of Invariants as not ready to read;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_succeedswith=*
|
||
|
||
<p>This phrase can only be used in a rule which produces a value, and the value given must be of the right kind. It causes the current rule to finish immediately, to succeed, and to produce the value given.</p>
|
||
|
||
*=ph_producedby=*
|
||
|
||
<p>This phrase is used to follow the named rule, and to collect the resulting value.</p>
|
||
|
||
*=ph_producedbyfor=*
|
||
|
||
<p>This phrase is used to follow the named rule based on the value given, and to collect the resulting value.</p>
|
||
|
||
*=ph_randombetween=*
|
||
|
||
<p>This phrase produces a uniformly random value in the range given. Examples:</p>
|
||
<!-- START CODE "c1986" -->
|
||
<a id="c1986"></a><blockquote class="code"><p class="quoted">
|
||
a random number from 10 to 99
|
||
<br />a random time from 2:31 PM to 2:57 PM
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>If we make a new kind of value:</p>
|
||
<!-- START CODE "c1987" -->
|
||
<a id="c1987"></a><blockquote class="code"><p class="quoted">
|
||
A cloud pattern is a kind of value. The cloud patterns are cumulus, altocumulus, cumulonimbus, stratus, cirrus, nimbus, nimbostratus.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then we can also take random values from it:</p>
|
||
<!-- START CODE "c1988" -->
|
||
<a id="c1988"></a><blockquote class="code"><p class="quoted">
|
||
a random cloud pattern between stratus and nimbus
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which has three possible outcomes, all equally likely.</p>
|
||
|
||
*=ph_randomchance=*
|
||
|
||
<p>This condition is true X/Yths of the time, where X and Y are the numbers. Example:</p>
|
||
<!-- START CODE "c1989" -->
|
||
<a id="c1989"></a><blockquote class="code"><p class="quoted">
|
||
if a random chance of 2 in 3 succeeds, ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Here is a rule which applies only 15% of the time:</p>
|
||
<!-- START CODE "c1990" -->
|
||
<a id="c1990"></a><blockquote class="code"><p class="quoted">
|
||
Instead of waiting when a random chance of 15 in 100 succeeds: ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_seed=*
|
||
|
||
<p>This phrase changes the seed number as specified. Any random numbers generated after that depend only on the seed. Example: the following sentence will "fix" the process of generating these random numbers so that they are not random at all - the same sequence of random numbers will be produced on each run.</p>
|
||
<!-- START CODE "c1991" -->
|
||
<a id="c1991"></a><blockquote class="code"><p class="quoted">
|
||
When play begins, seed the random-number generator with 1234.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>The seed value "1234" can be anything positive; a different sequence of random numbers will be produced for each different seed value. A seed value of 0 restores the RNG to properly random behaviour again.</p>
|
||
|
||
*=ph_numberof=*
|
||
|
||
<p>This phrase counts the number of values matching the description, which may of course be 0. Example:</p>
|
||
<!-- START CODE "c1042" -->
|
||
<a id="c1042"></a><blockquote class="code"><p class="quoted">
|
||
number of open doors
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces the number of doors, anywhere in the model world, which are currently open. A Problem message is produced if the number is potentially infinite, or impractical to count: for instance, Inform rejects "number of odd numbers".</p>
|
||
|
||
*=ph_writetext=*
|
||
|
||
<p>This phrase makes the given text become the entire contents of the named file. Note that files must have been declared, and must be referred to by their Inform names, not by textual filenames. Example:</p>
|
||
<!-- START CODE "c8757" -->
|
||
<a id="c8757"></a><blockquote class="code"><p class="quoted">
|
||
write "Jackdaws love my big sphinx of quartz." to the file of Abecedary Wisdom;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_appendtext=*
|
||
|
||
<p>This phrase adds the given text to the end of the current contents of the named file (creating it if it does not exist on disc). Note that files must have been declared, and must be referred to by their Inform names, not by textual filenames. Example:</p>
|
||
<!-- START CODE "c8758" -->
|
||
<a id="c8758"></a><blockquote class="code"><p class="quoted">
|
||
append "Jinxed wizards pluck ivy from the big quilt." to the file of Abecedary Wisdom;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_saytext=*
|
||
|
||
<p>This text expands to the contents of the named file. Note that files must have been declared, and must be referred to by their Inform names, not by textual filenames. Example:</p>
|
||
<!-- START CODE "c8759" -->
|
||
<a id="c8759"></a><blockquote class="code"><p class="quoted">
|
||
"[text of the File of Abecedary Wisdom]"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_beginactivity=*
|
||
|
||
<p>This phrase causes the named activity to become active, and runs its "before" rulebook. The activity must be one which applies to nothing. Example:</p>
|
||
<!-- START CODE "c6347" -->
|
||
<a id="c6347"></a><blockquote class="code"><p class="quoted">
|
||
begin the assaying activity;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>In all cases a matching "end the ... activity" or else "abandon the ... activity" phrase must be reached.</p>
|
||
|
||
*=ph_beginactivitywith=*
|
||
|
||
<p>This phrase causes the named activity to become active, and runs its "before" rulebook. The activity must be one which applies to a value of a matching kind. Example:</p>
|
||
<!-- START CODE "c6348" -->
|
||
<a id="c6348"></a><blockquote class="code"><p class="quoted">
|
||
begin the analysing activity with the pitchblende;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>In all cases a matching "end the ... activity with ..." or else "abandon the ... activity with..." phrase must be reached.</p>
|
||
|
||
*=ph_endactivity=*
|
||
|
||
<p>This phrase runs the "after" rulebook of the activity and then causes it to become inactive. The activity must be one which applies to nothing. Example:</p>
|
||
<!-- START CODE "c6349" -->
|
||
<a id="c6349"></a><blockquote class="code"><p class="quoted">
|
||
end the assaying activity;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This must only happen to match an earlier "begin the ... activity" phrase.</p>
|
||
|
||
*=ph_endactivitywith=*
|
||
|
||
<p>This phrase runs the "after" rulebook of the activity and then causes it to become inactive. The activity must be one which applies to a value of a matching kind. Example:</p>
|
||
<!-- START CODE "c6350" -->
|
||
<a id="c6350"></a><blockquote class="code"><p class="quoted">
|
||
end the analysing activity with the pitchblende;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This must only happen to match an earlier "begin the ... activity with..." phrase.</p>
|
||
|
||
*=ph_handlingactivity=*
|
||
|
||
<p>This should be used only where the given activity has been started with "begin ..." and will be finished with "end ...". It runs the "for" rules for the activity, and then comes out true if none of those for rules intervened in the handling of that activity. (The activity must be one which doesn't apply to any value.)</p>
|
||
|
||
*=ph_handlingactivitywith=*
|
||
|
||
<p>This should be used only where the given activity has been started with "begin ..." and will be finished with "end ...". It runs the "for" rules for the activity, and then comes out true if none of those for rules intervened in the handling of that activity. (The given value must be the one it is being applied to.)</p>
|
||
|
||
*=ph_abandonactivity=*
|
||
|
||
<p>This phrase ends an activity at once (without consulting any further rulebooks, including its "after" rulebook). It can only be used with an activity which has had its "begin" but not yet its "end" phrase; it is a drastic remedy best taken only if it is clear that circumstances have changed so that the activity now seems inappropriate. It must not be used during one of the rules for the activity: it can only be used between the begin and for stages, or between the for and end stages.</p>
|
||
<!-- START CODE "c6354" -->
|
||
<a id="c6354"></a><blockquote class="code"><p class="quoted">
|
||
abandon the assaying activity;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_abandonactivitywith=*
|
||
|
||
<p>This phrase ends an activity at once (without consulting any further rulebooks, including its "after" rulebook). It can only be used with an activity which has had its "begin" but not yet its "end" phrase; it is a drastic remedy best taken only if it is clear that circumstances have changed so that the activity now seems inappropriate. It must not be used during one of the rules for the activity: it can only be used between the begin and for stages, or between the for and end stages.</p>
|
||
<!-- START CODE "c6355" -->
|
||
<a id="c6355"></a><blockquote class="code"><p class="quoted">
|
||
abandon the analysing activity with the pitchblende;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_adapt=*
|
||
|
||
<p>Adapts the given verb to the current story tense and story viewpoint. For example, "you [adapt the verb provoke]" might produce "you provoke".</p>
|
||
|
||
*=phs_adaptv=*
|
||
|
||
<p>Adapts the given verb to the current story tense but the given viewpoint. For example, "he [adapt the verb provoke from the third person singular]" might produce "he provokes".</p>
|
||
|
||
*=phs_adaptt=*
|
||
|
||
<p>Adapts the given verb to the given tense but the current story viewpoint. For example, "you [adapt the verb provoke in the past tense]" might produce "you provoked".</p>
|
||
|
||
*=phs_adaptvt=*
|
||
|
||
<p>Adapts the given verb to the given tense and viewpoint. For example, "we [adapt the verb provoke in the future tense from the first person plural]" might produce "we will provoke".</p>
|
||
|
||
*=phs_negate=*
|
||
|
||
<p>Adapts the given verb to the current story tense and story viewpoint, giving it a negative sense. For example, "you [negate the verb provoke]" might produce "you do not provoke".</p>
|
||
|
||
*=phs_negatev=*
|
||
|
||
<p>Adapts the given verb to the current story tense but the given viewpoint, giving it a negative sense. For example, "he [negate the verb provoke from the third person singular]" might produce "he does not provoke".</p>
|
||
|
||
*=phs_negatet=*
|
||
|
||
<p>Adapts the given verb to the given tense but the current story viewpoint, giving it a negative sense. For example, "you [negate the verb provoke in the past tense]" might produce "you did not provoke".</p>
|
||
|
||
*=phs_negatevt=*
|
||
|
||
<p>Adapts the given verb to the given tense and viewpoint, giving it a negative sense. For example, "we [negate the verb provoke in the future tense from the first person plural]" might produce "we will not provoke".</p>
|
||
|
||
*=phs_infinitive=*
|
||
|
||
<p>Produces the infinitive of the given verb. Note that this is without a "to": for example, "[infinitive of the verb carry]" is "carry", not "to carry".</p>
|
||
|
||
*=phs_pastpart=*
|
||
|
||
<p>Produces the past participle of the given verb. For example, "[past participle of the verb carry]" is "carried". Warning: because modal verbs like "should" or "might" are defective in English, this will produce odd results on them - "shoulded" and "mighted", for example.</p>
|
||
|
||
*=phs_prespart=*
|
||
|
||
<p>Produces the present participle of the given verb. For example, "[present participle of the verb carry]" is "carrying". Warning: because modal verbs like "should" or "might" are defective in English, this will produce odd results on them - "shoulding" and "mighting", for example.</p>
|
||
|
||
*=ph_move=*
|
||
|
||
<p>This phrase moves the first-named object to the second. Example:</p>
|
||
<!-- START CODE "c1822" -->
|
||
<a id="c1822"></a><blockquote class="code"><p class="quoted">
|
||
move the genie's lamp to Aladdin's Cave;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>The first object named has to be a thing; the destination must be a room, as here, a container, a supporter, or a person. When something is moved, all its parts and contents (and all their contents, and so on) move with it. If the thing being moved is a person, then the destination is required to be a room or an enterable container. (In particular, a person cannot be carried by another person.)</p>
|
||
<p>Two options can be used if the object being moved is the player.</p>
|
||
<!-- START CODE "c1823" -->
|
||
<a id="c1823"></a><blockquote class="code"><p class="quoted">
|
||
move the player to Aladdin's Cave, without printing a room description
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>omits the description which would otherwise be produced. A compromise is to use:</p>
|
||
<!-- START CODE "c1824" -->
|
||
<a id="c1824"></a><blockquote class="code"><p class="quoted">
|
||
move the player to Aladdin's Cave, printing an abbreviated room description
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which gives a full description if the player has never been here before, but only a brief one if it is a familiar scene. These options have no effect for any other objects being moved.</p>
|
||
|
||
*=ph_remove=*
|
||
|
||
<p>Removes the given object from play, so that it is not present in any room. We are not permitted to remove rooms, or doors, or the player, from play; but we are permitted to remove backdrops, making them disappear from all rooms in which they are present. Example:</p>
|
||
<!-- START CODE "c1891" -->
|
||
<a id="c1891"></a><blockquote class="code"><p class="quoted">
|
||
remove the gold coin from play;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_linebreak=*
|
||
|
||
<p>This text substitution produces a line break. Example:</p>
|
||
<!-- START CODE "c943" -->
|
||
<a id="c943"></a><blockquote class="code"><p class="quoted">
|
||
"There is an endless sense of[line break]falling and[line break]falling."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Line breaks are not paragraph breaks, so the result is:</p>
|
||
<!-- START CODE "c944" -->
|
||
<a id="c944"></a><blockquote class="code"><p class="quoted">
|
||
There is an endless sense of
|
||
<br />falling and
|
||
<br />falling.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>with no extra vertical spacing between these lines.</p>
|
||
|
||
*=phs_nolinebreak=*
|
||
|
||
<p>This text substitution produces no text. It's used only for a side-effect: it prevents a line break where Inform might otherwise assume one. Example:</p>
|
||
<!-- START CODE "c945" -->
|
||
<a id="c945"></a><blockquote class="code"><p class="quoted">
|
||
"The chorus sing [one of]Jerusalem[or]Rule, Britannia![no line break][at random]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Here the "[no line break]" stops Inform from thinking that the exclamation mark means a sentence ending - it's part of the name of the song "Rule, Britannia!". So we get</p>
|
||
<!-- START CODE "c946" -->
|
||
<a id="c946"></a><blockquote class="code"><p class="quoted">
|
||
The chorus sing Rule, Britannia!.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>with no line break between the "!" and ".".</p>
|
||
|
||
*=phs_runparaon=*
|
||
|
||
<p>This text substitution produces no text. It's used only for a side-effect: it prevents a paragraph break occurring after the present text is printed, in case Inform might be tempted to place one there. Example:</p>
|
||
<!-- START CODE "c947" -->
|
||
<a id="c947"></a><blockquote class="code"><p class="quoted">
|
||
Before taking something, say "Very well. [run paragraph on]".
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This allows the reply to, say, TAKE ENVELOPE to be</p>
|
||
<!-- START CODE "c948" -->
|
||
<a id="c948"></a><blockquote class="code"><p class="quoted">
|
||
Very well. Taken.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>rather than</p>
|
||
<!-- START CODE "c949" -->
|
||
<a id="c949"></a><blockquote class="code"><p class="quoted">
|
||
Very well.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<!-- START CODE "c950" -->
|
||
<a id="c950"></a><blockquote class="code"><p class="quoted">
|
||
Taken.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which is how texts produced by different rules would normally be shown. (It's a traditional printer's term. See Oldfield's Manual of Typography, 1892, under "When two paragraphs are required to be made into one, or, in technical language, 'to run on'.")</p>
|
||
|
||
*=phs_parabreak=*
|
||
|
||
<p>This text substitution produces a paragraph break. Example:</p>
|
||
<!-- START CODE "c951" -->
|
||
<a id="c951"></a><blockquote class="code"><p class="quoted">
|
||
"This is not right.[paragraph break]No, something is terribly wrong."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Paragraph breaks have a little vertical spacing in them, unlike mere line breaks, so the result is:</p>
|
||
<!-- START CODE "c952" -->
|
||
<a id="c952"></a><blockquote class="code"><p class="quoted">
|
||
This is not right.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<!-- START CODE "c953" -->
|
||
<a id="c953"></a><blockquote class="code"><p class="quoted">
|
||
No, something is terribly wrong.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_condparabreak=*
|
||
|
||
<p>This text substitution either produces a paragraph break, or no text at all. It marks a place where Inform can put a paragraph break if necessary; in effect it simulates what Inform does every time a "before" or similar rule finishes. If there is text already printed, and text then follows on, a paragraph break is made. But if not, nothing is done. This is sometimes useful when producing a large amount of text which changes with the circumstances so that it is hard to predict in advance whether a paragraph break is needed or not.</p>
|
||
|
||
*=ph_breakpending=*
|
||
|
||
<p>This condition is true if text has recently been said in such a way that Inform expects to add a paragraph break at the next opportunity (for instance when the present rule ends and another one says something, or when a "[conditional paragraph break]" is made).</p>
|
||
|
||
*=phs_clarifbreak=*
|
||
|
||
<p>This text substitution produces a line break, and then also a paragraph break if the text immediately following is a room description brought about by having gone to to a different room and looking around, in which case a line break should be added. In traditional IF, this is used when clarifying what Inform thinks the player intended by a given command. Example:</p>
|
||
<!-- START CODE "c954" -->
|
||
<a id="c954"></a><blockquote class="code"><p class="quoted">
|
||
say "(first opening [the noun])[command clarification break]";
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>might result in</p>
|
||
<!-- START CODE "c955" -->
|
||
<a id="c955"></a><blockquote class="code"><p class="quoted">
|
||
(first opening the valise)
|
||
<br />You rummage through the valise for tickets, but find nothing.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_runparaonsls=*
|
||
|
||
<p>This text substitution produces no text. It's used only for a side-effect: it indicates that the current printing position does not follow a skipped line, and that further material is expected which will run on from the previous paragraph, but that if no further material turns up then a skipped line would be needed before the next command prompt. (It's very likely that only the Standard Rules will ever need this.)</p>
|
||
|
||
*=ph_minspart=*
|
||
|
||
<p>This phrase converts a time to a number, then takes the result mod 60, which in effect produces the number of minutes after the hours are thrown away. Example:</p>
|
||
<!-- START CODE "c2211" -->
|
||
<a id="c2211"></a><blockquote class="code"><p class="quoted">
|
||
minutes part of 12:41 PM
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces 41.</p>
|
||
|
||
*=ph_hourspart=*
|
||
|
||
<p>This phrase converts a time to a number, then divides the result by 60, which in effect produces the number of hours after minutes are thrown away. Example:</p>
|
||
<!-- START CODE "c2212" -->
|
||
<a id="c2212"></a><blockquote class="code"><p class="quoted">
|
||
hours part of 8:21 AM
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces 8.</p>
|
||
|
||
*=phs_unicode=*
|
||
|
||
<p>This text substitution produces the Unicode character named (or numbered). Example:</p>
|
||
<!-- START CODE "c980" -->
|
||
<a id="c980"></a><blockquote class="code"><p class="quoted">
|
||
"[unicode 321]odz Churchyard"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces a Polish slashed L. If the Unicode Character Names or Unicode Full Character Names extensions are included, characters can also be named as well as numbered:</p>
|
||
<!-- START CODE "c981" -->
|
||
<a id="c981"></a><blockquote class="code"><p class="quoted">
|
||
"[unicode Latin capital letter L with stroke]odz Churchyard"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_inlower=*
|
||
|
||
<p>This condition is true if every character in the text is a lower case letter. Examples: this is true for "wax", but false for "wax seal" or "eZ mOnEy".</p>
|
||
|
||
*=ph_inupper=*
|
||
|
||
<p>This condition is true if every character in the text is in upper case. Examples: this is true for "BEESWAX", but false for "ROOM 101".</p>
|
||
|
||
*=ph_lowercase=*
|
||
|
||
<p>This phrase produces a new version of the given text, but with all upper case letters reduced to lower case. Example: "a ticket to Tromsø via Østfold" becomes</p>
|
||
<!-- START CODE "c8065" -->
|
||
<a id="c8065"></a><blockquote class="code"><p class="quoted">
|
||
"a ticket to tromsø via østfold"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_uppercase=*
|
||
|
||
<p>This phrase produces a new version of the given text, but with all upper case letters reduced to lower case. Example: "a ticket to Tromsø via Østfold" becomes</p>
|
||
<!-- START CODE "c8066" -->
|
||
<a id="c8066"></a><blockquote class="code"><p class="quoted">
|
||
"A TICKET TO TROMSØ VIA ØSTFOLD"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_titlecase=*
|
||
|
||
<p>This phrase produces a new version of the given text, but with casing of words changed to title casing: this capitalises the first letter of each word, and lowers the rest. Example: "a ticket to Tromsø via Østfold" becomes</p>
|
||
<!-- START CODE "c8067" -->
|
||
<a id="c8067"></a><blockquote class="code"><p class="quoted">
|
||
"A Ticket To Tromsø Via Østfold"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_sentencecase=*
|
||
|
||
<p>This phrase produces a new version of the given text, but with casing of words changed to sentence casing: this capitalises the first letter of each sentence and reduces the rest to lower case. Example: "a ticket to Tromsø via Østfold" becomes</p>
|
||
<!-- START CODE "c8068" -->
|
||
<a id="c8068"></a><blockquote class="code"><p class="quoted">
|
||
"A ticket to tromsø via østfold"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_ceiling=*
|
||
|
||
<p>Produces the largest integer value greater than or equal to the one given. Examples:</p>
|
||
<!-- START CODE "c4560" -->
|
||
<a id="c4560"></a><blockquote class="code"><p class="quoted">
|
||
ceiling of pi = 4.0
|
||
<br />ceiling of -16.315 = -16.0
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>(Note that the result is still a real number; it simply has no fractional part any more.)</p>
|
||
|
||
*=ph_floor=*
|
||
|
||
<p>Produces the largest integer value less than or equal to the one given. Examples:</p>
|
||
<!-- START CODE "c4561" -->
|
||
<a id="c4561"></a><blockquote class="code"><p class="quoted">
|
||
floor of pi = 3.0
|
||
<br />floor of -16.315 = -17.0
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>(Note that the result is still a real number; it simply has no fractional part any more.)</p>
|
||
|
||
*=ph_absolutevalue=*
|
||
|
||
<p>Removes the sign from a value, leaving positive numbers alone but making negative ones positive. Examples:</p>
|
||
<!-- START CODE "c4562" -->
|
||
<a id="c4562"></a><blockquote class="code"><p class="quoted">
|
||
absolute value of 62.1 = 62.1
|
||
<br />absolute value of 0 = 0.0
|
||
<br />absolute value of -62.1 = 62.1
|
||
<br />absolute value of minus infinity = plus infinity
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_reciprocal=*
|
||
|
||
<p>Calculates 1/x, that is, divides up 1 into this many pieces. Examples:</p>
|
||
<!-- START CODE "c4563" -->
|
||
<a id="c4563"></a><blockquote class="code"><p class="quoted">
|
||
reciprocal of -2 = -0.5
|
||
<br />reciprocal of 0.1 = 10.0
|
||
<br />reciprocal of 7 = 0.14286
|
||
<br />reciprocal of plus infinity = 0.0
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_power=*
|
||
|
||
<p>Computes x to the power y. Examples:</p>
|
||
<!-- START CODE "c4564" -->
|
||
<a id="c4564"></a><blockquote class="code"><p class="quoted">
|
||
2 to the power 4 = 16.0
|
||
<br />100 to the power 0.5 = 10.0
|
||
<br />7 to the power -1 = 0.14286
|
||
<br />pi to the power 0 = 1.0
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>In the words of the Glulx specification document (section 2.12), "the special cases are breathtaking": if you need to know exactly what, say, "minus infinity to the power Y" will do for different cases of Y, refer to the detail of the "pow" opcode.</p>
|
||
|
||
*=ph_exp=*
|
||
|
||
<p>Computes e to the given power, where e is the base of natural logarithms. Examples:</p>
|
||
<!-- START CODE "c4566" -->
|
||
<a id="c4566"></a><blockquote class="code"><p class="quoted">
|
||
exponential of 0 = 1.0
|
||
<br />exponential of 1 = e = 2.7182818
|
||
<br />exponential of -10 = 4.53999 x 10^-5
|
||
<br />exponential of 10 = 22026.46484
|
||
<br />exponential of logarithm of 7.12 = 7.12
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_logarithmto=*
|
||
|
||
<p>Finds what power the base would have to be raised to in order to get this value. Examples:</p>
|
||
<!-- START CODE "c4567" -->
|
||
<a id="c4567"></a><blockquote class="code"><p class="quoted">
|
||
logarithm to base 10 of 1000000 = 6.0
|
||
<br />logarithm to base 10 of 350 = 2.54407
|
||
<br />logarithm to base 2 of 256 = 8.0
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Logarithms of zero or negative numbers are nonexistent. Note that "logarithm to base 10 of ..." is what most calculators call simply "log", but Inform doesn't: it uses "log" for natural logarithms.</p>
|
||
|
||
*=ph_logarithm=*
|
||
|
||
<p>Finds what power e would have to be raised to in order to get this value. Examples:</p>
|
||
<!-- START CODE "c4568" -->
|
||
<a id="c4568"></a><blockquote class="code"><p class="quoted">
|
||
logarithm of e = 1.0
|
||
<br />logarithm of 1 = 0.0
|
||
<br />logarithm of 1000 = 6.90776
|
||
<br />logarithm of exponential of 7.12 = 7.12
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Logarithms of zero or negative numbers are nonexistent. This is the function which most calculators label as "ln", for "log natural", but in mathematical and scientific papers it's more often written "log", and Inform follows that convention.</p>
|
||
|
||
*=phs_banner=*
|
||
|
||
<p>This text substitution expands to the banner text giving bibliographic details of the current story file, rather like the opening credits of a movie, or the title page of a book.</p>
|
||
|
||
*=ph_snippetmatches=*
|
||
|
||
<p>This condition is true if the given snippet exactly matches the specification. Example:</p>
|
||
<!-- START CODE "c7150" -->
|
||
<a id="c7150"></a><blockquote class="code"><p class="quoted">
|
||
if the player's command matches "room [number]", ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>will be true if the command is ROOM 101, but not if it's EXPLORE ROOM 7.</p>
|
||
|
||
*=ph_snippetdoesnotmatch=*
|
||
|
||
<p>This condition is true if the given snippet does not exactly match the specification.</p>
|
||
|
||
*=ph_snippetincludes=*
|
||
|
||
<p>This condition is true if the given snippet includes words matching the specification, either at the beginning, in the middle, or at the end. Example:</p>
|
||
<!-- START CODE "c7151" -->
|
||
<a id="c7151"></a><blockquote class="code"><p class="quoted">
|
||
if the player's command includes "room [number]", ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>will be true if the command is ROOM 101, EXPLORE ROOM 7, or ROOM 22 AHOY, but not if it's VISIT ROOM GAMMA 7.</p>
|
||
|
||
*=ph_snippetdoesnotinclude=*
|
||
|
||
<p>This condition is true if the given snippet does not include any run of words which matches the specification.</p>
|
||
|
||
*=ph_rejectcommand=*
|
||
|
||
<p>This phrase should be used only in rules for the "reading a command" activity. It tells Inform not to bother analysing the text further, but to go back to the keyboard. (No time passes; no turn elapses; nothing happens in the simulated world.)</p>
|
||
|
||
*=ph_replacesnippet=*
|
||
|
||
<p>This phrase should be used only in "after" rules for the "reading a command" activity; it replaces the snippet of command, usually the "matched text" found immediately before, with the given text. Example:</p>
|
||
<!-- START CODE "c7153" -->
|
||
<a id="c7153"></a><blockquote class="code"><p class="quoted">
|
||
if the player's command includes "room [number]":
|
||
<br />    replace the matched text with "office".
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_cutsnippet=*
|
||
|
||
<p>This phrase should be used only in "after" rules for the "reading a command" activity; it replaces the snippet of command, usually the "matched text" found immediately before, with the given text. Example:</p>
|
||
<!-- START CODE "c7154" -->
|
||
<a id="c7154"></a><blockquote class="code"><p class="quoted">
|
||
if the player's command includes "or else":
|
||
<br />    cut the matched text.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_changecommand=*
|
||
|
||
<p>This phrase should be used only in "after" rules for the "reading a command" activity; it replaces the current command text entirely. Example:</p>
|
||
<!-- START CODE "c7156" -->
|
||
<a id="c7156"></a><blockquote class="code"><p class="quoted">
|
||
After reading a command:
|
||
<br />    let T be "[the player's command]";
|
||
<br />    replace the regular expression "\p" in T with "";
|
||
<br />    change the text of the player's command to T.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This converts the player's command to text, which is then manipulated by searching for any punctuation mark and replacing it with blank text (that is, deleted), and then put back again as the new command.</p>
|
||
|
||
*=ph_rulebookoutcome=*
|
||
|
||
<p>This phrase produces the (named) outcome of the phrase most recently followed. Example:</p>
|
||
<!-- START CODE "c7897" -->
|
||
<a id="c7897"></a><blockquote class="code"><p class="quoted">
|
||
follow the audibility rules;
|
||
<br />if the outcome of the rulebook is the absolute silence outcome:
|
||
<br />    say "You could hear a pin drop in here."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_nothing=*
|
||
|
||
<p>This phrase does nothing at all. It is very occasionally useful to make a rule which does nothing:</p>
|
||
<!-- START CODE "c2814" -->
|
||
<a id="c2814"></a><blockquote class="code"><p class="quoted">
|
||
This is the largely ineffective rule:
|
||
<br />    do nothing.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_increase=*
|
||
|
||
<p>This phrases increases the variable, table entry, list entry, or property by the given amount, which must be of a compatible kind. Example:</p>
|
||
<!-- START CODE "c1957" -->
|
||
<a id="c1957"></a><blockquote class="code"><p class="quoted">
|
||
increase the score by 8;
|
||
<br />increase the time of day by 5 minutes;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_decrease=*
|
||
|
||
<p>This phrases decreases the variable, table entry, list entry, or property by the given amount, which must be of a compatible kind. Example:</p>
|
||
<!-- START CODE "c1958" -->
|
||
<a id="c1958"></a><blockquote class="code"><p class="quoted">
|
||
decrease the score by 6;
|
||
<br />decrease the carrying capacity of the player by 10;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_increment=*
|
||
|
||
<p>This phrases increases the variable, table entry, list entry, or property by 1. Example:</p>
|
||
<!-- START CODE "c1959" -->
|
||
<a id="c1959"></a><blockquote class="code"><p class="quoted">
|
||
increment the score;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_decrement=*
|
||
|
||
<p>This phrases decreases the variable, table entry, list entry, or property by 1. Example:</p>
|
||
<!-- START CODE "c1960" -->
|
||
<a id="c1960"></a><blockquote class="code"><p class="quoted">
|
||
decrement the score;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_appliedlist=*
|
||
|
||
<p>This phrase takes the list, applies the phrase to each entry in the list, and forms a new list of the result. Example:</p>
|
||
<!-- START CODE "c8656" -->
|
||
<a id="c8656"></a><blockquote class="code"><p class="quoted">
|
||
To decide what number is double (N - a number) (this is doubling):
|
||
<br />    decide on N plus N.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Then "doubling applied to 2" produces 4, by the simpler definition of "applied to", but also:</p>
|
||
<!-- START CODE "c8657" -->
|
||
<a id="c8657"></a><blockquote class="code"><p class="quoted">
|
||
doubling applied to {2, 3, 4}
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces the list {4, 6, 8}.</p>
|
||
|
||
*=ph_filter=*
|
||
|
||
<p>This phrase produces a new list which is a thinner version of the one given, so that it contains only those values which match the description given. Example:</p>
|
||
<!-- START CODE "c8661" -->
|
||
<a id="c8661"></a><blockquote class="code"><p class="quoted">
|
||
filter to even numbers of {3, 8, 4, 19, 7}
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces {8, 4}, with the values 3, 19, and 7 failing to make it through. A sufficiently fine filter may well thin out a list to a single entry, or even no entries at all, but the result is always a list.</p>
|
||
|
||
*=ph_reduction=*
|
||
|
||
<p>This phrase works through the list and accumulates the values in it, using the phrase supplied. Example: if we have</p>
|
||
<!-- START CODE "c8667" -->
|
||
<a id="c8667"></a><blockquote class="code"><p class="quoted">
|
||
To decide what number is the sum of (N - number) and (M - number)
|
||
<br />    (this is summing):
|
||
<br />    decide on N + M.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then the summing reduction of {3, 8, 4, 19, 7} is the number 41, obtained by</p>
|
||
<!-- START CODE "c8668" -->
|
||
<a id="c8668"></a><blockquote class="code"><p class="quoted">
|
||
(((3 + 8) + 4) + 19) + 7
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>so that the summing phrase has been used four times.</p>
|
||
|
||
*=ph_nextstep=*
|
||
|
||
<p>This phrase tries to find a shortest route between the two given endpoints, using the given relation of objects to determine single steps. Example:</p>
|
||
<!-- START CODE "c4151" -->
|
||
<a id="c4151"></a><blockquote class="code"><p class="quoted">
|
||
next step via the overlooking relation from the Folly to the Chinese Lake
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>The result is the special object value "nothing" if the two endpoints are the same or if no route exists.</p>
|
||
|
||
*=ph_numbersteps=*
|
||
|
||
<p>This phrase tries to find the length of a shortest route between the two given endpoints, using the given relation of objects to determine single steps. Example:</p>
|
||
<!-- START CODE "c4152" -->
|
||
<a id="c4152"></a><blockquote class="code"><p class="quoted">
|
||
number of steps via the overlooking relation from the Folly to the Chinese Lake
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>The result is 0 if the two endpoints are the same, or -1 if no route exists.</p>
|
||
|
||
*=ph_thereis=*
|
||
|
||
<p>This condition is true if the entry referred to exists, that is, that is, the space for it in the table is not blank. Examples:</p>
|
||
<!-- START CODE "c5103" -->
|
||
<a id="c5103"></a><blockquote class="code"><p class="quoted">
|
||
if there is a symbol corresponding to an atomic number of 30 in the Table of Standard Elements ...
|
||
<br />if there is an atomic number in row 2 of the Table of Standard Elements ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_thereisno=*
|
||
|
||
<p>This condition is true if the entry referred to does not exist, that is, the space for it in the table is blank. Examples:</p>
|
||
<!-- START CODE "c5104" -->
|
||
<a id="c5104"></a><blockquote class="code"><p class="quoted">
|
||
if there is no symbol corresponding to an atomic number of 30 in the Table of Standard Elements ...
|
||
<br />if there is no atomic number in row 2 of the Table of Standard Elements ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_numberentries=*
|
||
|
||
<p>This phrase produces the number of positions in the list. Example:</p>
|
||
<!-- START CODE "c8414" -->
|
||
<a id="c8414"></a><blockquote class="code"><p class="quoted">
|
||
the number of entries in {1, 1, 1, 3, 1}
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>is 5, even though there are only two genuinely different items in the list.</p>
|
||
|
||
*=ph_decideon=*
|
||
|
||
<p>This phrase can only be used in the body of a definition of a phrase to decide a value. It causes the calculation to end immediately, with the outcome being the given value, which must be of the kind expected. Example:</p>
|
||
<!-- START CODE "c3041" -->
|
||
<a id="c3041"></a><blockquote class="code"><p class="quoted">
|
||
To decide which number is double (N - a number):
|
||
<br />    let D be N times N;
|
||
<br />    decide on D.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_otherwise=*
|
||
|
||
<p>This phrase can only be used as part of an "if ...:" or "unless: ...", and provides an alternative block of phrases to follow if the first block isn't followed. Example:</p>
|
||
<!-- START CODE "c2923" -->
|
||
<a id="c2923"></a><blockquote class="code"><p class="quoted">
|
||
if N is 2:
|
||
<br />    ...
|
||
<br />otherwise:
|
||
<br />    ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>When there is only a single phrase we can use the shortened form:</p>
|
||
<!-- START CODE "c2924" -->
|
||
<a id="c2924"></a><blockquote class="code"><p class="quoted">
|
||
if N is 2, say "Hooray, N is 2!";
|
||
<br />otherwise say "Boo, N is not 2...";
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>We can also supply an alternative condition:</p>
|
||
<!-- START CODE "c2925" -->
|
||
<a id="c2925"></a><blockquote class="code"><p class="quoted">
|
||
if N is 1:
|
||
<br />    ...
|
||
<br />otherwise if N is 2:
|
||
<br />    ...
|
||
<br />otherwise if N is greater than 4:
|
||
<br />    ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>At most one of the "..." clauses is ever reached - the first which works out.</p>
|
||
|
||
*=ph_switch=*
|
||
|
||
<p>This phrase switches between a variety of possible blocks of phrases to follow, depending on the value given. Example:</p>
|
||
<!-- START CODE "c2926" -->
|
||
<a id="c2926"></a><blockquote class="code"><p class="quoted">
|
||
if the dangerous item is:
|
||
<br />    -- the electric hairbrush:
|
||
<br />        say "Mind your head.";
|
||
<br />    -- the silver spoon:
|
||
<br />        say "Steer clear of the cutlery drawer."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>One alternative is allowed to be "otherwise", which is used only if none of the other cases apply, and which therefore guarantees that in any situation exactly one of the blocks will be followed.</p>
|
||
<!-- START CODE "c2927" -->
|
||
<a id="c2927"></a><blockquote class="code"><p class="quoted">
|
||
if N is:
|
||
<br />    -- 1: say "1.";
|
||
<br />    -- 2: say "2.";
|
||
<br />    -- otherwise: say "Neither 1 nor 2.";
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_boxed=*
|
||
|
||
<p>This phrase displays the given text on screen in an overlaid box. For reasons to do with the way such quotations are plotted onto the screen, their text is treated literally: no substitutions in square brackets are obeyed. The quotation will only ever appear once, regardless of the number of times the "display the boxed quotation ..." phrase is reached. Rather than being shown immediately - and thus, probably, scrolling away before it can be seen - the display is held back until the next command prompt is shown to the player. Example:</p>
|
||
<!-- START CODE "c1015" -->
|
||
<a id="c1015"></a><blockquote class="code"><p class="quoted">
|
||
After looking in the Wabe, display the boxed quotation
|
||
<br />    "And 'the wabe' is the grass-plot round
|
||
<br />    a sun-dial, I suppose? said Alice,
|
||
<br />    surprised at her own ingenuity.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<!-- START CODE "c1016" -->
|
||
<a id="c1016"></a><blockquote class="code"><p class="quoted">
|
||
    Of course it is. It's called 'wabe,'
|
||
<br />    you know, because it goes a long way
|
||
<br />    before it, and a long way behind it --
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<!-- START CODE "c1017" -->
|
||
<a id="c1017"></a><blockquote class="code"><p class="quoted">
|
||
    -- Lewis Carroll".
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This was the original example used in <span class="italic">Trinity</span>, by Brian Moriarty, which invented the idea. A player exploring Kensington Gardens comes upon a location enigmatically called The Wabe; and by way of explanation, this quotation pops up.</p>
|
||
|
||
*=ph_valuematch=*
|
||
|
||
<p>This condition is true if the value matches the description; the kinds must be compatible, or Inform will issue a problem message. There is no point using this for cases where the description is given explicitly:</p>
|
||
<!-- START CODE "c8630" -->
|
||
<a id="c8630"></a><blockquote class="code"><p class="quoted">
|
||
if 4 matches even numbers, ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>because it is easier to write just:</p>
|
||
<!-- START CODE "c8631" -->
|
||
<a id="c8631"></a><blockquote class="code"><p class="quoted">
|
||
if 4 is an even number, ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>So this condition is only useful when the description is stored in some variable, and its identity is not known.</p>
|
||
|
||
*=ph_chooseblankrow=*
|
||
|
||
<p>This phrase chooses a row in the given table which is currently blank under every column. A run-time problem message is issued if no rows are blank. Example:</p>
|
||
<!-- START CODE "c5136" -->
|
||
<a id="c5136"></a><blockquote class="code"><p class="quoted">
|
||
choose a blank row in Table 3;
|
||
<br />now element entry is "Fluorine";
|
||
<br />now symbol entry is "F";
|
||
<br />now atomic number entry is 9;
|
||
<br />now atomic weight entry is 19;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_numblank=*
|
||
|
||
<p>This phrase produces the number of rows in the given table which are entirely blank (that is, blank under every column).</p>
|
||
|
||
*=ph_numfilled=*
|
||
|
||
<p>This phrase produces the number of rows in the given table which are not entirely blank (that is, at least one column has a value in this row).</p>
|
||
|
||
*=ph_blankout=*
|
||
|
||
<p>This phrase replaces the entry referred to with a blank, erasing any value previously stored there. Example:</p>
|
||
<!-- START CODE "c5139" -->
|
||
<a id="c5139"></a><blockquote class="code"><p class="quoted">
|
||
choose row 1 in the Table of Fish Habitats;
|
||
<br />blank out the salinity entry;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_blankoutrow=*
|
||
|
||
<p>This phrase replaces the currently chosen row with blanks, erasing any value previously stored under any of the columns. Example:</p>
|
||
<!-- START CODE "c5140" -->
|
||
<a id="c5140"></a><blockquote class="code"><p class="quoted">
|
||
choose row 1 in the Table of Fish Habitats;
|
||
<br />blank out the whole row;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_blankoutcol=*
|
||
|
||
<p>This phrase replaces the currently chosen column with blanks, erasing any value previously stored in any of the rows. Example:</p>
|
||
<!-- START CODE "c5141" -->
|
||
<a id="c5141"></a><blockquote class="code"><p class="quoted">
|
||
blank out the whole salinity column in the Table of Fish Habitats;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_blankouttable=*
|
||
|
||
<p>This phrase replaces every row of the currently chosen table with blanks, erasing any value previously stored anywhere in it. Example:</p>
|
||
<!-- START CODE "c5142" -->
|
||
<a id="c5142"></a><blockquote class="code"><p class="quoted">
|
||
blank out the whole of the Table of Fish Habitats;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This is only really useful when a Table is being used to hold working space for some calculation or other.</p>
|
||
|
||
*=ph_yes=*
|
||
|
||
<p>This phrase can only be used in the definition of a phrase to decide whether a condition holds. It ends the decision process immediately and makes the condition true.</p>
|
||
|
||
*=ph_no=*
|
||
|
||
<p>This phrase can only be used in the definition of a phrase to decide whether a condition holds. It ends the decision process immediately and makes the condition false.</p>
|
||
|
||
*=ph_plus=*
|
||
|
||
<p>This phrase performs signed addition on the given values, whose kinds must agree, and produces the result. Examples:</p>
|
||
<!-- START CODE "c4548" -->
|
||
<a id="c4548"></a><blockquote class="code"><p class="quoted">
|
||
200 + 1 = 201
|
||
<br />10:04 AM + two minutes = 10:06 AM
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_minus=*
|
||
|
||
<p>This phrase performs signed subtraction on the given values, whose kinds must agree, and produces the result. Examples:</p>
|
||
<!-- START CODE "c4549" -->
|
||
<a id="c4549"></a><blockquote class="code"><p class="quoted">
|
||
200 - 1 = 199
|
||
<br />10:04 AM - two minutes = 10:02 AM
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_times=*
|
||
|
||
<p>This phrase performs signed multiplication on the given values, whose kinds must be dimensionally compatible, and produces the result. Examples:</p>
|
||
<!-- START CODE "c4550" -->
|
||
<a id="c4550"></a><blockquote class="code"><p class="quoted">
|
||
201 times 3 = 603
|
||
<br />two minutes times 4 = eight minutes
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_divide=*
|
||
|
||
<p>This phrase performs signed division on the given values, whose kinds must be dimensionally compatible, and produces the result. Examples:</p>
|
||
<!-- START CODE "c4551" -->
|
||
<a id="c4551"></a><blockquote class="code"><p class="quoted">
|
||
201 divided by 3 = 67
|
||
<br />twenty minutes divided by 4 = five minutes
|
||
<br />twenty minutes divided by five minutes = 4
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Division rounds down to the nearest whole number. An attempt to divide a number by 0 will cause a run-time problem message; but an attempt to divide a real number by 0 will instead produce plus infinity or minus infinity.</p>
|
||
|
||
*=ph_remainder=*
|
||
|
||
<p>This phrase performs signed division on the given values, whose kinds must be dimensionally compatible, and then produces the remainder. Examples:</p>
|
||
<!-- START CODE "c4552" -->
|
||
<a id="c4552"></a><blockquote class="code"><p class="quoted">
|
||
remainder after dividing 201 by 5 = 1
|
||
<br />remainder after dividing twenty minutes by 7 = six minutes
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>It is mathematically impossible to divide by 0, so any attempt to find the remainder after dividing a number by 0 will cause a run-time problem message. For a real number this won't arise and the remainder will usually be 0.0.</p>
|
||
|
||
*=ph_nearest=*
|
||
|
||
<p>This phrase rounds the given value off, rounding upward in boundary cases. Examples:</p>
|
||
<!-- START CODE "c4554" -->
|
||
<a id="c4554"></a><blockquote class="code"><p class="quoted">
|
||
201 to the nearest 5 = 200
|
||
<br />205 to the nearest 10 = 210
|
||
<br />10:27 AM to the nearest five minutes = 10:25 AM
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_squareroot=*
|
||
|
||
<p>This phrase produces an approximate square root, to the nearest integer, of the given value, which must be of a kind which has square roots. Example:</p>
|
||
<!-- START CODE "c4555" -->
|
||
<a id="c4555"></a><blockquote class="code"><p class="quoted">
|
||
square root of 16 = 4
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Trying to take the square root of a negative number will cause a run-time problem, because then we can't even nearly solve it.</p>
|
||
|
||
*=ph_realsquareroot=*
|
||
|
||
<p>This phrase produces a square root, as accurately as a real number can hold it, of the given value, which must be of a kind which has square roots. Example:</p>
|
||
<!-- START CODE "c4556" -->
|
||
<a id="c4556"></a><blockquote class="code"><p class="quoted">
|
||
real square root of 2 = 1.41421
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>The real square root of a negative number is nonexistent.</p>
|
||
|
||
*=ph_cuberoot=*
|
||
|
||
<p>This phrase produces an approximate cube root, to the nearest integer, of the given value, which must be of a kind which has cube roots. Example:</p>
|
||
<!-- START CODE "c4557" -->
|
||
<a id="c4557"></a><blockquote class="code"><p class="quoted">
|
||
cube root of 27 = 3
|
||
<br />cube root of -27 = -3
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_value=*
|
||
|
||
<p>This text substitution takes the value and produces a textual representation of it. Most kinds of value, and really all of the useful ones, are "sayable" - numbers, times, objects, rules, scenes, and so on. Example:</p>
|
||
<!-- START CODE "c850" -->
|
||
<a id="c850"></a><blockquote class="code"><p class="quoted">
|
||
The description of the wrist watch is "The dial reads [time of day]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Here "time of day" is a value - it's a time that varies, and time is a sayable kind of value, so we might get "The dial reads 11:03 AM."</p>
|
||
|
||
*=phs_a=*
|
||
|
||
<p>This text substitution produces the name of the object along with its indefinite article. Example:</p>
|
||
<!-- START CODE "c852" -->
|
||
<a id="c852"></a><blockquote class="code"><p class="quoted">
|
||
Instead of examining something (called the whatever):
|
||
<br />    "You can only just make out [a whatever]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which might produce "You can only just make out a lamp-post.", or "You can only just make out Trevor.", or "You can only just make out some soldiers." The "a" or "an" in the wording is replaced by whatever indefinite article applies, if any.</p>
|
||
|
||
*=phs_A=*
|
||
|
||
<p>This text substitution produces the name of the object along with its indefinite article, capitalised. Example:</p>
|
||
<!-- START CODE "c853" -->
|
||
<a id="c853"></a><blockquote class="code"><p class="quoted">
|
||
Instead of examining something (called the whatever):
|
||
<br />    "[A whatever] can be made out in the mist."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which might produce "A lamp-post can be made out in the mist.", or "Trevor can be made out in the mist.", or "Some soldiers can be made out in the mist." The "A" or "An" in the wording is replaced by whatever indefinite article applies, if any.</p>
|
||
|
||
*=phs_the=*
|
||
|
||
<p>This text substitution produces the name of the object along with its definite article. Example:</p>
|
||
<!-- START CODE "c854" -->
|
||
<a id="c854"></a><blockquote class="code"><p class="quoted">
|
||
Instead of examining something (called the whatever):
|
||
<br />    "You can only just make out [the whatever]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which might produce "You can only just make out the lamp-post.", or "You can only just make out Trevor.", or "You can only just make out the soldiers." The "the" in the wording is replaced by whatever definite article applies, if any.</p>
|
||
|
||
*=phs_The=*
|
||
|
||
<p>This text substitution produces the name of the object along with its definite article, capitalised. Example:</p>
|
||
<!-- START CODE "c855" -->
|
||
<a id="c855"></a><blockquote class="code"><p class="quoted">
|
||
Instead of examining something (called the whatever):
|
||
<br />    "[The whatever] may be a trick of the mist."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which might produce "The lamp-post may be a trick of the mist.", or "Trevor may be a trick of the mist.", or "The soldiers may be a trick of the mist." The "The" in the wording is replaced by whatever definite article applies, if any.</p>
|
||
|
||
*=ph_replacechar=*
|
||
|
||
<p>This phrase acts on the named text by placing the given text in place of the Nth character, counting from 1. Example:</p>
|
||
<!-- START CODE "c8221" -->
|
||
<a id="c8221"></a><blockquote class="code"><p class="quoted">
|
||
let V be "mope";
|
||
<br />replace character number 3 in V with "lecul";
|
||
<br />say V;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>says "molecule".</p>
|
||
|
||
*=ph_replaceword=*
|
||
|
||
<p>This phrase acts on the named text by placing the given text in place of the Nth word, counting from 1, and dividing words at spacing or punctuation. Example:</p>
|
||
<!-- START CODE "c8222" -->
|
||
<a id="c8222"></a><blockquote class="code"><p class="quoted">
|
||
let V be "Does the well run dry?";
|
||
<br />replace word number 3 in V with "jogger";
|
||
<br />say V;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>says "Does the jogger run dry?".</p>
|
||
|
||
*=ph_replacepword=*
|
||
|
||
<p>This phrase acts on the named text by placing the given text in place of the Nth word, counting from 1, and dividing words at spacing, counting punctuation runs as words in their own right. Example:</p>
|
||
<!-- START CODE "c8223" -->
|
||
<a id="c8223"></a><blockquote class="code"><p class="quoted">
|
||
let V be "Frankly, yes, I agree.";
|
||
<br />replace punctuated word number 2 in V with ":";
|
||
<br />say V;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>says "Frankly: yes, I agree.".</p>
|
||
|
||
*=ph_replaceupword=*
|
||
|
||
<p>This phrase acts on the named text by placing the given text in place of the Nth word, counting from 1, and dividing words at spacing, counting punctuation as part of a word just as if it were lettering. Example:</p>
|
||
<!-- START CODE "c8224" -->
|
||
<a id="c8224"></a><blockquote class="code"><p class="quoted">
|
||
let V be "Frankly, yes, I agree.";
|
||
<br />replace unpunctuated word number 2 in V with "of course";
|
||
<br />say V;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>says "Frankly, of course I agree.".</p>
|
||
|
||
*=ph_replaceline=*
|
||
|
||
<p>This phrase acts on the named text by placing the given text in place of the Nth line, counting from 1. Lines are divided by paragraph or line breaks.</p>
|
||
|
||
*=ph_replacepara=*
|
||
|
||
<p>This phrase acts on the named text by placing the given text in place of the Nth paragraph, counting from 1.</p>
|
||
|
||
*=ph_replace=*
|
||
|
||
<p>This phrase acts on the named text by searching and replacing, as many non-overlapping times as possible. Example:</p>
|
||
<!-- START CODE "c8225" -->
|
||
<a id="c8225"></a><blockquote class="code"><p class="quoted">
|
||
replace the text "a" in V with "z"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>changes every lower-case "a" to "z": the same thing done with the "case insensitively" option would change each "a" or "A" to "z".</p>
|
||
|
||
*=ph_replacewordin=*
|
||
|
||
<p>This phrase acts on the named text by searching and replacing, as many non-overlapping times as possible, where the search text must occur as a whole word. Example:</p>
|
||
<!-- START CODE "c8227" -->
|
||
<a id="c8227"></a><blockquote class="code"><p class="quoted">
|
||
replace the word "Bob" in V with "Robert"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>changes "Bob got on the Bobsleigh" to "Robert got on the Bobsleigh".</p>
|
||
|
||
*=ph_replacepwordin=*
|
||
|
||
<p>This phrase acts on the named text by searching and replacing, as many non-overlapping times as possible, where the search text must occur as a whole word or run of punctuation.</p>
|
||
|
||
*=ph_replacere=*
|
||
|
||
<p>This phrase acts on the named text by matching the regular expression and replacing anything which fits it, as many non-overlapping times as possible. Example:</p>
|
||
<!-- START CODE "c8228" -->
|
||
<a id="c8228"></a><blockquote class="code"><p class="quoted">
|
||
replace the regular expression "\d+" in V with "..."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>changes "The Battle of Waterloo, 1815, rivalled Trafalgar, 1805" to "The Battle of Waterloo, ..., rivalled Trafalgar, ...". The "case insensitively" causes lower and upper case letters to be treated as if the same letter.</p>
|
||
<p>When replacing a regular expression, the replacement text also has a few special meanings (though, thankfully, many fewer than for the expression itself). Once again "\n" and "\t" can be used for line break and tab characters, and "\\" must be used for an actual backslash. But, very usefully, "\1" to "\9" expand as the contents of groups numbered 1 to 9, and "\0" to the exact text matched. So:</p>
|
||
<!-- START CODE "c8229" -->
|
||
<a id="c8229"></a><blockquote class="code"><p class="quoted">
|
||
replace the regular expression "\d+" in V with "roughly \0"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>adds the word "roughly" in front of any run of digits in V, because \0 becomes in turn whichever run of digits matched. And</p>
|
||
<!-- START CODE "c8230" -->
|
||
<a id="c8230"></a><blockquote class="code"><p class="quoted">
|
||
replace the regular expression "(\w+) (.*)" in V with "\2, \1"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>performs the transformation "Frank Booth" to "Booth, Frank".</p>
|
||
<p>Finally, prefixing the number by "l" or "u" forces the text it represents into lower or upper case, respectively. For instance:</p>
|
||
<!-- START CODE "c8231" -->
|
||
<a id="c8231"></a><blockquote class="code"><p class="quoted">
|
||
replace the regular expression "\b(\w)(\w*)" in X with "\u1\l2";
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>changes the casing of X to "title casing", where each individual word is capitalised. (This is a little slow on large texts, since so many matches and replacements are made: it's more efficient to use the official phrases for changing case.)</p>
|
||
|
||
*=phs_extcredits=*
|
||
|
||
<p>This text substitution expands to one or more lines of text crediting each of the extensions used by the current source text, along with their version numbers and authors. Extensions whose authors have chosen the "use authorial modesty" option are missed out. Example:</p>
|
||
<!-- START CODE "c9023" -->
|
||
<a id="c9023"></a><blockquote class="code"><p class="quoted">
|
||
Standard Rules version 2/090402 by Graham Nelson
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_compextcredits=*
|
||
|
||
<p>This text substitution expands to one or more lines of text crediting each of the extensions used by the current source text, along with their version numbers and authors. Every extension is included, even those whose authors have opted for "use authorial modesty". Example:</p>
|
||
<!-- START CODE "c9025" -->
|
||
<a id="c9025"></a><blockquote class="code"><p class="quoted">
|
||
Standard Rules version 2/090402 by Graham Nelson
|
||
<br />Locksmith version 9 by Emily Short
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_holder=*
|
||
|
||
<p>This phrase produces the container, supporter, carrier, wearer or room in which the object resides.</p>
|
||
|
||
*=ph_firstheld=*
|
||
|
||
<p>This phrase produces the first of the list of things held by the object. Example:</p>
|
||
<!-- START CODE "c1983" -->
|
||
<a id="c1983"></a><blockquote class="code"><p class="quoted">
|
||
first thing held by Baroness Orczy
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_nextheld=*
|
||
|
||
<p>This phrase produces the next item of the list of things held by something. Example: suppose Baroness Orczy is carrying a lapdog and a string of pearls.</p>
|
||
<!-- START CODE "c1984" -->
|
||
<a id="c1984"></a><blockquote class="code"><p class="quoted">
|
||
next thing held after the lapdog
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>is then the string of pearls.</p>
|
||
|
||
*=ph_ifleft=*
|
||
|
||
<p>This condition is true if the value V is such that V relates to something by the given relation. Example: suppose partnership relates various texts to various texts. Then we can test</p>
|
||
<!-- START CODE "c4206" -->
|
||
<a id="c4206"></a><blockquote class="code"><p class="quoted">
|
||
if "chalk" relates to a text by the partnership relation, ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_ifright=*
|
||
|
||
<p>This condition is true if the value V is such that something relates to V by the given relation. Example: suppose partnership relates various texts to various texts. Then we can test</p>
|
||
<!-- START CODE "c4207" -->
|
||
<a id="c4207"></a><blockquote class="code"><p class="quoted">
|
||
if a text relates to "cheese" by the partnership relation, ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_rightlookup=*
|
||
|
||
<p>This phrase produces an Y such that the given value V relates to Y by the given relation. Example: suppose partnership relates various texts to various texts. Then we can obtain</p>
|
||
<!-- START CODE "c4208" -->
|
||
<a id="c4208"></a><blockquote class="code"><p class="quoted">
|
||
the text to which "chalk" relates by the partnership relation
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which might be, say, "cheese". It's a run-time problem to use this if no such Y exists.</p>
|
||
|
||
*=ph_leftlookup=*
|
||
|
||
<p>This phrase produces an X such that X relates to the given value V by the given relation. Example: suppose partnership relates various texts to various texts. Then we can obtain</p>
|
||
<!-- START CODE "c4209" -->
|
||
<a id="c4209"></a><blockquote class="code"><p class="quoted">
|
||
the text which relates to "cheese" by the partnership relation
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which might be, say, "chalk". It's a run-time problem to use this if no such X exists.</p>
|
||
|
||
*=ph_leftlookuplist=*
|
||
|
||
<p>This phrase produces a list of all the X such that X relates to the given value V by the given relation. Example: suppose partnership relates various texts to various texts. Then we can obtain</p>
|
||
<!-- START CODE "c4210" -->
|
||
<a id="c4210"></a><blockquote class="code"><p class="quoted">
|
||
list of texts which relate to "cheese" by the partnership relation
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which might be, say, { "chalk", "grapes", "macaroni" }. The answer might be the empty set, but that's not a problem.</p>
|
||
|
||
*=ph_rightlookuplist=*
|
||
|
||
<p>This phrase produces a list of all Y such that the given value V relates to Y by the given relation. Example: suppose partnership relates various texts to various texts. Then we can obtain</p>
|
||
<!-- START CODE "c4211" -->
|
||
<a id="c4211"></a><blockquote class="code"><p class="quoted">
|
||
list of texts to which "chalk" relates by the partnership relation
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which might be, say, { "cheese", "blackboard", "cliffs" }. The answer might be the empty set, but that's not a problem.</p>
|
||
|
||
*=ph_leftdomain=*
|
||
|
||
<p>This phrase produces a list of all X which relate to anything under the given relation. Example: suppose partnership relates various texts to various texts. Then we can obtain</p>
|
||
<!-- START CODE "c4212" -->
|
||
<a id="c4212"></a><blockquote class="code"><p class="quoted">
|
||
list of texts which the partnership relation relates
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_rightdomain=*
|
||
|
||
<p>This phrase produces a list of all Y which anything relates to under the given relation. Example: suppose partnership relates various texts to various texts. Then we can obtain</p>
|
||
<!-- START CODE "c4213" -->
|
||
<a id="c4213"></a><blockquote class="code"><p class="quoted">
|
||
list of texts which the partnership relation relates to
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_subform=*
|
||
|
||
<p>This takes a text and makes substitution occur immediately. For example,</p>
|
||
<!-- START CODE "c8148" -->
|
||
<a id="c8148"></a><blockquote class="code"><p class="quoted">
|
||
substituted form of "time of death, [time of day]"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces something like "time of death, 9:15 AM" rather than "time of death, [time of day]". It's entirely legal to apply this to text which never had any substitutions in, so</p>
|
||
<!-- START CODE "c8149" -->
|
||
<a id="c8149"></a><blockquote class="code"><p class="quoted">
|
||
substituted form of "balloon"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces "balloon".</p>
|
||
|
||
*=ph_nearestwholenumber=*
|
||
|
||
<p>This phrase performs signed addition on the given values, whose kinds must agree, and produces the result. Examples:</p>
|
||
<!-- START CODE "c4538" -->
|
||
<a id="c4538"></a><blockquote class="code"><p class="quoted">
|
||
1.4 to the nearest whole number = 1
|
||
<br />1.6 to the nearest whole number = 2
|
||
<br />-1.6 to the nearest whole number = 2
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>We probably ought to bear in mind that the limited range of "number" means that the nearest whole number might not be all that near. For example:</p>
|
||
<!-- START CODE "c4539" -->
|
||
<a id="c4539"></a><blockquote class="code"><p class="quoted">
|
||
6 x 10^23 to the nearest whole number = 2147483647
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>because 2147483647 is the highest value a "number" can have.</p>
|
||
|
||
*=ph_reverselist=*
|
||
|
||
<p>This phrase puts the list in reverse order. The old entry 1 becomes the new last entry, and so on: reversing an empty list or a list containing only one entry leaves it unchanged. Example:</p>
|
||
<!-- START CODE "c8406" -->
|
||
<a id="c8406"></a><blockquote class="code"><p class="quoted">
|
||
let L be {11, 12, 14, 15, 16, 17};
|
||
<br />reverse L;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>results in L being {17, 16, 15, 14, 12, 11}.</p>
|
||
|
||
*=ph_sortlist=*
|
||
|
||
<p>This phrase puts the list into ascending order. Example:</p>
|
||
<!-- START CODE "c8407" -->
|
||
<a id="c8407"></a><blockquote class="code"><p class="quoted">
|
||
let L be {6 PM, 11:13 AM, 4:21 PM, 9:01 AM};
|
||
<br />sort L;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>results in L being {9:01 AM, 11:13 AM, 4:21 PM, 6 PM}.</p>
|
||
|
||
*=ph_sortlistreverse=*
|
||
|
||
<p>This phrase puts the list into descending order. Example:</p>
|
||
<!-- START CODE "c8408" -->
|
||
<a id="c8408"></a><blockquote class="code"><p class="quoted">
|
||
let L be {6 PM, 11:13 AM, 4:21 PM, 9:01 AM};
|
||
<br />sort L in reverse order;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>results in L being {6 PM, 4:21 PM, 11:13 AM, 9:01 AM}.</p>
|
||
|
||
*=ph_sortlistrandom=*
|
||
|
||
<p>This phrase puts the list into a uniformly random order, shuffling it as if it were a pack of cards. Example:</p>
|
||
<!-- START CODE "c8409" -->
|
||
<a id="c8409"></a><blockquote class="code"><p class="quoted">
|
||
let L be {1, 2, 3, 4, 5, 6};
|
||
<br />sort L in random order;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>might result in L being {3, 1, 5, 6, 4, 2}. Or any of 719 other arrangements, including being left as it was.</p>
|
||
|
||
*=ph_sortlistproperty=*
|
||
|
||
<p>This phrase puts the list into ascending order of the values of the given property for the items in the list; this is only allowed if all of those values do have the property in question. Example:</p>
|
||
<!-- START CODE "c8410" -->
|
||
<a id="c8410"></a><blockquote class="code"><p class="quoted">
|
||
let L be the list of people;
|
||
<br />sort L in carrying capacity order;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>would arrange people with weaklings first, titans last.</p>
|
||
|
||
*=ph_sortlistpropertyreverse=*
|
||
|
||
<p>This phrase puts the list into descending order of the values of the given property for the items in the list; this is only allowed if all of those values do have the property in question. Example:</p>
|
||
<!-- START CODE "c8411" -->
|
||
<a id="c8411"></a><blockquote class="code"><p class="quoted">
|
||
let L be the list of people;
|
||
<br />sort L in reverse carrying capacity order;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>would arrange people with titans first, weaklings last.</p>
|
||
|
||
*=ph_rotatelist=*
|
||
|
||
<p>This phrase shuffles the entries of the list forwards (to the right) by one place, so that the 1st becomes 2nd, the 2nd becomes 3rd, and so on until the last, which becomes the new first entry. Example:</p>
|
||
<!-- START CODE "c8412" -->
|
||
<a id="c8412"></a><blockquote class="code"><p class="quoted">
|
||
let L be { "cow", "heifer", "bullock" };
|
||
<br />rotate L;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>results in L being { "bullock", "cow", "heifer" }.</p>
|
||
|
||
*=ph_rotatelistback=*
|
||
|
||
<p>This phrase shuffles the entries of the list backwards (to the left) by one place, so that the 3rd becomes 2nd, the 2nd becomes 1st, and so on; the previous 1st entry becomes the new last entry. Example:</p>
|
||
<!-- START CODE "c8413" -->
|
||
<a id="c8413"></a><blockquote class="code"><p class="quoted">
|
||
let L be { "cow", "heifer", "bullock" };
|
||
<br />rotate L backwards;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>results in L being { "heifer", "bullock", "cow"}. (This achieves the same effect as "reverse L; rotate L; reverse L;" but is a little faster, and a lot less effort to read.)</p>
|
||
|
||
*=ph_charnum=*
|
||
|
||
<p>This phrase produces the Nth character from the text, counting from 1. Characters include letters, digits, punctuation symbols, spaces or other letter-forms. Example:</p>
|
||
<!-- START CODE "c8054" -->
|
||
<a id="c8054"></a><blockquote class="code"><p class="quoted">
|
||
character number 8 in "numberless projects of social reform"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces "e". If the index is less than 1 or more than the length of the text, the result is an empty text, "".</p>
|
||
|
||
*=ph_numchars=*
|
||
|
||
<p>This phrase produces the number of characters from the text. Characters include letters, digits, punctuation symbols, spaces or other letter-forms. Examples:</p>
|
||
<!-- START CODE "c8055" -->
|
||
<a id="c8055"></a><blockquote class="code"><p class="quoted">
|
||
number of characters in "War and Peace"
|
||
<br />number of characters in ""
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produce 13 and 0 respectively.</p>
|
||
|
||
*=ph_wordnum=*
|
||
|
||
<p>This phrase produces the Nth word from the text, counting from 1. Words for this purpose are what's left after breaking the text up at punctuation or spacing (spaces, line breaks, paragraph breaks) and then removing that punctuation or spacing. Example:</p>
|
||
<!-- START CODE "c8057" -->
|
||
<a id="c8057"></a><blockquote class="code"><p class="quoted">
|
||
word number 3 in "ice-hot, don't you think?"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces "don't". If the index is less than 1 or more than the number of words in the text, the result is an empty text, "".</p>
|
||
|
||
*=ph_numwords=*
|
||
|
||
<p>This phrase produces the number of words from the text. Words for this purpose are what's left after breaking the text up at punctuation or spacing (spaces, line breaks, paragraph breaks) and then removing that punctuation or spacing. Example:</p>
|
||
<!-- START CODE "c8058" -->
|
||
<a id="c8058"></a><blockquote class="code"><p class="quoted">
|
||
number of words in "ice-hot, don't you think?"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces 5.</p>
|
||
|
||
*=ph_pwordnum=*
|
||
|
||
<p>This phrase produces the Nth word from the text, counting from 1. Words for this purpose are what's left after breaking the text up at punctuation or spacing (spaces, line breaks, paragraph breaks) and then removing the spacing, but leaving the punctuation as independent words. Example:</p>
|
||
<!-- START CODE "c8059" -->
|
||
<a id="c8059"></a><blockquote class="code"><p class="quoted">
|
||
punctuated word number 2 in "ice-hot, don't you think?"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces "-". The punctuated words here are "ice", "-", "hot", ",", "don't", "you", "think", "?". If two or more punctuation marks are adjacent, they are counted as different words, except for runs of dashes or periods: thus ",," has two punctuated words, but "--" and "..." have only one each. If the index is less than 1 or more than the number of punctuated words in the text, the result is an empty text, "".</p>
|
||
|
||
*=ph_numpwords=*
|
||
|
||
<p>This phrase produces the number of words from the text. Words for this purpose are what's left after breaking the text up at punctuation or spacing (spaces, line breaks, paragraph breaks) and then removing the spacing, but leaving the punctuation as independent words. Example:</p>
|
||
<!-- START CODE "c8060" -->
|
||
<a id="c8060"></a><blockquote class="code"><p class="quoted">
|
||
number of punctuated words in "ice-hot, don't you think?"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces 8; see if you can find them all.</p>
|
||
|
||
*=ph_upwordnum=*
|
||
|
||
<p>This phrase produces the Nth word from the text, counting from 1. Words for this purpose are what's left after breaking the text up at spacing (spaces, line breaks, paragraph breaks) but including all punctuation as if it were part of the spelling of the words it joins to. Example:</p>
|
||
<!-- START CODE "c8061" -->
|
||
<a id="c8061"></a><blockquote class="code"><p class="quoted">
|
||
unpunctuated word number 1 in "ice-hot, don't you think?"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces "ice-hot,". The unpunctuated words in "ice-hot, don't you think?" are "ice-hot,", "don't", "you", "think?". If the index is less than 1 or more than the number of punctuated words in the text, the result is an empty text, "".</p>
|
||
|
||
*=ph_numupwords=*
|
||
|
||
<p>This phrase produces the number of words from the text. Words for this purpose are what's left after breaking the text up at spacing (spaces, line breaks, paragraph breaks) but including all punctuation as if it were part of the spelling of the words it joins to. Example:</p>
|
||
<!-- START CODE "c8062" -->
|
||
<a id="c8062"></a><blockquote class="code"><p class="quoted">
|
||
number of unpunctuated words in "ice-hot, don't you think?"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces just 4.</p>
|
||
|
||
*=ph_linenum=*
|
||
|
||
<p>This phrase produces the Nth line from the text, counting from 1. Unless explicit use is made of line-breaking, lines and paragraphs will be the same - it doesn't refer to lines as visible on screen, because we have no way of knowing what size screen the player might have.</p>
|
||
|
||
*=ph_numlines=*
|
||
|
||
<p>This phrase produces the number of lines in the text. Unless explicit use is made of line-breaking, lines and paragraphs will be the same - it doesn't refer to lines as visible on screen, because we have no way of knowing what size screen the player might have. Example: the number of lines in</p>
|
||
<!-- START CODE "c8063" -->
|
||
<a id="c8063"></a><blockquote class="code"><p class="quoted">
|
||
"Sensational news just in![paragraph break]The Martians have invaded Miranda.[line break](One of the moons of Uranus, that is.)"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>is 3.</p>
|
||
|
||
*=ph_paranum=*
|
||
|
||
<p>This phrase produces the Nth paragraph from the text, counting from 1.</p>
|
||
|
||
*=ph_numparas=*
|
||
|
||
<p>This phrase produces the number of paragraphs in the text. Example: the number of paragraphs in</p>
|
||
<!-- START CODE "c8064" -->
|
||
<a id="c8064"></a><blockquote class="code"><p class="quoted">
|
||
"Sensational news just in![paragraph break]The Martians have invaded Miranda.[line break](One of the moons of Uranus, that is.)"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>is 2.</p>
|
||
|
||
*=ph_runthrough=*
|
||
|
||
<p>This phrase causes the block of phrases following it to be repeated once for each value matching the description, storing that value in the named variable. (The variable exists only temporarily, within the repetition.) Example:</p>
|
||
<!-- START CODE "c2956" -->
|
||
<a id="c2956"></a><blockquote class="code"><p class="quoted">
|
||
repeat with item running through open containers:
|
||
<br />    ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>If there are no containers, or they are all closed, the phrases will not be followed at all. Inform will issue a Problem message if the range of the loop may be infinite: for example, it won't allow:</p>
|
||
<!-- START CODE "c2957" -->
|
||
<a id="c2957"></a><blockquote class="code"><p class="quoted">
|
||
repeat with X running through odd numbers:
|
||
<br />    ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>On the other hand it will allow:</p>
|
||
<!-- START CODE "c2958" -->
|
||
<a id="c2958"></a><blockquote class="code"><p class="quoted">
|
||
repeat with T running through times:
|
||
<br />    ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which repeats 1440 times, starting with T at midnight and finishing at 11:59 PM. See the Kinds index for which kinds of value can be repeated through.</p>
|
||
|
||
*=ph_matches=*
|
||
|
||
<p>This condition is true if the second text occurs anywhere inside the first. Examples:</p>
|
||
<!-- START CODE "c8084" -->
|
||
<a id="c8084"></a><blockquote class="code"><p class="quoted">
|
||
if "[score]" matches the text "3", ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>tests whether the digit 3 occurs anywhere in the score, as printed out; and</p>
|
||
<!-- START CODE "c8085" -->
|
||
<a id="c8085"></a><blockquote class="code"><p class="quoted">
|
||
if the printed name of the location matches the text "the", ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>tests to see whether "the" can be found anywhere in the current room's name. Note that the location "Smotheringly Hot Jungle" would pass this test - it's there if you look. On the other hand, "The Orangery" would not, because "The" does not match against "the". We can get around this in a variety of ways, one of which is to tell Inform to be insensitive to the case (upper or lower) of letters:</p>
|
||
<!-- START CODE "c8086" -->
|
||
<a id="c8086"></a><blockquote class="code"><p class="quoted">
|
||
if the printed name of the location matches the text "the", case insensitively: ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_exactlymatches=*
|
||
|
||
<p>This condition is true if the second text matches the first, starting at the beginning and finishing at the end. This appears to be the same as testing if one is equal to the other, but that's not quite true: for example,</p>
|
||
<!-- START CODE "c8087" -->
|
||
<a id="c8087"></a><blockquote class="code"><p class="quoted">
|
||
if "[score]" exactly matches the text "[best score]", ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>is true if the score and best score currently print out as the same text, which will be true if they are currently equal as numbers; but</p>
|
||
<!-- START CODE "c8088" -->
|
||
<a id="c8088"></a><blockquote class="code"><p class="quoted">
|
||
if "[score]" is "[best score]", ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>is never true - these are different texts, even if they sometimes look the same.</p>
|
||
|
||
*=ph_nummatches=*
|
||
|
||
<p>This produces the number of times the second text occurs within the first. The matches are not allowed to overlap. Example:</p>
|
||
<!-- START CODE "c8089" -->
|
||
<a id="c8089"></a><blockquote class="code"><p class="quoted">
|
||
number of times "pell-mell sally" matches the text "ll" = 3
|
||
<br />number of times "xyzzy" matches the text "Z" = 0
|
||
<br />number of times "xyzzy" matches the text "Z", case insensitively = 2
|
||
<br />number of times "aaaaaaaa" matches the text "aaaa" = 2
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_islistedin=*
|
||
|
||
<p>This condition is true if the given value, which must be of a compatible kind, is one of those in the list. For instance, if L is our list of the numbers 2, 3, 5, 7 and 11 then 5 is listed in it but 6 is not.</p>
|
||
|
||
*=ph_isnotlistedin=*
|
||
|
||
<p>This condition is true if the given value, which must be of a compatible kind, is not one of those in the list.</p>
|
||
|
||
*=ph_repeatlist=*
|
||
|
||
<p>This phrase causes the block of phrases following it to be repeated once for each item in the given list, storing that value in the named variable. (The variable exists only temporarily, within the repetition.) Example:</p>
|
||
<!-- START CODE "c8342" -->
|
||
<a id="c8342"></a><blockquote class="code"><p class="quoted">
|
||
let L be {2, 3, 5, 7, 11, 13, 17, 19};
|
||
<br />repeat with prime running through L:
|
||
<br />    ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>If the list is empty, nothing happens: the "..." phrase(s) are never tried.</p>
|
||
|
||
*=ph_hashappened=*
|
||
|
||
<p>This condition is true if the given scene has both begun and ended.</p>
|
||
|
||
*=ph_hasnothappened=*
|
||
|
||
<p>This condition is true if the given scene has not ended (or never started).</p>
|
||
|
||
*=ph_hasended=*
|
||
|
||
<p>This condition is true if the given scene ended at least once.</p>
|
||
|
||
*=ph_hasnotended=*
|
||
|
||
<p>This condition is true if the given scene has never ended.</p>
|
||
|
||
*=ph_actionof=*
|
||
|
||
<p>This phrase produces a literally typed action as a value. Example:</p>
|
||
<!-- START CODE "c3657" -->
|
||
<a id="c3657"></a><blockquote class="code"><p class="quoted">
|
||
now the best idea yet is the action of pushing the button;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>The action must be specific in every respect, so "action of taking something" or "action of doing something" will not work - "taking something" is really a general description of many possible actions, not an action in its own right.</p>
|
||
|
||
*=ph_currentaction=*
|
||
|
||
<p>This phrase produces the action currently being processed as a value - it literally stores the action, and remembers, if necessary, the exact wording of the player's command at the time it was stored - so that even actions arising from commands like LOOK UP X100 IN THE CODE BOOK can be stored faithfully. Examples:</p>
|
||
<!-- START CODE "c3658" -->
|
||
<a id="c3658"></a><blockquote class="code"><p class="quoted">
|
||
let the present whim be the current action;
|
||
<br />say "How you would like to be [current action].";
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This only makes sense if an action is currently going on, so it shouldn't be used in "every turn" rules, for instance.</p>
|
||
|
||
*=ph_trystored=*
|
||
|
||
<p>This phrase makes the stored action take effect now. Example:</p>
|
||
<!-- START CODE "c3659" -->
|
||
<a id="c3659"></a><blockquote class="code"><p class="quoted">
|
||
try the present whim;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>If the present whim contains, say, the action of taking the beach ball, then the effect is exactly the same as "try taking the beach ball". The stored action isn't destroyed or otherwise used up in the process, so it can be tried again another time, as often as we like.</p>
|
||
|
||
*=ph_trystoredsilently=*
|
||
|
||
<p>This phrase makes the stored action take effect now, under the "silent" convention which means that routine messages aren't printed. Example:</p>
|
||
<!-- START CODE "c3660" -->
|
||
<a id="c3660"></a><blockquote class="code"><p class="quoted">
|
||
silently try the present whim;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>If the present whim contains, say, the action of taking the beach ball, and the action succeeds, nothing is printed, but if something goes awry then a message is printed to say why. Either way, the effect is exactly the same as "try silently taking the beach ball".</p>
|
||
|
||
*=ph_actionpart=*
|
||
|
||
<p>This phrase produces the action name part of an action. Example: suppose the current actor is Algy, who is throwing the brick at Biggles. Then</p>
|
||
<!-- START CODE "c3668" -->
|
||
<a id="c3668"></a><blockquote class="code"><p class="quoted">
|
||
action name part of the current action = throwing it at action
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_nounpart=*
|
||
|
||
<p>This phrase produces the (first) noun of an action. Example: suppose the current actor is Algy, who is throwing the brick at Biggles. Then</p>
|
||
<!-- START CODE "c3669" -->
|
||
<a id="c3669"></a><blockquote class="code"><p class="quoted">
|
||
noun part of the current action = the brick
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>If the noun is something other than an object, this produces just "nothing", the non-object.</p>
|
||
|
||
*=ph_secondpart=*
|
||
|
||
<p>This phrase produces the second noun of an action. Example: suppose the current actor is Algy, who is throwing the brick at Biggles. Then</p>
|
||
<!-- START CODE "c3670" -->
|
||
<a id="c3670"></a><blockquote class="code"><p class="quoted">
|
||
second noun part of the current action = Biggles
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>If the second noun is something other than an object (for instance for the command SET DIAL TO 3417 it would be the number 3417), this produces just "nothing", the non-object.</p>
|
||
|
||
*=ph_actorpart=*
|
||
|
||
<p>This phrase produces the person who would be carrying out the action if it were being tried. Example: suppose the current actor is Algy, who is throwing the brick at Biggles. Then</p>
|
||
<!-- START CODE "c3671" -->
|
||
<a id="c3671"></a><blockquote class="code"><p class="quoted">
|
||
actor part of the current action = Algy
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_involves=*
|
||
|
||
<p>This condition is true if the object appears as any of the actor, the noun or the second noun in the action. Example:</p>
|
||
<!-- START CODE "c3672" -->
|
||
<a id="c3672"></a><blockquote class="code"><p class="quoted">
|
||
if the current action involves Algy
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>would be true for "give revolver to Algy", "Algy trying flying the Sopwith Camel", "examine Algy" and so on, but false for "ask Raymond about secret airfield".</p>
|
||
|
||
*=ph_indarkness=*
|
||
|
||
<p>This condition is true if the player currently has no light to see by. Note that the test is more complicated than simply testing</p>
|
||
<!-- START CODE "c2868" -->
|
||
<a id="c2868"></a><blockquote class="code"><p class="quoted">
|
||
if the player is in a dark room, ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>since the player might have a torch, or be inside a cage which is itself in a dark room, and so on.</p>
|
||
|
||
*=ph_consents=*
|
||
|
||
<p>This condition is unusual in doing something and not simply making a silent check: it waits for the player to type YES (or Y) or NO (or N) at the keyboard, and then is true if the answer was yes. Example:</p>
|
||
<!-- START CODE "c2869" -->
|
||
<a id="c2869"></a><blockquote class="code"><p class="quoted">
|
||
say "Are you quite sure you want to kiss the Queen? ";
|
||
<br />if the player consents:
|
||
<br />    ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_whether=*
|
||
|
||
<p>This phrase converts a condition into its result as a value, which is always either "true" or "false". Example:</p>
|
||
<!-- START CODE "c2870" -->
|
||
<a id="c2870"></a><blockquote class="code"><p class="quoted">
|
||
whether or not 20 is an odd number
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces the truth state "false". This is mostly useful for storing up results to look at later:</p>
|
||
<!-- START CODE "c2871" -->
|
||
<a id="c2871"></a><blockquote class="code"><p class="quoted">
|
||
let victory be whether or not all the treasures are in the cabinet;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>and then subsequently:</p>
|
||
<!-- START CODE "c2872" -->
|
||
<a id="c2872"></a><blockquote class="code"><p class="quoted">
|
||
if victory is true, ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_playsf=*
|
||
|
||
<p>This phrase causes the sound effect to be played. If the option "one time only" is used, it will have no effect if the sound effect has been played before. Example:</p>
|
||
<!-- START CODE "c8697" -->
|
||
<a id="c8697"></a><blockquote class="code"><p class="quoted">
|
||
play the sound of rustling leaves;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_listofdesc=*
|
||
|
||
<p>This phrase produces the list of all values matching the given description. Inform will issue a problem message if the result would be an infinite list, or one which is impractical to test: for instance "list of even numbers" is not feasible.</p>
|
||
|
||
*=ph_multipleobjectlist=*
|
||
|
||
<p>This phrase produces the current multiple object list as a value. The list will be the collection of objects found to match a plural noun like ALL in the most recent command typed by the player. If there is no multiple object, say if the command was TAKE PEAR, the list will be empty: it won't be a list of size 1.</p>
|
||
|
||
*=ph_altermultipleobjectlist=*
|
||
|
||
<p>This phrase sets the multiple object list to the given value. The list is ordinarily the collection of objects found to match a plural noun like ALL in the most recent command typed by the player, but using this phrase at the right moment (before the "generate action rule" in the turn sequence rules takes effect).</p>
|
||
|
||
*=ph_durationmins=*
|
||
|
||
<p>This phrase converts numbers into lengths of time. Example:</p>
|
||
<!-- START CODE "c2205" -->
|
||
<a id="c2205"></a><blockquote class="code"><p class="quoted">
|
||
15 minutes
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Because it's a phrase, not just a notation for writing constants down, the number doesn't have to be given literally:</p>
|
||
<!-- START CODE "c2206" -->
|
||
<a id="c2206"></a><blockquote class="code"><p class="quoted">
|
||
let X be 5;
|
||
<br />if the player is in the Slow Room, now X is 10;
|
||
<br />let deadline be the time of day plus X minutes;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Note that lengths of time can't exceed 1440 minutes.</p>
|
||
|
||
*=ph_durationhours=*
|
||
|
||
<p>This phrase converts numbers into lengths of time. Example:</p>
|
||
<!-- START CODE "c2207" -->
|
||
<a id="c2207"></a><blockquote class="code"><p class="quoted">
|
||
10 hours
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Note that lengths of time can't exceed 24 hours.</p>
|
||
|
||
*=ph_movebackdrop=*
|
||
|
||
<p>This phrase moves the backdrop so that it is now present in every room matching the given description. Example: If we define</p>
|
||
<!-- START CODE "c1843" -->
|
||
<a id="c1843"></a><blockquote class="code"><p class="quoted">
|
||
A room can be wet or dry. A room is usually dry. The Rock Pool is wet.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then we can write</p>
|
||
<!-- START CODE "c1844" -->
|
||
<a id="c1844"></a><blockquote class="code"><p class="quoted">
|
||
move the stream backdrop to all wet rooms;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This phrasing, "move the ... backdrop to all ..." is deliberately meant to look unlike the simpler "move ... to ...", to emphasise that this kind of movement is possible only for backdrops.</p>
|
||
|
||
*=ph_updatebackdrop=*
|
||
|
||
<p>This phrase runs through all backdrops in the model world and makes sure they are correctly in, or not in, the current location, so that everything appears right from the player's point of view. Example:</p>
|
||
<!-- START CODE "c1845" -->
|
||
<a id="c1845"></a><blockquote class="code"><p class="quoted">
|
||
The Upper Cave is above the Rock Pool. The Ledge is east of the Pool. The stream is a backdrop.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<!-- START CODE "c1846" -->
|
||
<a id="c1846"></a><blockquote class="code"><p class="quoted">
|
||
When play begins:
|
||
<br />    move the stream backdrop to all wet rooms.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<!-- START CODE "c1847" -->
|
||
<a id="c1847"></a><blockquote class="code"><p class="quoted">
|
||
A lever is in the Cave. The lever is fixed in place.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<!-- START CODE "c1848" -->
|
||
<a id="c1848"></a><blockquote class="code"><p class="quoted">
|
||
Instead of pulling the lever when the Cave is dry:
|
||
<br />    now the Cave is wet;
|
||
<br />    now the lever is in the Rock Pool;
|
||
<br />    now the lever is portable;
|
||
<br />    update backdrop positions;
|
||
<br />    say "The old rusty lever pulls away, and the thin cave wall goes with it, so that a stream bursts into the cave, falling to the pool below."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_followfor=*
|
||
|
||
<p>This phrase causes the rule to be obeyed immediately (rather than simply at predetermined times such as when a particular action is being tried, or at the end of every turn, and such), and applies it to the value given, which must be of a matching kind. Example:</p>
|
||
<!-- START CODE "c7821" -->
|
||
<a id="c7821"></a><blockquote class="code"><p class="quoted">
|
||
follow the reaching inside rulebook for the electrified cage;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_listbraced=*
|
||
|
||
<p>This text substitution produces the list in the form of "{", then a comma-separated list, and then "}", which looks less like an English sentence but more mathematical. Example:</p>
|
||
<!-- START CODE "c8308" -->
|
||
<a id="c8308"></a><blockquote class="code"><p class="quoted">
|
||
"[list of people in brace notation]"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>might produce "{ yourself, Mr Darcy, Flashman }".</p>
|
||
|
||
*=phs_listdef=*
|
||
|
||
<p>This text substitution writes out the list in sentence form, adding the appropriate definite articles. Example:</p>
|
||
<!-- START CODE "c8310" -->
|
||
<a id="c8310"></a><blockquote class="code"><p class="quoted">
|
||
let L be {the piano, the music stand};
|
||
<br />say "[L with definite articles]";
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>says "the piano and the music stand".</p>
|
||
|
||
*=phs_listindef=*
|
||
|
||
<p>This text substitution writes out the list in sentence form, adding the appropriate indefinite articles. Example:</p>
|
||
<!-- START CODE "c8311" -->
|
||
<a id="c8311"></a><blockquote class="code"><p class="quoted">
|
||
let L be {the piano, the music stand};
|
||
<br />say "[L with definite articles]";
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>says "a piano and a music stand".</p>
|
||
|
||
*=phs_here=*
|
||
|
||
<p>Produces "here" if the story tense is the present tense, and "there" otherwise.</p>
|
||
|
||
*=phs_now=*
|
||
|
||
<p>Produces "now" if the story tense is the present tense, and "then" otherwise.</p>
|
||
|
||
*=ph_matchesre=*
|
||
|
||
<p>This condition is true if any contiguous part of the text can be matched against the given regular expression. Examples:</p>
|
||
<!-- START CODE "c8090" -->
|
||
<a id="c8090"></a><blockquote class="code"><p class="quoted">
|
||
if "taramasalata" matches the regular expression "a.*l", ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>is true, since this looks for a part of "taramasalata" which begins with "a", continues with any number of characters, and finishes with "l"; so it matches "aramasal". (Not "asal", because it gets the makes the leftmost match it can.) The option "case insensitively" causes lower and upper case letters to be treated as equivalent.</p>
|
||
|
||
*=ph_exactlymatchesre=*
|
||
|
||
<p>This condition is true if the whole text (starting from the beginning and finishing at the end) can be matched against the given regular expression. The option "case insensitively" causes lower and upper case letters to be treated as equivalent.</p>
|
||
|
||
*=ph_nummatchesre=*
|
||
|
||
<p>This produces the number of times that contiguous pieces of the text can be matched against the regular expression, without allowing them to overlap.</p>
|
||
|
||
*=ph_matchtext=*
|
||
|
||
<p>This phrase is only meaningful immediately after a successful match of a regular expression against text, and it produces the text which matched. Example:</p>
|
||
<!-- START CODE "c8091" -->
|
||
<a id="c8091"></a><blockquote class="code"><p class="quoted">
|
||
if "taramasalata" matches the regular expression "m.*l":
|
||
<br />    say "[text matching regular expression].";
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>says "masal."</p>
|
||
|
||
*=ph_subexpressiontext=*
|
||
|
||
<p>This phrase is only meaningful immediately after a successful match of a regular expression against text, and it produces the text which matched. The number must be from 1 to 9, and must correspond to one of the bracketed groups in the expression just matched. Example: after</p>
|
||
<!-- START CODE "c8110" -->
|
||
<a id="c8110"></a><blockquote class="code"><p class="quoted">
|
||
if "taramasalata" matches the regular expression "a(r.*l)a(.)":
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>the "text matching regular expression" is "aramasalat", the "text matching subexpression 1" is "ramasal", and "text matching subexpression 2" is "t".</p>
|
||
|
||
*=phs_surroundings=*
|
||
|
||
<p>This text substitution produces a succinct description of where the player is, be this in darkness, in a lighted room or inside an opaque container such as a large packing case. Example:</p>
|
||
<!-- START CODE "c1746" -->
|
||
<a id="c1746"></a><blockquote class="code"><p class="quoted">
|
||
now the left hand status line is "You: [the player's surroundings]";
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_shiftbefore=*
|
||
|
||
<p>This phrase produces a time earlier by the amount given, keeping within the 24 hour clock. Example:</p>
|
||
<!-- START CODE "c2209" -->
|
||
<a id="c2209"></a><blockquote class="code"><p class="quoted">
|
||
7 hours before 5:30 AM
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces 10:30 PM.</p>
|
||
|
||
*=ph_shiftafter=*
|
||
|
||
<p>This phrase produces a time later by the amount given, keeping within the 24 hour clock. Example:</p>
|
||
<!-- START CODE "c2210" -->
|
||
<a id="c2210"></a><blockquote class="code"><p class="quoted">
|
||
9 hours after 11 AM
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces 8 PM.</p>
|
||
|
||
*=ph_timebefore=*
|
||
|
||
<p>This condition is true if the first time occurs earlier in the day than the second. In recognition of the fact that very few stories begin before 4 AM, whereas many run on past midnight, the start of the day is taken to be 4 AM: thus 3:59 AM is after 11:10 PM, but 4:04 AM is before it.</p>
|
||
|
||
*=ph_timeafter=*
|
||
|
||
<p>This condition is true if the first time occurs later in the day than the second. In recognition of the fact that very few stories begin before 4 AM, whereas many run on past midnight, the start of the day is taken to be 4 AM: thus 3:59 AM is after 11:10 PM, but 4:04 AM is before it.</p>
|
||
|
||
*=ph_writetable=*
|
||
|
||
<p>This phrase causes the entire contents of the given table to be written out to the given file. Note that files must have been declared, and must be referred to by their Inform names, not by textual filenames. Example:</p>
|
||
<!-- START CODE "c8708" -->
|
||
<a id="c8708"></a><blockquote class="code"><p class="quoted">
|
||
write File of Glaciation Data from the Table of Antarctic Reserves
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Any blank rows in the table are automatically moved to the bottom, and only the non-blank rows are written.</p>
|
||
|
||
*=ph_readtable=*
|
||
|
||
<p>This phrase causes the entire contents of the given table to be read in from the given file. Note that files must have been declared, and must be referred to by their Inform names, not by textual filenames. Example:</p>
|
||
<!-- START CODE "c8709" -->
|
||
<a id="c8709"></a><blockquote class="code"><p class="quoted">
|
||
read File of Glaciation Data into the Table of Antarctic Reserves
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Any rows left spare at the foot of the table are automatically blanked. On the other hand if the file is too large to fit into the table - with too many columns or too many rows - a run-time problem is produced.</p>
|
||
|
||
*=ph_fileexists=*
|
||
|
||
<p>This condition is true if the file-system used by the player appears to contain a file with the right name. For example, if we declared:</p>
|
||
<!-- START CODE "c8710" -->
|
||
<a id="c8710"></a><blockquote class="code"><p class="quoted">
|
||
The binary File of Glaciation Data is called "icedata".
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>and then tested</p>
|
||
<!-- START CODE "c8711" -->
|
||
<a id="c8711"></a><blockquote class="code"><p class="quoted">
|
||
if the File of Glaciation Data exists, ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then Inform would search for a file called "icedata". (The arrangements for where this might be stored, and its filename extension, vary from platform to platform.)</p>
|
||
|
||
*=ph_showmetable=*
|
||
|
||
<p>This phrase prints a crude but sometimes useful display on screen of the current contents of the named table. It's intended for authors to see when testing, not for players to see.</p>
|
||
|
||
*=phs_currenttablerow=*
|
||
|
||
<p>This text substitution produces a crude but sometimes useful listing of the entries in the currently chosen table row.</p>
|
||
|
||
*=phs_tablerow=*
|
||
|
||
<p>This text substitution produces a crude but sometimes useful listing of the entries in the specified row.</p>
|
||
|
||
*=phs_tablecolumn=*
|
||
|
||
<p>This text substitution produces a crude but sometimes useful listing of the entries in the specified column.</p>
|
||
|
||
*=ph_setpronouns=*
|
||
|
||
<p>This phrase adjusts the meaning of pronouns like IT, HIM, HER and THEM in the command parser as if the object mentioned has become the subject of conversation. Example: the combination of</p>
|
||
<!-- START CODE "c6095" -->
|
||
<a id="c6095"></a><blockquote class="code"><p class="quoted">
|
||
set pronouns from the key;
|
||
<br />set pronouns from Bunny;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>might change IT to mean the silver key and HIM to mean Harry "Bunny" Manders, while leaving HER and THEM unaltered.</p>
|
||
|
||
*=ph_numrows=*
|
||
|
||
<p>This phrase produces the number of rows (including any blank rows) in the given table. Example:</p>
|
||
<!-- START CODE "c5036" -->
|
||
<a id="c5036"></a><blockquote class="code"><p class="quoted">
|
||
number of rows in the Table of Selected Elements
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_listof=*
|
||
|
||
<p>This text substitution produces a list, in sentence form, of everything matching the description. Example:</p>
|
||
<!-- START CODE "c868" -->
|
||
<a id="c868"></a><blockquote class="code"><p class="quoted">
|
||
"Mr Darcy glares proudly at you. He is wearing [list of things worn by Darcy] and carrying [list of things carried by Darcy]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>And, if this were from a dramatisation of the novel by Miss Fielding rather than Miss Austen, we might find:</p>
|
||
<!-- START CODE "c869" -->
|
||
<a id="c869"></a><blockquote class="code"><p class="quoted">
|
||
Mr Darcy glares proudly at you. He is wearing a pair of Newcastle United boxer shorts and carrying a self-help book.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>If the description matches nothing - for instance, if Darcy has empty hands - then "nothing" is printed.</p>
|
||
|
||
*=phs_alistof=*
|
||
|
||
<p>This text substitution produces a list, in sentence form, of everything matching the description. Each item is prefaced by its indefinite article. Example:</p>
|
||
<!-- START CODE "c872" -->
|
||
<a id="c872"></a><blockquote class="code"><p class="quoted">
|
||
a maritime bill of lading, some hemp rope and Falconer's Naval Dictionary
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_Alistof=*
|
||
|
||
<p>This text substitution produces a list, in sentence form, of everything matching the description. Each item is prefaced by its indefinite article, and the first is capitalised, so that it can be used at the beginning of a sentence. Example:</p>
|
||
<!-- START CODE "c873" -->
|
||
<a id="c873"></a><blockquote class="code"><p class="quoted">
|
||
A maritime bill of lading, some hemp rope and Falconer's Naval Dictionary
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_thelistof=*
|
||
|
||
<p>This text substitution produces a list, in sentence form, of everything matching the description. Each item is prefaced by its definite article. Example:</p>
|
||
<!-- START CODE "c874" -->
|
||
<a id="c874"></a><blockquote class="code"><p class="quoted">
|
||
the maritime bill of lading, the hemp rope and Falconer's Naval Dictionary
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_Thelistof=*
|
||
|
||
<p>This text substitution produces a list, in sentence form, of everything matching the description. Each item is prefaced by its definite article, and the first is capitalised, so that it can be used at the beginning of a sentence. Example:</p>
|
||
<!-- START CODE "c875" -->
|
||
<a id="c875"></a><blockquote class="code"><p class="quoted">
|
||
The maritime bill of lading, the hemp rope and Falconer's Naval Dictionary
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_islistof=*
|
||
|
||
<p>This text substitution produces a list, in sentence form, of everything matching the description. The whole list starts with "is" (if there's one item or none) or "are" (more than one). Examples:</p>
|
||
<!-- START CODE "c880" -->
|
||
<a id="c880"></a><blockquote class="code"><p class="quoted">
|
||
is marlin-spike
|
||
<br />are maritime bill of lading, hemp rope and Falconer's Naval Dictionary
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_isalistof=*
|
||
|
||
<p>This text substitution produces a list, in sentence form, of everything matching the description. Each item is prefaced by its indefinite article, and the whole list starts with "is" (if there's one item or none) or "are" (more than one). Examples:</p>
|
||
<!-- START CODE "c881" -->
|
||
<a id="c881"></a><blockquote class="code"><p class="quoted">
|
||
is a marlin-spike
|
||
<br />are a maritime bill of lading, some hemp rope and Falconer's Naval Dictionary
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_isthelistof=*
|
||
|
||
<p>This text substitution produces a list, in sentence form, of everything matching the description. Each item is prefaced by its definite article, and the whole list starts with "is" (if there's one item or none) or "are" (more than one). Examples:</p>
|
||
<!-- START CODE "c882" -->
|
||
<a id="c882"></a><blockquote class="code"><p class="quoted">
|
||
is the marlin-spike
|
||
<br />are the maritime bill of lading, the hemp rope and Falconer's Naval Dictionary
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_alistofconts=*
|
||
|
||
<p>This text substitution produces a list, in sentence form, of everything matching the description, noting any contents in brackets. This is really intended only to be used by the Standard Rules.</p>
|
||
|
||
*=ph_degrees=*
|
||
|
||
<p>Inform measures angles in radians, a convention in which the angle for a half circle is pi, and a right angle is pi divided by 2. This is better from a mathematical point of view, but in practice most people think about angles using degrees, where 180 degrees is a half-circle and a right angle is 90 degrees. This phrase helps with that by converting from degrees to radians: in other words, it multiplies by 0.0174532925, since that's roughly 1/180th of pi. Examples:</p>
|
||
<!-- START CODE "c4569" -->
|
||
<a id="c4569"></a><blockquote class="code"><p class="quoted">
|
||
sine of 90 degrees = 0.0
|
||
<br />cosine of 60 degrees = 0.5
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_sine=*
|
||
|
||
<p>The length of the upright of a right-angled triangle with this angle and a hypotenuse of length 1, where angle is measured in radians. Examples:</p>
|
||
<!-- START CODE "c4570" -->
|
||
<a id="c4570"></a><blockquote class="code"><p class="quoted">
|
||
sine of 0 = 0
|
||
<br />sine of 45 degrees = 0.70711
|
||
<br />sine of (pi divided by 4) = 0.70711
|
||
<br />sine of (pi divided by 2) = 1.0
|
||
<br />sine of pi = 0
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_cosine=*
|
||
|
||
<p>The length of the base of a right-angled triangle with this angle and a hypotenuse of length 1, where angle is measured in radians. Examples:</p>
|
||
<!-- START CODE "c4571" -->
|
||
<a id="c4571"></a><blockquote class="code"><p class="quoted">
|
||
cosine of 0 = 1.0
|
||
<br />cosine of 45 degrees = 0.70711
|
||
<br />cosine of (pi divided by 4) = 0.70711
|
||
<br />cosine of (pi divided by 2) = 0.0
|
||
<br />cosine of pi = -1.0
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_tangent=*
|
||
|
||
<p>The ratio of the upright length to the base length in a right-angled triangle with this angle and a hypotenuse of length 1, where angle is measured in radians. Examples:</p>
|
||
<!-- START CODE "c4572" -->
|
||
<a id="c4572"></a><blockquote class="code"><p class="quoted">
|
||
tangent of 0 = 0.0
|
||
<br />tangent of 45 degrees = 1.0
|
||
<br />tangent of (pi divided by 4) = 1.0
|
||
<br />tangent of (pi divided by 2) = plus infinity
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_arcsine=*
|
||
|
||
<p>The inverse of the sine function.</p>
|
||
|
||
*=ph_arccosine=*
|
||
|
||
<p>The inverse of the cosine function.</p>
|
||
|
||
*=ph_arctangent=*
|
||
|
||
<p>The inverse of the tangent function.</p>
|
||
|
||
*=ph_hyperbolicsine=*
|
||
|
||
<p>The hyperbolic sine function, often written "sinh" but pronounced "shine".</p>
|
||
|
||
*=ph_hyperboliccosine=*
|
||
|
||
<p>The hyperbolic cosine function, often written "cosh".</p>
|
||
|
||
*=ph_hyperbolictangent=*
|
||
|
||
<p>The hyperbolic tangent function, often written "tanh".</p>
|
||
|
||
*=ph_hyperbolicarcsine=*
|
||
|
||
<p>The inverse of the hyperbolic sine function.</p>
|
||
|
||
*=ph_hyperbolicarccosine=*
|
||
|
||
<p>The inverse of the hyperbolic cosine function.</p>
|
||
|
||
*=ph_hyperbolicarctangent=*
|
||
|
||
<p>The inverse of the hyperbolic tangent function.</p>
|
||
|
||
*=ph_displayfigure=*
|
||
|
||
<p>This phrase causes the figure to be displayed in the centre of the screen visible to the player. If the option "one time only" is used, it will have no effect if the figure has been displayed before. Example:</p>
|
||
<!-- START CODE "c8694" -->
|
||
<a id="c8694"></a><blockquote class="code"><p class="quoted">
|
||
display the Figure of Woodlands;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_chooserow=*
|
||
|
||
<p>This phrase selects the row with the given number. Row numbers in a table start from 1, so</p>
|
||
<!-- START CODE "c5086" -->
|
||
<a id="c5086"></a><blockquote class="code"><p class="quoted">
|
||
choose row 1 from the Table of Recent Monarchs
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>selects the top row.</p>
|
||
|
||
*=ph_chooserowwith=*
|
||
|
||
<p>This phrase selects the first row, working down from the top of the given table, in which the given column has the given value. Example:</p>
|
||
<!-- START CODE "c5088" -->
|
||
<a id="c5088"></a><blockquote class="code"><p class="quoted">
|
||
choose row with a name of "Victoria" in the Table of Recent Monarchs;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>A run-time problem message is produced if the value isn't found anywhere in that column.</p>
|
||
|
||
*=ph_chooserandomrow=*
|
||
|
||
<p>This phrase makes a uniformly random choice of non-blank rows in the given table. Note that although a table always has at least one row, it can't be guaranteed that it always has a non-blank row, so it's possible for this to fail: if it does, a real-time problem message is thrown.</p>
|
||
|
||
*=ph_next=*
|
||
|
||
<p>This phrase can only be used inside a "repeat" or "while" block, and causes the current repetition of the block to finish immediately. That either means the next repetition begins, or (if we are already at the last one) the loop ends too. Example:</p>
|
||
<!-- START CODE "c2979" -->
|
||
<a id="c2979"></a><blockquote class="code"><p class="quoted">
|
||
repeat with X running from 1 to 10:
|
||
<br />    if X is 4, next;
|
||
<br />    say "[X] ".
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces the text "1 2 3 5 6 7 8 9 10 ", with no "4" because the "say" phrase was never reached on the fourth repetition.</p>
|
||
|
||
*=ph_break=*
|
||
|
||
<p>This phrase can only be used inside "repeat", "while" block, and causes both the current repetition and the entire loop to finish immediately. Example:</p>
|
||
<!-- START CODE "c2980" -->
|
||
<a id="c2980"></a><blockquote class="code"><p class="quoted">
|
||
repeat with X running from 1 to 10:
|
||
<br />    if X is 7, break;
|
||
<br />    say "[X] ".
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces the text "1 2 3 4 5 6 ", with nothing after "6" because the loop was broken at that point. The "say" wasn't reached on the 7th repetition, and the 8th, 9th and 10th never happened.</p>
|
||
|
||
*=phs_response=*
|
||
|
||
<p>This text substitution writes out the current text of the given response.</p>
|
||
|
||
*=phs_bracket=*
|
||
|
||
<p>This text substitution expands to a single open square bracket, avoiding the problem that a literal [ in text would look to Inform like the opening of a substitution. Example:</p>
|
||
<!-- START CODE "c841" -->
|
||
<a id="c841"></a><blockquote class="code"><p class="quoted">
|
||
"He [bracket]Lord Astor[close bracket] would, wouldn't he?"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>prints as "He [Lord Astor] would, wouldn't he?".</p>
|
||
|
||
*=phs_closebracket=*
|
||
|
||
<p>This text substitution expands to a single close square bracket, avoiding the problem that a literal ] in text would look to Inform like the closing of a substitution. Example:</p>
|
||
<!-- START CODE "c842" -->
|
||
<a id="c842"></a><blockquote class="code"><p class="quoted">
|
||
"He [bracket]Lord Astor[close bracket] would, wouldn't he?"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>prints as "He [Lord Astor] would, wouldn't he?".</p>
|
||
|
||
*=phs_apostrophe=*
|
||
|
||
<p>This text substitution expands to a single quotation mark, avoiding Inform's ordinary rule of converting literal single quotation marks to double at the edges of words. Example:</p>
|
||
<!-- START CODE "c845" -->
|
||
<a id="c845"></a><blockquote class="code"><p class="quoted">
|
||
Instead of going outside, say "Lucy snaps, 'What's the matter? You don't trust my cookin[apostrophe] mister?'"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces:</p>
|
||
<!-- START CODE "c846" -->
|
||
<a id="c846"></a><blockquote class="code"><p class="quoted">
|
||
Lucy snaps, "What's the matter? You don't trust my cookin' mister?"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>A more abbreviated form would be:</p>
|
||
<!-- START CODE "c847" -->
|
||
<a id="c847"></a><blockquote class="code"><p class="quoted">
|
||
Instead of going outside, say "Lucy snaps, 'What's the matter? You don't trust my cookin['] mister?'"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which has exactly the same meaning.</p>
|
||
|
||
*=phs_quotemark=*
|
||
|
||
<p>This text substitution expands to a double quotation mark. Most of the time this is unnecessary because of Inform's rule of converting literal single quotation marks to double at the edges of words, so it's needed only if we want a double-quote in the middle of a word for some reason. Example:</p>
|
||
<!-- START CODE "c848" -->
|
||
<a id="c848"></a><blockquote class="code"><p class="quoted">
|
||
"The compass reads 41o21'23[quotation mark]E."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>which produces: The compass reads 41o21'23"E. (Note that ["] is not allowed; a double-quotation mark is never allowed inside double-quoted text, not even in a text substitution.)</p>
|
||
|
||
*=ph_enumfirst=*
|
||
|
||
<p>This phrase produces the first-created value of the given kind, which should be an enumeration. Example: if we have</p>
|
||
<!-- START CODE "c3071" -->
|
||
<a id="c3071"></a><blockquote class="code"><p class="quoted">
|
||
Colour is a kind of value. The colours are red, orange, yellow, green, blue, indigo and violet.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then "first value of colour" is red.</p>
|
||
|
||
*=ph_enumlast=*
|
||
|
||
<p>This phrase produces the last-created value of the given kind, which should be an enumeration. Example: if we have</p>
|
||
<!-- START CODE "c3072" -->
|
||
<a id="c3072"></a><blockquote class="code"><p class="quoted">
|
||
Colour is a kind of value. The colours are red, orange, yellow, green, blue, indigo and violet.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then "last value of colour" is violet.</p>
|
||
|
||
*=ph_enumafter=*
|
||
|
||
<p>This phrase produces the next-created value of the given kind, which should be an enumeration. Example: if we have</p>
|
||
<!-- START CODE "c3073" -->
|
||
<a id="c3073"></a><blockquote class="code"><p class="quoted">
|
||
Colour is a kind of value. The colours are red, orange, yellow, green, blue, indigo and violet.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then "colour after orange" is yellow.</p>
|
||
|
||
*=ph_enumbefore=*
|
||
|
||
<p>This phrase produces the previous-created value of the given kind, which should be an enumeration. Example: if we have</p>
|
||
<!-- START CODE "c3074" -->
|
||
<a id="c3074"></a><blockquote class="code"><p class="quoted">
|
||
Colour is a kind of value. The colours are red, orange, yellow, green, blue, indigo and violet.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then "colour before blue" is green.</p>
|
||
|
||
*=ph_letequation=*
|
||
|
||
<p>This phrase creates a new temporary variable, starting it with the value found by solving the given equation. The variable lasts only for the present block of phrases, which certainly means that it lasts only for the current rule. Example:</p>
|
||
<!-- START CODE "c4834" -->
|
||
<a id="c4834"></a><blockquote class="code"><p class="quoted">
|
||
let F be given by Newton's Second Law where a is the acceleration due to gravity;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>There is also a more compact syntax, giving the equation explicitly:</p>
|
||
<!-- START CODE "c4835" -->
|
||
<a id="c4835"></a><blockquote class="code"><p class="quoted">
|
||
let KE be given by KE = mv^2/2 where KE is an energy;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_if=*
|
||
|
||
<p>This text substitution produces no text. It's used only for a side-effect: it says that the text following should be said only if the condition is true. That continues until the end of the text, or until an "[end if]" substitution, whichever comes first. If the "[otherwise]" and "[otherwise if]" substitutions are also present, they allow alternatives to be added in case the condition is false. Example:</p>
|
||
<!-- START CODE "c899" -->
|
||
<a id="c899"></a><blockquote class="code"><p class="quoted">
|
||
The wine cask is a container. The printed name of the cask is "[if open]broached, empty cask[otherwise]sealed wine cask".
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>we find that the cask is described as "a broached, empty cask" when open, and "a sealed wine cask" when closed. A longer example which begins and ends with fixed text, but has two alternatives in the middle:</p>
|
||
<!-- START CODE "c900" -->
|
||
<a id="c900"></a><blockquote class="code"><p class="quoted">
|
||
The Customs Wharf is a room. "Amid the bustle of the quayside, [if the cask is open]many eyes stray to your broached cask. [otherwise]nobody takes much notice of a man heaving a cask about. [end if]Sleek gondolas jostle at the plank pier."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_unless=*
|
||
|
||
<p>This text substitution produces no text. It's used only for a side-effect: it says that the text following should be said only if the condition is false. That continues until the end of the text, or until an "[end if]" substitution, whichever comes first. If the "[otherwise]" and "[otherwise if]" substitutions are also present, they allow alternatives to be added in case the condition is true. Example:</p>
|
||
<!-- START CODE "c901" -->
|
||
<a id="c901"></a><blockquote class="code"><p class="quoted">
|
||
The Customs Hall is a room. "With infinite slowness, with ledgers and quill pens, the clerks ruin their eyesight.[unless the player is a woman] They barely even glance in your direction."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_otherwise=*
|
||
|
||
<p>This text substitution produces no text, and can be used only following an "[if ...]" or "[unless ...]" text substitution. It switches from text which appears if the condition is true, to text which appears if it is false. Example:</p>
|
||
<!-- START CODE "c902" -->
|
||
<a id="c902"></a><blockquote class="code"><p class="quoted">
|
||
The wine cask is a container. The printed name of the cask is "[if open]broached, empty cask[otherwise]sealed wine cask".
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_endif=*
|
||
|
||
<p>This text substitution produces no text, and can be used only to close off a stretch of varying text which begins with "[if ...]".</p>
|
||
|
||
*=phs_endunless=*
|
||
|
||
<p>This text substitution produces no text, and can be used only to close off a stretch of varying text which begins with "[unless ...]".</p>
|
||
|
||
*=phs_elseif=*
|
||
|
||
<p>This text substitution produces no text, and can be used only following an "[if ...]" or "[unless ...]" text substitution. It gives an alternative text to use if the first condition didn't apply, but this one does. Example:</p>
|
||
<!-- START CODE "c903" -->
|
||
<a id="c903"></a><blockquote class="code"><p class="quoted">
|
||
The wine cask is a container. The printed name of the cask is "[if open]broached, empty cask[otherwise if transparent]sealed cask half-full of sloshing wine[otherwise]sealed wine cask".
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_elseunless=*
|
||
|
||
<p>This text substitution produces no text, and can be used only following an "[if ...]" or "[unless ...]" text substitution. It gives an alternative text to use if the first condition didn't apply, and this one is false too.</p>
|
||
|
||
*=ph_applied0=*
|
||
|
||
<p>This phrase produces the result of applying the given phrase, which must be one which takes no values itself.</p>
|
||
|
||
*=ph_applied1=*
|
||
|
||
<p>This phrase produces the result of applying the given phrase, which must be one which takes one value itself.</p>
|
||
|
||
*=ph_applied2=*
|
||
|
||
<p>This phrase produces the result of applying the given phrase, which must be one which takes two values itself.</p>
|
||
|
||
*=ph_applied3=*
|
||
|
||
<p>This phrase produces the result of applying the given phrase, which must be one which takes three values itself.</p>
|
||
|
||
*=ph_apply0=*
|
||
|
||
<p>This phrase causes the given phrase to be applied. It must be one which takes no values itself.</p>
|
||
|
||
*=ph_apply1=*
|
||
|
||
<p>This phrase causes the given phrase to be applied. It must be one which takes one value itself.</p>
|
||
|
||
*=ph_apply2=*
|
||
|
||
<p>This phrase causes the given phrase to be applied. It must be one which takes two values itself.</p>
|
||
|
||
*=ph_apply3=*
|
||
|
||
<p>This phrase causes the given phrase to be applied. It must be one which takes three values itself.</p>
|
||
|
||
*=ph_omit=*
|
||
|
||
<p>This phrase changes the form of an inventory listing, room description, etc., so that it will simply list "a bottle of sand" or "an empty bottle", rather than "a bottle (in which is sand)" or "a bottle (which is empty)". It should be used only when the listing is imminent, and does not have permanent effect.</p>
|
||
|
||
*=ph_listcontents=*
|
||
|
||
<p>This phrase produces a list of all things whose holder is the given object, according to Inform's traditional conventions for room descriptions and inventory listings. Example:</p>
|
||
<!-- START CODE "c2986" -->
|
||
<a id="c2986"></a><blockquote class="code"><p class="quoted">
|
||
list the contents of Marley Wood, as a sentence, with newlines
|
||
<br />and including all contents;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Where this is possible, it's generally better to use "[list of things in ...]" instead, which produces the same result in an acceptable way for the middle of a sentence.</p>
|
||
|
||
*=ph_addtolist=*
|
||
|
||
<p>This phrase adds the given value to the end of the list. Example:</p>
|
||
<!-- START CODE "c8344" -->
|
||
<a id="c8344"></a><blockquote class="code"><p class="quoted">
|
||
let L be {60, 168};
|
||
<br />add 360 to L;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>results in L being {60, 168, 360}. Note that the value is added even if it already occurs somewhere in L; this can be avoided with "if absent". So:</p>
|
||
<!-- START CODE "c8345" -->
|
||
<a id="c8345"></a><blockquote class="code"><p class="quoted">
|
||
add 168 to L, if absent;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>would do nothing - it is already there.</p>
|
||
|
||
*=ph_addlisttolist=*
|
||
|
||
<p>This phrase adds the first list to the end of the second. Example:</p>
|
||
<!-- START CODE "c8346" -->
|
||
<a id="c8346"></a><blockquote class="code"><p class="quoted">
|
||
let L be {2, 3, 5, 7};
|
||
<br />add {11, 13, 17, 19} to L;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>results in L being {2, 3, 5, 7, 11, 13, 17, 19}.</p>
|
||
|
||
*=ph_addatentry=*
|
||
|
||
<p>This phrase adds the given value so that it becomes the entry with that index number in the list. Example:</p>
|
||
<!-- START CODE "c8347" -->
|
||
<a id="c8347"></a><blockquote class="code"><p class="quoted">
|
||
let L be {1, 2, 3, 4, 8, 24};
|
||
<br />add 12 at entry 6 in L;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>sets L to {1, 2, 3, 4, 8, 12, 24}. If there are N entries in L, then we can add at any of entries 1 up to N+1: adding at entry N+1 means adding at the end. The phrase option "if absent" makes the phrase do nothing if the value already exists anywhere in L.</p>
|
||
|
||
*=ph_addlistatentry=*
|
||
|
||
<p>This phrase adds the first list to the second so that it begins at the given position. Example:</p>
|
||
<!-- START CODE "c8348" -->
|
||
<a id="c8348"></a><blockquote class="code"><p class="quoted">
|
||
let L be {1, 2, 3, 4};
|
||
<br />add {4, 8, 12} at entry 3 in L;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>results in L being {1, 2, 4, 8, 12, 3, 4}.</p>
|
||
|
||
*=ph_remfromlist=*
|
||
|
||
<p>This phrase removes every instance of the given value from the list. Example:</p>
|
||
<!-- START CODE "c8351" -->
|
||
<a id="c8351"></a><blockquote class="code"><p class="quoted">
|
||
let L be {3, 1, 4, 1, 5, 9, 2, 6, 5, 3};
|
||
<br />remove 1 from L;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>results in L being {3, 4, 5, 9, 2, 6, 5, 3}. Ordinarily "remove 7 from L" would produce a run-time problem, since L does not contain the value 7, but using the "if present" option lets us off this: the phrase then does nothing if L does not contain the value to be removed.</p>
|
||
|
||
*=ph_remlistfromlist=*
|
||
|
||
<p>This phrase removes every instance of any value in the first list from the second. Example:</p>
|
||
<!-- START CODE "c8352" -->
|
||
<a id="c8352"></a><blockquote class="code"><p class="quoted">
|
||
let L be {3, 1, 4, 1, 5, 9, 2, 6, 5, 3};
|
||
<br />remove {0, 2, 4, 6, 8} from L;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>results in L being {3, 1, 5, 9, 5, 3}. If both lists are large, this can be a slow process, and we might do better by sorting them and trying a more sophisticated method. But this is convenient for anything reasonable-sized.</p>
|
||
|
||
*=ph_rementry=*
|
||
|
||
<p>This phrase removes the entry at the given position, counting from 1 as the first entry. (Once it is removed, the other entries shuffle down.) Example:</p>
|
||
<!-- START CODE "c8353" -->
|
||
<a id="c8353"></a><blockquote class="code"><p class="quoted">
|
||
let L be {3, 1, 4, 1, 5, 9, 2, 6, 5, 3};
|
||
<br />remove entry 3 from L;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>results in L being {3, 1, 1, 5, 9, 2, 6, 5, 3}.</p>
|
||
|
||
*=ph_rementries=*
|
||
|
||
<p>This phrase removes the entries at the given range of positions, counting from 1 as the first entry. (Once they are removed, the other entries shuffle down.) Example:</p>
|
||
<!-- START CODE "c8354" -->
|
||
<a id="c8354"></a><blockquote class="code"><p class="quoted">
|
||
let L be {3, 1, 4, 1, 5, 9, 2, 6, 5, 3};
|
||
<br />remove entries 3 to 6 from L;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>results in L being {3, 1, 2, 6, 5, 3}.</p>
|
||
|
||
*=ph_figureid=*
|
||
|
||
<p>This phrase produces the ID number used in the eventual Glulx file for the given figure.</p>
|
||
|
||
*=ph_soundid=*
|
||
|
||
<p>This phrase produces the ID number used in the eventual Glulx file for the given sound effect.</p>
|
||
|
||
*=ph_letrelation=*
|
||
|
||
<p>This phrase creates a new temporary variable, and sets its value to the identity of a newly created and equally temporary relation. These last only for the present block of phrases, which certainly means that they exist only in the current rule. Example:</p>
|
||
<!-- START CODE "c4252" -->
|
||
<a id="c4252"></a><blockquote class="code"><p class="quoted">
|
||
let the password dictionary be a relation of texts;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This makes a purely temporary various-to-various relation between texts, which lasts as long as the temporary value "password dictionary" lasts. By default, relations are various-to-various, but we could instead write, say:</p>
|
||
<!-- START CODE "c4253" -->
|
||
<a id="c4253"></a><blockquote class="code"><p class="quoted">
|
||
let the nicknames catalogue be a various-to-one relation of texts;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_placeinscope=*
|
||
|
||
<p>This phrase should only be used in rules for the "deciding the scope of..." activity. It places the given object in scope, making it accessible to the player's commands, regardless of where it is in the model world. Examples:</p>
|
||
<!-- START CODE "c6900" -->
|
||
<a id="c6900"></a><blockquote class="code"><p class="quoted">
|
||
place the distant volcano in scope;
|
||
<br />place the lacquered box in scope, but not its contents;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Ordinarily if something is placed in scope, then so are its parts and (in the case of a supporter or a transparent or open container) its contents; using the "but not its contents" option we can place just the box itself in scope.</p>
|
||
|
||
*=ph_placecontentsinscope=*
|
||
|
||
<p>This phrase should only be used in rules for the "deciding the scope of..." activity. It places the things inside or on top of the given object in scope, making them accessible to the player's commands, but it does nothing to place the object itself in scope. (It might of course be in scope anyway, and if it is then this phrase won't remove it.) Example:</p>
|
||
<!-- START CODE "c6901" -->
|
||
<a id="c6901"></a><blockquote class="code"><p class="quoted">
|
||
place the contents of the lacquered box in scope;
|
||
<br />place the contents of the Marbled Steps in scope;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Note that the object in question can be a room, as in this second example.</p>
|
||
|
||
*=ph_stopaction=*
|
||
|
||
<p>This phrase stops the current rule, stops the rulebook being worked through, and finally stops the action being processed. Example:</p>
|
||
<!-- START CODE "c1312" -->
|
||
<a id="c1312"></a><blockquote class="code"><p class="quoted">
|
||
Before taking the key:
|
||
<br />    say "It seems to be soldered to the keyhole.";
|
||
<br />    stop the action.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_continueaction=*
|
||
|
||
<p>This phrase ends the current rule, but in a way which keeps its rulebook going, so that the action being processed will carry on rather than being stopped. Example:</p>
|
||
<!-- START CODE "c1313" -->
|
||
<a id="c1313"></a><blockquote class="code"><p class="quoted">
|
||
Instead of taking the napkin:
|
||
<br />    say "(first unfolding its delicate origami swan)[command clarification break]";
|
||
<br />    continue the action.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>An "instead" rule ordinarily stops the action when it finishes, so the "continue the action" is needed to make things carry on. (This rule would have been better written as a "before" rule, in fact, but it shows the idea.)</p>
|
||
|
||
*=ph_scenetimesincebegan=*
|
||
|
||
<p>This phrase produces the time since the named scene began, which only makes sense, of course, if it has indeed begun. Example:</p>
|
||
<!-- START CODE "c2408" -->
|
||
<a id="c2408"></a><blockquote class="code"><p class="quoted">
|
||
time since Entire Game began
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_scenetimesinceended=*
|
||
|
||
<p>This phrase produces the time since the named scene ended, which only makes sense, of course, if it has indeed ended. Example:</p>
|
||
<!-- START CODE "c2409" -->
|
||
<a id="c2409"></a><blockquote class="code"><p class="quoted">
|
||
time since Formal Dinner ended
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_scenetimewhenbegan=*
|
||
|
||
<p>This phrase produces the time (i.e., the value of the "time of day" variable) at the moment when the given scene began.</p>
|
||
|
||
*=ph_scenetimewhenended=*
|
||
|
||
<p>This phrase produces the time (i.e., the value of the "time of day" variable) at the moment when the given scene ended.</p>
|
||
|
||
*=ph_stop=*
|
||
|
||
<p>This phrase causes the current rule to end immediately. It is most often used in the definition of other phrases:</p>
|
||
<!-- START CODE "c2981" -->
|
||
<a id="c2981"></a><blockquote class="code"><p class="quoted">
|
||
To judge the score:
|
||
<br />    if the score is 0, stop;
|
||
<br />    say "The score is [score in words] more than it was a half-hour ago."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>In the case when the score is 0, the "stop" ends the phrase immediately, so that the subsequent text is printed only if the score is not 0.</p>
|
||
<p>"Stop" can also be used in action rules, though this is not very good style - it's clearer to use "stop the action", which is exactly equivalent.</p>
|
||
|
||
*=ph_total=*
|
||
|
||
<p>This phrase produces the total of some property held by all of the values matching the description. A problem message is produced if the values in question can't have that property ("the total carrying capacity of scenes"), or if it holds a kind of value which can't meaningfully be added up ("the total description of open doors"). Example:</p>
|
||
<!-- START CODE "c4758" -->
|
||
<a id="c4758"></a><blockquote class="code"><p class="quoted">
|
||
total carrying capacity of people in the Deep Pool
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_succeeds=*
|
||
|
||
<p>This causes the current rule to end immediately, with its outcome considered to be a success. That means the rulebook being worked through will also end, and also be a success.</p>
|
||
|
||
*=ph_fails=*
|
||
|
||
<p>This causes the current rule to end immediately, with its outcome considered to be a failure. That means the rulebook being worked through will also end, and also be a failure.</p>
|
||
|
||
*=ph_nodecision=*
|
||
|
||
<p>This causes the current rule to end immediately, but with no outcome. That means the rulebook being worked through will continue to run on, beginning with the next rule.</p>
|
||
|
||
*=ph_succeeded=*
|
||
|
||
<p>This condition is true if the most recently followed rule ended in success. Example:</p>
|
||
<!-- START CODE "c7851" -->
|
||
<a id="c7851"></a><blockquote class="code"><p class="quoted">
|
||
follow the hypothetical clever rule;
|
||
<br />if rule succeeded:
|
||
<br />    ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_failed=*
|
||
|
||
<p>This condition is true if the most recently followed rule ended in failure. Example:</p>
|
||
<!-- START CODE "c7852" -->
|
||
<a id="c7852"></a><blockquote class="code"><p class="quoted">
|
||
follow the hypothetical clever rule;
|
||
<br />if rule failed:
|
||
<br />    ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Note that this is not the opposite of "rule succeeded", because there's a third possibility: that it ended with no outcome.</p>
|
||
|
||
*=phs_oneof=*
|
||
|
||
<p>This text substitution produces no text. It's used only for a side-effect: it switches between a number of alternative texts, which follow it and are divided by "[or]" substitutions, according to a strategy given in a closing substitution. Example:</p>
|
||
<!-- START CODE "c916" -->
|
||
<a id="c916"></a><blockquote class="code"><p class="quoted">
|
||
"You flip the coin. [one of]Heads[or]Tails[purely at random]!"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Here there are just two alternatives, and the strategy is "purely at random". Exactly half of the time the text will be printed as "You flip the coin. Heads!"; and the other half, "You flip the coin. Tails!".</p>
|
||
|
||
*=phs_or=*
|
||
|
||
<p>This text substitution produces no text, and can be used only in a "[one of]..." construction. It divides alternative wordings. Example:</p>
|
||
<!-- START CODE "c917" -->
|
||
<a id="c917"></a><blockquote class="code"><p class="quoted">
|
||
"You flip the coin. [one of]Heads[or]Tails[purely at random]!"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_purelyrandom=*
|
||
|
||
<p>This text substitution produces no text, and can be used only to end a "[one of]..." construction. It indicates that the alternatives are chosen uniformly randomly.</p>
|
||
|
||
*=phs_thenpurelyrandom=*
|
||
|
||
<p>This text substitution produces no text, and can be used only to end a "[one of]..." construction. It indicates that the alternatives are chosen in sequence until all have been seen, but that after that they are chosen uniformly randomly.</p>
|
||
|
||
*=phs_random=*
|
||
|
||
<p>This text substitution produces no text, and can be used only to end a "[one of]..." construction. It indicates that the alternatives are chosen at random except that the same choice cannot come up twice running. This is useful to avoid the deadening effect of repeating the exact same message. Example:</p>
|
||
<!-- START CODE "c918" -->
|
||
<a id="c918"></a><blockquote class="code"><p class="quoted">
|
||
"The light changes randomly again; now it's [one of]green[or]amber[or]red[at random]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Here we can safely say the light "changes", because the new colour cannot be the same as the one printed the last time.</p>
|
||
|
||
*=phs_thenrandom=*
|
||
|
||
<p>This text substitution produces no text, and can be used only to end a "[one of]..." construction. It indicates that the alternatives are chosen in sequence until all have been seen, and then after that, at random except that the same choice cannot come up twice running. Example:</p>
|
||
<!-- START CODE "c919" -->
|
||
<a id="c919"></a><blockquote class="code"><p class="quoted">
|
||
"Maybe the murderer is [one of]Colonel Mustard[or]Professor Plum[or]Cardinal Cerise[then at random]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_sticky=*
|
||
|
||
<p>This text substitution produces no text, and can be used only to end a "[one of]..." construction. It indicates that a random choice is made the first time the text is printed, but that it sticks from there on. Example:</p>
|
||
<!-- START CODE "c920" -->
|
||
<a id="c920"></a><blockquote class="code"><p class="quoted">
|
||
"The newspaper headline is: [one of]War Casualties[or]Terrorists[or]Banks[sticky random] [one of]Continue To Expand[or]Lose Out[sticky random]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Although the newspaper headline will change with each playing, it will not alter during play.</p>
|
||
|
||
*=phs_decreasing=*
|
||
|
||
<p>This text substitution produces no text, and can be used only to end a "[one of]..." construction. It indicates that the alternatives are chosen at random, except that the first is most likely to be chosen, the second is next most likely, and so on down to the rarest at the end. Example:</p>
|
||
<!-- START CODE "c921" -->
|
||
<a id="c921"></a><blockquote class="code"><p class="quoted">
|
||
"Zorro strides by, [one of]looking purposeful[or]grim-faced[or]deep in thought[or]suppressing a yawn[or]scratching his ribs[or]trying to conceal that he has cut himself shaving[as decreasingly likely outcomes]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>There are six outcomes here: the first is six times as likely as the last, and those in between are similarly scaled, so Zorro cuts himself shaving only once in 21 tries, while he looks purposeful almost a third of the time.</p>
|
||
|
||
*=phs_order=*
|
||
|
||
<p>This text substitution produces no text, and can be used only to end a "[one of]..." construction. A random order is chosen for the alternative passages of text, and they are used in that order as the text is printed again and again. When one random cycle finishes, a new one begins. The effect is somewhat like the "shuffle album" feature on an iPod. Example:</p>
|
||
<!-- START CODE "c922" -->
|
||
<a id="c922"></a><blockquote class="code"><p class="quoted">
|
||
"You dip into the chapter on [one of]freshwater fish[or]hairless mammals[or]extinct birds[or]amphibians such as the black salamander[in random order]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>One small restriction: if there are more than 32 variations, purely random choices will be printed, and there will be no guarantee that repeats are prevented.</p>
|
||
|
||
*=phs_cycling=*
|
||
|
||
<p>This text substitution produces no text, and can be used only to end a "[one of]..." construction. It indicates that the alternatives are used one at a time, in turn: after the last one is reached, we start again from the first. Example:</p>
|
||
<!-- START CODE "c923" -->
|
||
<a id="c923"></a><blockquote class="code"><p class="quoted">
|
||
"The pundits discuss [one of]the weather[or]world events[or]celebrity gossip[cycling]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_stopping=*
|
||
|
||
<p>This text substitution produces no text, and can be used only to end a "[one of]..." construction. It indicates that the alternatives are used one at a time, in turn: once the last one is reached, it's used forever after. Example:</p>
|
||
<!-- START CODE "c924" -->
|
||
<a id="c924"></a><blockquote class="code"><p class="quoted">
|
||
"[one of]The phone rings[or]The phone rings a second time[or]The phone rings again[stopping]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_firsttime=*
|
||
|
||
<p>This pair of text substitutions causes whatever is between them to be printed only the first time the text is printed. Example:</p>
|
||
<!-- START CODE "c925" -->
|
||
<a id="c925"></a><blockquote class="code"><p class="quoted">
|
||
"The screen door squeaks loudly as when you open it. [first time]Well, you'll get used to it eventually. [only]"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This is exactly equivalent to</p>
|
||
<!-- START CODE "c926" -->
|
||
<a id="c926"></a><blockquote class="code"><p class="quoted">
|
||
"The screen door squeaks loudly as when you open it. [one of]Well, you'll get used to it eventually. [or][stopping]";
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>but easier to read.</p>
|
||
|
||
*=ph_now=*
|
||
|
||
<p>This phrase makes the condition become true. Examples:</p>
|
||
<!-- START CODE "c1915" -->
|
||
<a id="c1915"></a><blockquote class="code"><p class="quoted">
|
||
now the score is 100;
|
||
<br />now the player is Kevin;
|
||
<br />now the front door is open;
|
||
<br />now Mr Darcy is wearing the top hat;
|
||
<br />now all the doors are open;
|
||
<br />now all of the things in the sack are in the box;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Inform issues a problem message if the condition asks to do the impossible ("now 3 is an even number") or is vague ("now the duck is not in the Lily Pond") or not in the present tense ("now the front door had been open").</p>
|
||
|
||
*=phs_timewords=*
|
||
|
||
<p>This text substitution produces the given time written out in English sentence form. For example:</p>
|
||
<!-- START CODE "c2196" -->
|
||
<a id="c2196"></a><blockquote class="code"><p class="quoted">
|
||
"Through the glass you can see the reversed hands reading [the time of day in words]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>might produce</p>
|
||
<!-- START CODE "c2197" -->
|
||
<a id="c2197"></a><blockquote class="code"><p class="quoted">
|
||
Through the glass you can see the reversed hands reading twenty to nine.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_changelength=*
|
||
|
||
<p>This phrase alters the given list so that it now has exactly the number of entries given. Example:</p>
|
||
<!-- START CODE "c8476" -->
|
||
<a id="c8476"></a><blockquote class="code"><p class="quoted">
|
||
change L to have 21 entries;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>If L previously had more than 21 entries, they are thrown away (and lost forever); if L previously had fewer, then new entries are created, using the default value for whatever kind of value L holds. So extending a list of numbers will pad it out with 0s, but extending a list of texts will pad it out with the empty text "", and so on.</p>
|
||
|
||
*=ph_truncate=*
|
||
|
||
<p>This phrase alters the given list so that it now has no more than the number of entries given. Example:</p>
|
||
<!-- START CODE "c8477" -->
|
||
<a id="c8477"></a><blockquote class="code"><p class="quoted">
|
||
truncate L to 8 entries;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>shortens L to length 8 if it is currently longer than that, trimming entries from the end, but would (for instance) leave a list of length 3 unchanged. Note that</p>
|
||
<!-- START CODE "c8478" -->
|
||
<a id="c8478"></a><blockquote class="code"><p class="quoted">
|
||
truncate L to 0 entries;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>empties it to { }, the list with nothing in.</p>
|
||
|
||
*=ph_truncatefirst=*
|
||
|
||
<p>This phrase alters the given list so that it now consists only of the initial part of the list with the given length. Example:</p>
|
||
<!-- START CODE "c8479" -->
|
||
<a id="c8479"></a><blockquote class="code"><p class="quoted">
|
||
truncate L to the first 4 entries;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>turns {1, 3, 5, 7, 9, 11} to {1, 3, 5, 7}.</p>
|
||
|
||
*=ph_truncatelast=*
|
||
|
||
<p>This phrase alters the given list so that it now consists only of the final part of the list with the given length. Example:</p>
|
||
<!-- START CODE "c8480" -->
|
||
<a id="c8480"></a><blockquote class="code"><p class="quoted">
|
||
truncate L to the last 4 entries;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>turns {1, 3, 5, 7, 9, 11} to {5, 7, 9, 11}.</p>
|
||
|
||
*=ph_extend=*
|
||
|
||
<p>This phrase pads out the list with default values as needed so that it now has at least the given length. (If the list is already at least that length, nothing is done.) Example:</p>
|
||
<!-- START CODE "c8481" -->
|
||
<a id="c8481"></a><blockquote class="code"><p class="quoted">
|
||
extend L to 80 entries;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>lengthens L to length 80 if it is currently shorter than that.</p>
|
||
|
||
*=phs_numwords=*
|
||
|
||
<p>This text substitution writes out the number in English text. Example:</p>
|
||
<!-- START CODE "c858" -->
|
||
<a id="c858"></a><blockquote class="code"><p class="quoted">
|
||
"You've been wandering around for [turn count in words] turns now."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>might produce "You've been wandering around for two hundred and thirteen turns now." The "and" here is natural on one side of the Atlantic but not the other - so with the "Use American dialect." option in place, it disappears.</p>
|
||
|
||
*=phs_s=*
|
||
|
||
<p>This text substitution prints a letter "s" unless the last number printed was 1. Example:</p>
|
||
<!-- START CODE "c860" -->
|
||
<a id="c860"></a><blockquote class="code"><p class="quoted">
|
||
"You've been wandering around for [turn count in words] turn[s] now."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces "... for one turn now." or "... for two turns now." as appropriate. Note that it reacts only to numbers, not to other arithmetic values like times (or, for instance, weights from the "Metric Units" extension).</p>
|
||
|
||
*=ph_randomdesc=*
|
||
|
||
<p>This phrase makes a uniformly random choice from values satisfying the description given. Example:</p>
|
||
<!-- START CODE "c2033" -->
|
||
<a id="c2033"></a><blockquote class="code"><p class="quoted">
|
||
a random visited room
|
||
<br />a random scene
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>A problem message is issued if the range is too large (for instance, "a random text"). Unexpected results may follow if no value fits the description, unless we are describing objects, in which case the result is the special value "nothing".</p>
|
||
|
||
*=ph_follow=*
|
||
|
||
<p>This phrase causes the rule to be obeyed immediately (rather than simply at predetermined times such as when a particular action is being tried, or at the end of every turn, and such). Example:</p>
|
||
<!-- START CODE "c7541" -->
|
||
<a id="c7541"></a><blockquote class="code"><p class="quoted">
|
||
follow the advance time rule;
|
||
<br />follow the appraisal rulebook;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_try=*
|
||
|
||
<p>This phrase makes the action, which has to be named literally, take effect now. Example:</p>
|
||
<!-- START CODE "c1329" -->
|
||
<a id="c1329"></a><blockquote class="code"><p class="quoted">
|
||
Instead of entering the trapdoor, try going up.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>It's as if the player had typed GO UP as a command. Note that the action has to be specific:</p>
|
||
<!-- START CODE "c1330" -->
|
||
<a id="c1330"></a><blockquote class="code"><p class="quoted">
|
||
try eating something;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>is not allowed, since it doesn't say exactly what is to be eaten.</p>
|
||
|
||
*=ph_trysilently=*
|
||
|
||
<p>This phrase makes the action, which has to be named literally, take effect now, under the "silent" convention which means that routine messages aren't printed. Example:</p>
|
||
<!-- START CODE "c1333" -->
|
||
<a id="c1333"></a><blockquote class="code"><p class="quoted">
|
||
try silently taking the napkin;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Silence is maintained only if this new action, the taking of the napkin, is successful (so if the napkin is successfully taken, the text "Taken." will not appear): if the action should fail, a suitable objection will be voiced as usual.</p>
|
||
|
||
*=ph_end=*
|
||
|
||
<p>This phrase ends the story at the next opportunity (typically as soon as the current rule ends), with the closing message "The End." The end is not considered final.</p>
|
||
|
||
*=ph_endfinally=*
|
||
|
||
<p>This phrase ends the story at the next opportunity (typically as soon as the current rule ends), with the closing message "The End." The end is considered final, and any hidden menu options will be revealed.</p>
|
||
|
||
*=ph_endsaying=*
|
||
|
||
<p>This phrase ends the story at the next opportunity (typically as soon as the current rule ends), with the closing message given in the text. The end is not considered final. Example:</p>
|
||
<!-- START CODE "c2086" -->
|
||
<a id="c2086"></a><blockquote class="code"><p class="quoted">
|
||
end the story saying "You have been stymied"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_endfinallysaying=*
|
||
|
||
<p>This phrase ends the story at the next opportunity (typically as soon as the current rule ends), with the closing message given in the text. The end is considered final, and any hidden menu options will be revealed. Example:</p>
|
||
<!-- START CODE "c2087" -->
|
||
<a id="c2087"></a><blockquote class="code"><p class="quoted">
|
||
end the story finally saying "You have defeated Sauron"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_ended=*
|
||
|
||
<p>This condition is true if an end has been declared using one of the "end the story..." phrases.</p>
|
||
|
||
*=ph_notended=*
|
||
|
||
<p>This condition is true if no end has been declared using one of the "end the story..." phrases.</p>
|
||
|
||
*=ph_finallyended=*
|
||
|
||
<p>This condition is true if an end has been declared using one of the "end the story finally..." phrases, so that an ending has been reached which the author feels is a completion of the player's experience.</p>
|
||
|
||
*=ph_notfinallyended=*
|
||
|
||
<p>This condition is true if an end has been declared using one of the "end the story..." phrases, but not "finally", so the author feels that the player can get further experience by playing again and trying different approaches.</p>
|
||
|
||
*=ph_resume=*
|
||
|
||
<p>This phrase causes an ended story to resume exactly as if no "end the story..." phrase had been used. Example:</p>
|
||
<!-- START CODE "c2091" -->
|
||
<a id="c2091"></a><blockquote class="code"><p class="quoted">
|
||
When play ends:
|
||
<br />    if the story has not ended finally:
|
||
<br />        say "Oh dear. Still, here's another chance.";
|
||
<br />        resume the story.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>The phrase is likely to be sensible only as part of a "when play ends" rule. Other traditional uses include giving the player three lives, as in an old-school arcade machine.</p>
|
||
|
||
*=ph_timefromnow=*
|
||
|
||
<p>This phrase causes the given rule to be run at a given time offset from the current time of day. Example:</p>
|
||
<!-- START CODE "c2219" -->
|
||
<a id="c2219"></a><blockquote class="code"><p class="quoted">
|
||
the egg-timer clucks in 18 minutes from now;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_turnsfromnow=*
|
||
|
||
<p>This phrase causes the given rule to be run at a given number of turns after the current one. Example:</p>
|
||
<!-- START CODE "c2220" -->
|
||
<a id="c2220"></a><blockquote class="code"><p class="quoted">
|
||
the egg-timer clucks in four turns from now;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_attime=*
|
||
|
||
<p>This phrase causes the given rule to be run at a given time of day. Example:</p>
|
||
<!-- START CODE "c2221" -->
|
||
<a id="c2221"></a><blockquote class="code"><p class="quoted">
|
||
the egg-timer clucks at 11:35 AM;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_carryout=*
|
||
|
||
<p>This phrase carries out the given activity, which must be one not applying to any value. Example:</p>
|
||
<!-- START CODE "c6282" -->
|
||
<a id="c6282"></a><blockquote class="code"><p class="quoted">
|
||
carry out the assaying activity;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_carryoutwith=*
|
||
|
||
<p>This phrase carries out the given activity, which must apply to a kind of value matching the one supplied. Example:</p>
|
||
<!-- START CODE "c6283" -->
|
||
<a id="c6283"></a><blockquote class="code"><p class="quoted">
|
||
carry out the analysing activity with the pitchblende;
|
||
<br />carry out the announcing activity with the score;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_continueactivity=*
|
||
|
||
<p>This phrase should be used only in rules in activity rulebooks. It causes the current rule to end, but without result, so that the activity continues rather than stopping as a result of the rule. This is useful for rulebooks (like the "for" rulebook of an activity) where the default is that a rule does stop the activity.</p>
|
||
|
||
*=ph_showrelation=*
|
||
|
||
<p>This phrase is for testing purposes only. It shows the current state of the named relation, that is, it shows which values relate to which other ones, where it's possible to do this in any sensible way.</p>
|
||
|
||
*=ph_roomdirof=*
|
||
|
||
<p>This phrase produces the room which the given map direction leads to, or the special value "nothing" if it leads nowhere. If it leads to a door, the result is the room through that door. Examples:</p>
|
||
<!-- START CODE "c1149" -->
|
||
<a id="c1149"></a><blockquote class="code"><p class="quoted">
|
||
say "You look north into [the room north from the Garden]."
|
||
<br />if the room north from the Garden is nothing, say "The grass leads nowhere."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_doordirof=*
|
||
|
||
<p>This phrase produces the door which the given map direction leads to, or the special value "nothing" if it leads nowhere or to a room. Examples:</p>
|
||
<!-- START CODE "c1150" -->
|
||
<a id="c1150"></a><blockquote class="code"><p class="quoted">
|
||
let the barrier be the door north from the Garden;
|
||
<br />if the barrier is a door, say "Well, [the barrier] is in the way.";
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_roomordoor=*
|
||
|
||
<p>This phrase produces the object which the given map direction leads to, which will always be either a room, a door or the special value "nothing". The phrase is used mainly by the Standard Rules, for technical reasons, and usually it's better to use "room ... from ..." or "door ... from ..." instead.</p>
|
||
|
||
*=ph_bestroute=*
|
||
|
||
<p>This phrase produces a direction to take in order to get from A to B by the shortest number of movements between rooms, or produces "nothing" if there is no way through at all. Example:</p>
|
||
<!-- START CODE "c1151" -->
|
||
<a id="c1151"></a><blockquote class="code"><p class="quoted">
|
||
The description of the brass compass is "The dial points quiveringly to [best route from the location to the Lodestone Room]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Best routes are ordinarily forbidden to go through doors, but if the suffix "using doors" is added as an option then any open or openable and unlocked door may be used on the way; and if "using even locked doors" is given, then any door at all will do. Since magnetism is no respecter of property, that seems right here:</p>
|
||
<!-- START CODE "c1152" -->
|
||
<a id="c1152"></a><blockquote class="code"><p class="quoted">
|
||
The description of the brass compass is "The dial points quiveringly to [best route from the location to the Lodestone Room, using even locked doors]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_bestroutethrough=*
|
||
|
||
<p>This phrase produces a direction to take in order to get from A to B by the shortest number of movements between rooms which match the given description, or produces "nothing" if there is no way through at all. Example:</p>
|
||
<!-- START CODE "c1153" -->
|
||
<a id="c1153"></a><blockquote class="code"><p class="quoted">
|
||
best route from the Drawbridge to the Keep through visited rooms
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>The condition - in this case, that "visited rooms" must be used - also applies to both ends of the journey, so if either Drawbridge or Keep are unvisited then this is "nothing". (Similarly, saying something like "...through containers" would mean there is never a route.)</p>
|
||
|
||
*=ph_bestroutelength=*
|
||
|
||
<p>This phrase produces the number of map connections which must be followed in order to get from A to B by the shortest number of movements between rooms. If A and B are the same, the answer is 0; if there is no route at all, the answer is -1. Example:</p>
|
||
<!-- START CODE "c1154" -->
|
||
<a id="c1154"></a><blockquote class="code"><p class="quoted">
|
||
The description of the proximity gadget is "You are now [number of moves from the location to the Sundial] moves from the Sundial.";
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_bestroutethroughlength=*
|
||
|
||
<p>This phrase produces the number of map connections which must be followed in order to get from A to B by the shortest number of movements between rooms matching the given description. If A and B are the same, the answer is 0; if there is no route at all, or if either A or B fail to match the description themselves, the answer is -1.</p>
|
||
|
||
*=ph_requirestouch=*
|
||
|
||
<p>This condition is true if the action being processed is one whose (first) noun is an object which needs to be touchable by the actor. For example, it's true for "taking", but false for "examining".</p>
|
||
|
||
*=ph_requirestouch2=*
|
||
|
||
<p>This condition is true if the action being processed is one whose second noun is an object which needs to be touchable by the actor. For example, it's true for "putting the brick in the sack", but false for "throwing the brick at the window".</p>
|
||
|
||
*=ph_requirescarried=*
|
||
|
||
<p>This condition is true if the action being processed is one whose (first) noun is an object which needs to be carried by the actor. For example, it's true for "dropping", but false for "taking".</p>
|
||
|
||
*=ph_requirescarried2=*
|
||
|
||
<p>This condition is true if the action being processed is one whose second noun is an object which needs to be carried by the actor.</p>
|
||
|
||
*=ph_requireslight=*
|
||
|
||
<p>This condition is true if the action being processed is one which can only be performed if the actor has light to see by. For example, it's true for "examining", but false for "dropping".</p>
|
||
|
||
*=ph_while=*
|
||
|
||
<p>This phrase causes the block of phrases following it to be repeated over and over for as long the condition is true. If it isn't even true the first time, the block is skipped over and nothing happens. Example:</p>
|
||
<!-- START CODE "c2935" -->
|
||
<a id="c2935"></a><blockquote class="code"><p class="quoted">
|
||
while someone (called the victim) is in the Crypt:
|
||
<br />    say "A bolt of lightning strikes [the victim]!";
|
||
<br />    now the victim is in the Afterlife;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_changeexit=*
|
||
|
||
<p>This phrase alters the map so that the given map connection is made. Note that connections can be made to rooms, but not doors: the positions of doors are fixed. Example:</p>
|
||
<!-- START CODE "c1775" -->
|
||
<a id="c1775"></a><blockquote class="code"><p class="quoted">
|
||
change the east exit of the Closet to the Tsar's Imperial Dining Salon
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Since "nothing" is not a room, this doesn't allow us to change the exit to nothing, so there is a separate definition of:</p>
|
||
<!-- START CODE "c1776" -->
|
||
<a id="c1776"></a><blockquote class="code"><p class="quoted">
|
||
change the west exit of the Closet to nothing
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_changenoexit=*
|
||
|
||
<p>This phrase alters the map so that the given map connection is unmade. Example:</p>
|
||
<!-- START CODE "c1777" -->
|
||
<a id="c1777"></a><blockquote class="code"><p class="quoted">
|
||
change the west exit of the Closet to nowhere
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_defaultvalue=*
|
||
|
||
<p>Produces the default value of the kind named. Examples:</p>
|
||
<!-- START CODE "c707" -->
|
||
<a id="c707"></a><blockquote class="code"><p class="quoted">
|
||
The silver repeater is here. "You catch sight of a silver repeater watch, hands immobile at [default value of time]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces the output:</p>
|
||
<!-- START CODE "c708" -->
|
||
<a id="c708"></a><blockquote class="code"><p class="quoted">
|
||
You catch sight of a silver repeater watch, hands immobile at 9:00 am.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>because nine in the morning is the default time in Inform. If we have:</p>
|
||
<!-- START CODE "c709" -->
|
||
<a id="c709"></a><blockquote class="code"><p class="quoted">
|
||
Brightness is a kind of value. The brightnesses are guttering, weak, radiant and blazing.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then "default value of brightness" is guttering, the first brightness created. When it comes to kinds of object, we sometimes have to be a little careful. For example,</p>
|
||
<!-- START CODE "c710" -->
|
||
<a id="c710"></a><blockquote class="code"><p class="quoted">
|
||
default value of room
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>is always going to be fine (it's always the first room created in the source text). But</p>
|
||
<!-- START CODE "c711" -->
|
||
<a id="c711"></a><blockquote class="code"><p class="quoted">
|
||
default value of vehicle
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>would produce a Problem message if there were no vehicles in the world.</p>
|
||
|
||
*=ph_if=*
|
||
|
||
<p>This phrase causes the single phrase, or block of phrases, following it to be obeyed only if the condition is true. (If the condition must contain a comma for some reason, the block form should be used.) Example:</p>
|
||
<!-- START CODE "c2900" -->
|
||
<a id="c2900"></a><blockquote class="code"><p class="quoted">
|
||
if the red door is open, say "You could try going east?"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_unless=*
|
||
|
||
<p>This phrase causes the single phrase, or block of phrases, following it to be obeyed only if the condition is false. (If the condition must contain a comma for some reason, the block form should be used.) Example:</p>
|
||
<!-- START CODE "c2901" -->
|
||
<a id="c2901"></a><blockquote class="code"><p class="quoted">
|
||
unless the red door is closed, say "You could try going east?"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_frontside=*
|
||
|
||
<p>This phrase produces the first of the one or two rooms containing a door - first in the order given in the source text. Example: if</p>
|
||
<!-- START CODE "c272" -->
|
||
<a id="c272"></a><blockquote class="code"><p class="quoted">
|
||
The red rock stair is east of the Orchard and above the Undertomb.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then "front side of the red rock stair" produces the Orchard. For a one-sided door, this produces the only room containing the door.</p>
|
||
|
||
*=ph_backside=*
|
||
|
||
<p>This phrase produces the last of the one or two rooms containing a door - last in the order given in the source text. Example: if</p>
|
||
<!-- START CODE "c273" -->
|
||
<a id="c273"></a><blockquote class="code"><p class="quoted">
|
||
The red rock stair is east of the Orchard and above the Undertomb.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then "back side of the red rock stair" produces the Undertomb. A one-sided door has no "back side."</p>
|
||
|
||
*=ph_othersideof=*
|
||
|
||
<p>This phrase produces the room on the other side of the door, as seen from the given vantage point, which needs to be one of its sides. Example: if</p>
|
||
<!-- START CODE "c274" -->
|
||
<a id="c274"></a><blockquote class="code"><p class="quoted">
|
||
The red rock stair is east of the Orchard and above the Undertomb.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then "other side of the red rock stair from the Undertomb" produces the Orchard, and vice versa.</p>
|
||
|
||
*=ph_directionofdoor=*
|
||
|
||
<p>This phrase produces the direction in which the door leads, as seen from the given vantage point, which needs to be one of its sides. Example: if</p>
|
||
<!-- START CODE "c275" -->
|
||
<a id="c275"></a><blockquote class="code"><p class="quoted">
|
||
The red rock stair is east of the Orchard and above the Undertomb.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>then "direction of the red rock stair from the Undertomb" produces up.</p>
|
||
|
||
*=ph_showme=*
|
||
|
||
<p>This phrase is intended for testing purposes only. If used in a story file running inside the Inform application, it prints a line of text showing the given value and its kind; in a Released story file, it does nothing at all. Example:</p>
|
||
<!-- START CODE "c2858" -->
|
||
<a id="c2858"></a><blockquote class="code"><p class="quoted">
|
||
When play begins: showme 11.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces</p>
|
||
<!-- START CODE "c2859" -->
|
||
<a id="c2859"></a><blockquote class="code"><p class="quoted">
|
||
number: 11
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>More usefully:</p>
|
||
<!-- START CODE "c2860" -->
|
||
<a id="c2860"></a><blockquote class="code"><p class="quoted">
|
||
Every turn: showme the score.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Now, every turn, we get a line in the story's transcript like so:</p>
|
||
<!-- START CODE "c2861" -->
|
||
<a id="c2861"></a><blockquote class="code"><p class="quoted">
|
||
"score" = number: 0
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Inform uses the quotation marks and equals sign to show that it had to do some work to find the answer. "score" wasn't a constant value - it was a variable, and Inform had to look up the current value.</p>
|
||
|
||
*=ph_group=*
|
||
|
||
<p>This phrase causes the objects described to be listed together in a single item as part of an inventory or room description. The effect is temporary, and the phrase should only be used when this list is imminent. Example:</p>
|
||
<!-- START CODE "c6498" -->
|
||
<a id="c6498"></a><blockquote class="code"><p class="quoted">
|
||
Utensil is a kind of thing. The knife, the fork and the spoon are utensils. Before listing contents: group utensils together.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This might produce the list item "fork and spoon".</p>
|
||
|
||
*=ph_groupart=*
|
||
|
||
<p>This phrase causes the objects described to be listed together in a single item as part of an inventory or room description, but giving each individual item its indefinite article. The effect is temporary, and the phrase should only be used when this list is imminent. Example:</p>
|
||
<!-- START CODE "c6499" -->
|
||
<a id="c6499"></a><blockquote class="code"><p class="quoted">
|
||
Utensil is a kind of thing. The knife, the fork and the spoon are utensils. Before listing contents: group utensils together giving articles.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This might produce the list item "a fork and a spoon".</p>
|
||
|
||
*=ph_grouptext=*
|
||
|
||
<p>This phrase causes the objects described to be listed together in a single item as part of an inventory or room description, summarised with the given text. The effect is temporary, and the phrase should only be used when this list is imminent. Example:</p>
|
||
<!-- START CODE "c6500" -->
|
||
<a id="c6500"></a><blockquote class="code"><p class="quoted">
|
||
Utensil is a kind of thing. The knife, the fork and the spoon are utensils. Before listing contents: group utensils together as "utensils".
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This might produce the list item "two utensils (fork and spoon)".</p>
|
||
|
||
*=ph_locationof=*
|
||
|
||
<p>This phrase produces the room which, perhaps indirectly, contains the object given. Example: if the player stands in Biblioll College and wears a waistcoat, inside which is a fob watch, then</p>
|
||
<!-- START CODE "c483" -->
|
||
<a id="c483"></a><blockquote class="code"><p class="quoted">
|
||
location of the fob watch
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>is Biblioll College. In general, a thing cannot be in two rooms at once, but there are two exceptions: two-sided doors, present on both sides, and backdrops. The "location of" a door is its front side, but a backdrop has no location. (Objects which are not things at all, such as rooms and directions, also have no location.)</p>
|
||
|
||
*=ph_say=*
|
||
|
||
<p>This phrase writes out the given text for the player to read. Normally it is simply shown on screen, not spoken aloud, unless software adapted for partially sighted people is being used.</p>
|
||
|
||
*=phs_bold=*
|
||
|
||
<p>This text substitution produces no text. It's used only for a side-effect: to make the text following it appear in bold face. "[roman type]" should be used to switch back to normal. Example:</p>
|
||
<!-- START CODE "c965" -->
|
||
<a id="c965"></a><blockquote class="code"><p class="quoted">
|
||
"Jane looked down. [bold type]Danger[roman type], the sign read."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_italic=*
|
||
|
||
<p>This text substitution produces no text. It's used only for a side-effect: to make the text following it appear in italics. "[roman type]" should be used to switch back to normal. Example:</p>
|
||
<!-- START CODE "c966" -->
|
||
<a id="c966"></a><blockquote class="code"><p class="quoted">
|
||
"This is [italic type]very suspicious[roman type], said Peter."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_roman=*
|
||
|
||
<p>This text substitution produces no text. It's used only for a side-effect: to return to ordinary Roman type after a previous use of "[bold type]" or "[italic type]".</p>
|
||
|
||
*=phs_fixedspacing=*
|
||
|
||
<p>This text substitution produces no text. It's used only for a side-effect: to make the text following it appear with fixed letter spacing. In variable letter spacing, a lower case "m" is much wider than an "l", which is natural to the eye since it has been printing practice since the Renaissance. Fixed letter spacing is more like typewriting, and it is best used to reproduce typewritten text or printed notices; it can also be convenient for making simple diagrams. Example:</p>
|
||
<!-- START CODE "c967" -->
|
||
<a id="c967"></a><blockquote class="code"><p class="quoted">
|
||
"On the door is written: [fixed letter spacing]J45--O-O-O[variable letter spacing]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=phs_varspacing=*
|
||
|
||
<p>This text substitution produces no text. It's used only for a side-effect: to return to ordinary letter spacing after a previous use of "[fixed letter spacing]".</p>
|
||
|
||
*=ph_repeattable=*
|
||
|
||
<p>This phrase causes the block of phrases following it to be repeated once for each row in the given table, choosing each row in turn, from top to bottom. Blank rows are skipped. Example:</p>
|
||
<!-- START CODE "c5090" -->
|
||
<a id="c5090"></a><blockquote class="code"><p class="quoted">
|
||
To list the succession:
|
||
<br />    say "The Succession List runs as follows...";
|
||
<br />    repeat through the Table of Recent Monarchs:
|
||
<br />        say "[accession entry]: [name entry] ([family entry])."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_repeattablereverse=*
|
||
|
||
<p>This phrase causes the block of phrases following it to be repeated once for each row in the given table, choosing each row in turn, from bottom to top. Blank rows are skipped.</p>
|
||
|
||
*=ph_repeattablecol=*
|
||
|
||
<p>This phrase causes the block of phrases following it to be repeated once for each row in the given table, choosing each row in turn, in order of the values in the given column. Blank rows are skipped. Example:</p>
|
||
<!-- START CODE "c5091" -->
|
||
<a id="c5091"></a><blockquote class="code"><p class="quoted">
|
||
repeat through the Table of Recent Monarchs in name order: ...
|
||
<br />repeat through the Table of Recent Monarchs in accession order: ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>work through the same table in rather different orders. The sequence is lower to higher (small numbers to high numbers, A to Z, and so on); insert "reverse" after "in" to reverse this.</p>
|
||
|
||
*=ph_repeattablecolreverse=*
|
||
|
||
<p>This phrase causes the block of phrases following it to be repeated once for each row in the given table, choosing each row in turn, in order of the values in the given column. Blank rows are skipped. Example:</p>
|
||
<!-- START CODE "c5092" -->
|
||
<a id="c5092"></a><blockquote class="code"><p class="quoted">
|
||
repeat through the Table of Recent Monarchs in reverse name order: ...
|
||
<br />repeat through the Table of Recent Monarchs in reverse accession order: ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>work through the same table in rather different orders. The sequence is higher to lower (high numbers to small numbers, Z to A, and so on); delete the "reverse" after "in" to reverse this.</p>
|
||
|
||
*=ph_sortrandom=*
|
||
|
||
<p>This phrase rearranges the rows of the given table so that the non-blank rows occur at the top, in a uniformly random order, and any blank rows at the bottom. Example:</p>
|
||
<!-- START CODE "c5154" -->
|
||
<a id="c5154"></a><blockquote class="code"><p class="quoted">
|
||
sort the Table of Recent Monarchs in random order;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_sortcolumn=*
|
||
|
||
<p>This phrase rearranges the rows of the given table so that the non-blank rows occur at the top, so that the given column has ascending order, and any blank rows at the bottom. Example:</p>
|
||
<!-- START CODE "c5155" -->
|
||
<a id="c5155"></a><blockquote class="code"><p class="quoted">
|
||
sort the Table of Recent Monarchs in accession order;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Ascending order means 1 up to 10, say, or A up to Z, with blank values coming last.</p>
|
||
|
||
*=ph_sortcolumnreverse=*
|
||
|
||
<p>This phrase rearranges the rows of the given table so that the non-blank rows occur at the top, so that the given column has descending order, and any blank rows at the bottom. Example:</p>
|
||
<!-- START CODE "c5156" -->
|
||
<a id="c5156"></a><blockquote class="code"><p class="quoted">
|
||
sort the Table of Recent Monarchs in reverse name order;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>Descending order means 10 down to 1, say, or Z down to A, with blank values coming last.</p>
|
||
|
||
*=ph_repeat=*
|
||
|
||
<p>This phrase causes the block of phrases following it to be repeated once for each value in the given range, storing that value in the named variable. (The variable exists only temporarily, within the repetition.) Example:</p>
|
||
<!-- START CODE "c2939" -->
|
||
<a id="c2939"></a><blockquote class="code"><p class="quoted">
|
||
repeat with counter running from 1 to 10:
|
||
<br />    ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This, and runs through the given phrases ten times. Within those phrases, a special value called "counter" has the value 1 the first time through, then the value 2, then 3 and so on up to 10. (It can of course be called whatever we like: this is only an example.) The range can be from any kind where ranges make sense - anything on which arithmetic can be done, so for instance</p>
|
||
<!-- START CODE "c2940" -->
|
||
<a id="c2940"></a><blockquote class="code"><p class="quoted">
|
||
repeat with moment running from 4 PM to 4:07 PM:
|
||
<br />    ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>and also any enumeration:</p>
|
||
<!-- START CODE "c2941" -->
|
||
<a id="c2941"></a><blockquote class="code"><p class="quoted">
|
||
Colour is a kind of value. The colours are red, orange, yellow, green, blue, indigo and violet.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<!-- START CODE "c2942" -->
|
||
<a id="c2942"></a><blockquote class="code"><p class="quoted">
|
||
...
|
||
<br />    repeat with hue running from orange to indigo:
|
||
<br />        ...
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
|
||
*=ph_abide=*
|
||
|
||
<p>This phrase applies the given rule, and makes its result the result of the present rule. If the rule being abided by succeeds or fails then the original rule also stops, at once and without going on to any further instructions. Example:</p>
|
||
<!-- START CODE "c7994" -->
|
||
<a id="c7994"></a><blockquote class="code"><p class="quoted">
|
||
The omnibus rule:
|
||
<br />    abide by the first rule;
|
||
<br />    abide by the second rule;
|
||
<br />    abide by the third rule;
|
||
<br />    abide by the fourth rule.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>This duplicates the effect of a rulebook of four rules: the "omnibus rule" tries each in turn, and stops as soon as any of them stop.</p>
|
||
|
||
*=ph_abidefor=*
|
||
|
||
<p>This phrase applies the given rule to the given value, and makes its result the result of the present rule. If the rule being abided by succeeds or fails then the original rule also stops, at once and without going on to any further instructions.</p>
|
||
|
||
*=ph_abideanon=*
|
||
|
||
<p>This phrase applies the given rule, and makes its result the result of the present rule. If the rule being abided by succeeds or fails then the original rule also stops, at once and without going on to any further instructions. However, the rule deemed to have decided the outcome is the one abided by, not the one doing the abiding.</p>
|
||
|
||
*=ph_let=*
|
||
|
||
<p>This phrase creates a new temporary variable, starting it with the value supplied. The variable lasts only for the present block of phrases, which certainly means that it lasts only for the current rule. Examples:</p>
|
||
<!-- START CODE "c3001" -->
|
||
<a id="c3001"></a><blockquote class="code"><p class="quoted">
|
||
let outer bull be 25;
|
||
<br />let the current appearance be "reddish brown";
|
||
<br />let the special room be Marley Wood;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>The kinds of these are deduced from the values given, so that, for instance,</p>
|
||
<!-- START CODE "c3002" -->
|
||
<a id="c3002"></a><blockquote class="code"><p class="quoted">
|
||
say "The outer bull scores [the outer bull in words] when you practice archery in [special room]."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces</p>
|
||
<!-- START CODE "c3003" -->
|
||
<a id="c3003"></a><blockquote class="code"><p class="quoted">
|
||
The outer bull scores twenty-five when you practice archery in Marley Wood.
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>The variable name should be a new one; if it's the name of an existing one, then the kinds must agree. So:</p>
|
||
<!-- START CODE "c3004" -->
|
||
<a id="c3004"></a><blockquote class="code"><p class="quoted">
|
||
let outer bull be 25;
|
||
<br />let outer bull be 50;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>is a legal combination, because the second "let" simply changes the value of the existing "outer bull" variable to a different number.</p>
|
||
|
||
*=ph_letdefault=*
|
||
|
||
<p>This phrase creates a new temporary variable of the given kind. The variable lasts only for the present block of phrases, which certainly means that it lasts only for the current rule. Example:</p>
|
||
<!-- START CODE "c3005" -->
|
||
<a id="c3005"></a><blockquote class="code"><p class="quoted">
|
||
let inner bull be a number;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>The variable created holding the default value for that kind - in this case, the number 0. A handful of very obscure kinds have no default values, and then a problem message is produced. Inform also disallows:</p>
|
||
<!-- START CODE "c3006" -->
|
||
<a id="c3006"></a><blockquote class="code"><p class="quoted">
|
||
let the conveyance be a vehicle;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>because temporary variables aren't allowed to have kinds more specific than "object". (This is a good thing: suppose there are no vehicles in the world?) It's quite safe in such cases to use</p>
|
||
<!-- START CODE "c3007" -->
|
||
<a id="c3007"></a><blockquote class="code"><p class="quoted">
|
||
let the conveyance be an object;
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>instead, which creates it as the special object value "nothing".</p>
|
||
|
||
*=phs_realplaces=*
|
||
|
||
<p>This text substitution writes out the number to the given number of decimal places. Examples:</p>
|
||
<!-- START CODE "c4545" -->
|
||
<a id="c4545"></a><blockquote class="code"><p class="quoted">
|
||
"The semicircle is roughly [pi to 3 decimal places] paces around."
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces "The semicircle is roughly 3.142 paces around." The number of places can only usefully be from 1 to 8. Note that, for example, "[1.235 x 10^-7 to 3 decimal places]" produces 0.0; "[1.235 x 10^8 to 3 decimal places]"...</p>
|
||
|
||
*=phs_decimal=*
|
||
|
||
<p>This text substitution writes out the number in decimal form, that is, avoiding "x 10^n" even for very large or very small quantities. For example,</p>
|
||
<!-- START CODE "c4546" -->
|
||
<a id="c4546"></a><blockquote class="code"><p class="quoted">
|
||
"[1.23457 x 10^8 in decimal notation]"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces 123457000.0 rather than 1.23457 x 10^8. This can look pretty extreme: for example, "[1.8986 x 10^27 in decimal notation]", the mass of the planet Jupiter in kilograms, produces 1898597440000000000000000000.0.</p>
|
||
|
||
*=phs_decimalplaces=*
|
||
|
||
<p>This text substitution writes out the number in decimal form, but rounding to the accuracy given.</p>
|
||
|
||
*=phs_scientific=*
|
||
|
||
<p>This text substitution writes out the number in scientific form, that is, using "x 10^n" even for easy-to-judge quantities. For example,</p>
|
||
<!-- START CODE "c4547" -->
|
||
<a id="c4547"></a><blockquote class="code"><p class="quoted">
|
||
"[the reciprocal of 137 in scientific notation]"
|
||
</p></blockquote>
|
||
<!-- END CODE -->
|
||
<p>produces 7.29927 x 10^-3 rather than 0.0073. This can look odd: for example, "[pi in scientific notation]" comes out as 3.14159 × 10^0 rather than 3.14159.</p>
|
||
|
||
*=phs_scientificplaces=*
|
||
|
||
<p>This text substitution writes out the number in scientific form, but rounding to the accuracy given.</p>
|
||
|