2021-03-26 01:20:37 +02:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
< html >
< head >
< title > Imperative Definitions< / title >
< link href = "../docs-assets/Breadcrumbs.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< meta name = "viewport" content = "width=device-width initial-scale=1" >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" >
< meta http-equiv = "Content-Language" content = "en-gb" >
< link href = "../docs-assets/Contents.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Progress.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Navigation.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Fonts.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Base.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< script >
function togglePopup(material_id) {
var popup = document.getElementById(material_id);
popup.classList.toggle("show");
}
< / script >
< link href = "../docs-assets/Popups.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< link href = "../docs-assets/Colours.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
< / head >
< body class = "commentary-font" >
< nav role = "navigation" >
< h1 > < a href = "../index.html" >
< img src = "../docs-assets/Inform.png" height = 72" >
< / a > < / h1 >
< ul > < li > < a href = "../compiler.html" > compiler tools< / a > < / li >
< li > < a href = "../other.html" > other tools< / a > < / li >
< li > < a href = "../extensions.html" > extensions and kits< / a > < / li >
< li > < a href = "../units.html" > unit test tools< / a > < / li >
< / ul > < h2 > Compiler Webs< / h2 > < ul >
< li > < a href = "../inbuild/index.html" > inbuild< / a > < / li >
< li > < a href = "../inform7/index.html" > inform7< / a > < / li >
< li > < a href = "../inter/index.html" > inter< / a > < / li >
< / ul > < h2 > Inbuild Modules< / h2 > < ul >
< li > < a href = "../supervisor-module/index.html" > supervisor< / a > < / li >
< / ul > < h2 > Inform7 Modules< / h2 > < ul >
< li > < a href = "../core-module/index.html" > core< / a > < / li >
< li > < a href = "index.html" > < span class = "selectedlink" > assertions< / span > < / a > < / li >
< li > < a href = "../values-module/index.html" > values< / a > < / li >
< li > < a href = "../knowledge-module/index.html" > knowledge< / a > < / li >
< li > < a href = "../imperative-module/index.html" > imperative< / a > < / li >
< li > < a href = "../runtime-module/index.html" > runtime< / a > < / li >
< li > < a href = "../if-module/index.html" > if< / a > < / li >
< li > < a href = "../multimedia-module/index.html" > multimedia< / a > < / li >
< li > < a href = "../index-module/index.html" > index< / a > < / li >
< / ul > < h2 > Inter Modules< / h2 > < ul >
< li > < a href = "../bytecode-module/index.html" > bytecode< / a > < / li >
< li > < a href = "../building-module/index.html" > building< / a > < / li >
< li > < a href = "../codegen-module/index.html" > codegen< / a > < / li >
< / ul > < h2 > Services< / h2 > < ul >
< li > < a href = "../arch-module/index.html" > arch< / a > < / li >
< li > < a href = "../calculus-module/index.html" > calculus< / a > < / li >
< li > < a href = "../html-module/index.html" > html< / a > < / li >
< li > < a href = "../inflections-module/index.html" > inflections< / a > < / li >
< li > < a href = "../kinds-module/index.html" > kinds< / a > < / li >
< li > < a href = "../linguistics-module/index.html" > linguistics< / a > < / li >
< li > < a href = "../problems-module/index.html" > problems< / a > < / li >
< li > < a href = "../syntax-module/index.html" > syntax< / a > < / li >
< li > < a href = "../words-module/index.html" > words< / a > < / li >
< li > < a href = "../../../inweb/docs/foundation-module/index.html" > foundation< / a > < / li >
< / ul >
< / nav >
< main role = "main" >
<!-- Weave of 'Imperative Definitions' generated by Inweb -->
< div class = "breadcrumbs" >
< ul class = "crumbs" > < li > < a href = "../index.html" > Home< / a > < / li > < li > < a href = "../compiler.html" > Inform7< / a > < / li > < li > < a href = "index.html" > assertions< / a > < / li > < li > < a href = "index.html#5" > Chapter 5: Imperative Code< / a > < / li > < li > < b > Imperative Definitions< / b > < / li > < / ul > < / div >
2021-03-27 01:03:25 +02:00
< p class = "purpose" > Each IMPERATIVE node in the syntax tree makes a definition using imperative code.< / p >
2021-03-26 01:20:37 +02:00
2021-03-27 01:03:25 +02:00
< p class = "commentary firstcommentary" > < a id = "SP1" class = "paragraph-anchor" > < / a > < b > § 1. < / b > Inform has several features — most obviously rules and "To ..." phrases —
where something is created with top-level syntax with a shape like so:
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "identifier-syntax" > Some< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > preamble< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > text< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ending< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > in< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > a< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > colon< / span > < span class = "plain-syntax" > :< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > a< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > body< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > of< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > instructions< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > like< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > so< / span > < span class = "plain-syntax" > ;< / span >
< / pre >
< p class = "commentary" > These are called "imperative definitions", and each one in the source text
is given its own < a href = "5-id.html#SP1" class = "internal" > imperative_defn< / a > : see < a href = "5-id.html#SP2" class = "internal" > ImperativeDefinitions::new< / a > below.
< / p >
2021-03-26 17:04:34 +02:00
2021-03-27 01:03:25 +02:00
< p class = "commentary" > The body has to be a standard chunk of Inform 7 code, which, roughly speaking,
is in the same format whatever is being defined here. This in due course becomes
its < span class = "extract" > < span class = "extract-syntax" > body_of_defn< / span > < / span > . But the preamble text can be very varied, and no syntactic
marker tells us directly what sort of language feature is being defined.
< / p >
< p class = "commentary" > To deal with this, each such language feature has its own < a href = "5-idf.html#SP2" class = "internal" > imperative_defn_family< / a > ;
and every < a href = "5-id.html#SP1" class = "internal" > imperative_defn< / a > belongs to just one family. So, for example, a
definition makes a "To..." phrase if its family is the one looked after by
< a href = "5-tpf.html" class = "internal" > To Phrase Family< / a > .
2021-03-26 01:20:37 +02:00
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > typedef< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > imperative_defn< / span > < span class = "plain-syntax" > {< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > imperative_defn_family< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > family< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > what manner of thing is defined< / span >
2021-03-26 01:20:37 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > general_pointer< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > family_specific_data< / span > < span class = "plain-syntax" > ;< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > parse_node< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > at< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > where this occurs in the syntax tree< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > phrase< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > body_of_defn< / span > < span class = "plain-syntax" > ;< / span >
2021-03-26 17:04:34 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > wording< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > log_text< / span > < span class = "plain-syntax" > ;< / span >
2021-03-26 01:20:37 +02:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CLASS_DEFINITION< / span >
< span class = "plain-syntax" > } < / span > < span class = "reserved-syntax" > imperative_defn< / span > < span class = "plain-syntax" > ;< / span >
< / pre >
2021-03-27 01:03:25 +02:00
< ul class = "endnotetexts" > < li > The structure imperative_defn is accessed in 5/idf, 5/adf, 5/tpf, 5/rf, 7/tap, 7/tcp, 7/aa, 7/am and here.< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP2" class = "paragraph-anchor" > < / a > < b > § 2. < / b > This creator function is called on each < span class = "extract" > < span class = "extract-syntax" > IMPERATIVE_NT< / span > < / span > node in the syntax
tree, which is to say, at each place where the punctuation looks like the
shape shown above.
2021-03-26 01:20:37 +02:00
< / p >
2021-03-27 01:03:25 +02:00
< p class = "commentary" > At this point, < span class = "extract" > < span class = "extract-syntax" > p< / span > < / span > has a number of < span class = "extract" > < span class = "extract-syntax" > INVOCATION_LIST_NT< / span > < / span > nodes hanging from it,
and those have been checked through for any early signs of trouble (see < a href = "2-is.html" class = "internal" > Imperative Subtrees< / a > ).
But nobody has looked at the preamble text at all, and our first task is to
find out which family the definition belongs to, on the basis of that text.
2021-03-26 17:04:34 +02:00
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
2021-03-27 01:03:25 +02:00
< span class = "reserved-syntax" > imperative_defn< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > ImperativeDefinitions::new< / span > < button class = "popup" onclick = "togglePopup('usagePopup1')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup1" > Usage of < span class = "code-font" > < span class = "function-syntax" > ImperativeDefinitions::new< / span > < / span > :< br / > Imperative Subtrees - < a href = "2-is.html#SP1" > § 1< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > parse_node< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > imperative_defn< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > CREATE< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > imperative_defn< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > at< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > body_of_defn< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > family< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > family_specific_data< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL_GENERAL_POINTER< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > log_text< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Node::get_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > current_sentence< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < a href = "5-idf.html#SP3" class = "function-link" > < span class = "function-syntax" > ImperativeDefinitionFamilies::identify< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > ;< / span >
2021-03-26 17:04:34 +02:00
< span class = "plain-syntax" > }< / span >
< / pre >
2021-03-27 01:03:25 +02:00
< p class = "commentary firstcommentary" > < a id = "SP3" class = "paragraph-anchor" > < / a > < b > § 3. < / b > In our compiled code, it's useful to label functions with Inter comments:
2021-03-26 01:20:37 +02:00
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
2021-03-27 01:03:25 +02:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > ImperativeDefinitions::write_comment_describing< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > imperative_defn< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TEMPORARY_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE_TO< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "%~W:"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > log_text< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Produce::comment< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Emit::tree< / span > < span class = "plain-syntax" > (), < / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > DISCARD_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > C< / span > < span class = "plain-syntax" > )< / span >
2021-03-26 01:20:37 +02:00
< span class = "plain-syntax" > }< / span >
< / pre >
2021-03-27 01:03:25 +02:00
< p class = "commentary firstcommentary" > < a id = "SP4" class = "paragraph-anchor" > < / a > < b > § 4. < / b > And similarly:
2021-03-26 17:04:34 +02:00
< / p >
2021-03-26 01:20:37 +02:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-03-27 01:03:25 +02:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > ImperativeDefinitions::index_preamble< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUTPUT_STREAM< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > imperative_defn< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > WRITE< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "%+W"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > log_text< / span > < span class = "plain-syntax" > );< / span >
2021-03-26 01:20:37 +02:00
< span class = "plain-syntax" > }< / span >
< / pre >
2021-03-27 01:03:25 +02:00
< p class = "commentary firstcommentary" > < a id = "SP5" class = "paragraph-anchor" > < / a > < b > § 5. < / b > IDs are happened early on in Inform's run, at a time when many nouns have
not been created, so no very detailed parsing of the preamble is possible.
This second stage, called "assessment", takes place later and makes a more
detailed look possible.
< / p >
2021-03-26 01:20:37 +02:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-03-27 01:03:25 +02:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > ImperativeDefinitions::assess_all< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > initial_problem_count< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > problem_count< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "5-id.html#SP5_1" class = "named-paragraph-link" > < span class = "named-paragraph" > Step 1 - Assess< / span > < span class = "named-paragraph-number" > 5.1< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "5-id.html#SP5_2" class = "named-paragraph-link" > < span class = "named-paragraph" > Step 2 - Register< / span > < span class = "named-paragraph-number" > 5.2< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "5-id.html#SP5_3" class = "named-paragraph-link" > < span class = "named-paragraph" > Step 3 - Make the runtime context data< / span > < span class = "named-paragraph-number" > 5.3< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "5-id.html#SP5_4" class = "named-paragraph-link" > < span class = "named-paragraph" > Step 4 - Complete< / span > < span class = "named-paragraph-number" > 5.4< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
2021-03-26 01:20:37 +02:00
< span class = "plain-syntax" > }< / span >
< / pre >
2021-03-27 01:03:25 +02:00
< p class = "commentary firstcommentary" > < a id = "SP5_1" class = "paragraph-anchor" > < / a > < b > § 5.1. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Step 1 - Assess< / span > < span class = "named-paragraph-number" > 5.1< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
2021-03-26 01:20:37 +02:00
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > total< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NUMBER_CREATED< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > imperative_defn< / span > < span class = "plain-syntax" > ), < / span > < span class = "identifier-syntax" > created< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > imperative_defn< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > imperative_defn< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > created< / span > < span class = "plain-syntax" > ++;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > created< / span > < span class = "plain-syntax" > % < / span > < span class = "constant-syntax" > 10< / span > < span class = "plain-syntax" > ) == < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ProgressBar::update< / span > < span class = "plain-syntax" > (3,< / span >
< span class = "plain-syntax" > ((< / span > < span class = "reserved-syntax" > float< / span > < span class = "plain-syntax" > ) (< / span > < span class = "identifier-syntax" > created< / span > < span class = "plain-syntax" > ))/((< / span > < span class = "reserved-syntax" > float< / span > < span class = "plain-syntax" > ) (< / span > < span class = "identifier-syntax" > total< / span > < span class = "plain-syntax" > )));< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > current_sentence< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > at< / span > < span class = "plain-syntax" > ;< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < a href = "5-idf.html#SP4" class = "function-link" > < span class = "function-syntax" > ImperativeDefinitionFamilies::assess< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > Node::is< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > at< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > next< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > DEFN_CONT_NT< / span > < span class = "plain-syntax" > ) == < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ) & & (< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > at< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > down< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) & & < / span >
2021-03-27 17:21:07 +02:00
< span class = "plain-syntax" > (< / span > < a href = "5-idf.html#SP10" class = "function-link" > < span class = "function-syntax" > ImperativeDefinitionFamilies::allows_empty< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > ) == < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > )) {< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > StandardProblems::sentence_problem< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Task::syntax_tree< / span > < span class = "plain-syntax" > (), < / span > < span class = "identifier-syntax" > _p_< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > PM_Undefined< / span > < span class = "plain-syntax" > ),< / span >
< span class = "plain-syntax" > < / span > < span class = "string-syntax" > "there doesn't seem to be any definition here"< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "string-syntax" > "so I can't see what this rule or phrase would do."< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > } < / span > < span class = "reserved-syntax" > else< / span > < span class = "plain-syntax" > {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > phrase< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > body< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Phrases::create_from_preamble< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > body_of_defn< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > body< / span > < span class = "plain-syntax" > ;< / span >
2021-03-27 17:21:07 +02:00
< span class = "plain-syntax" > < / span > < a href = "5-idf.html#SP5" class = "function-link" > < span class = "function-syntax" > ImperativeDefinitionFamilies::given_body< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Phrases::prepare_stack_frame< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > body< / span > < span class = "plain-syntax" > );< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > }< / span >
2021-03-26 01:20:37 +02:00
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > initial_problem_count< / span > < span class = "plain-syntax" > < < / span > < span class = "identifier-syntax" > problem_count< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
< / pre >
2021-03-27 01:03:25 +02:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "5-id.html#SP5" > § 5< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP5_2" class = "paragraph-anchor" > < / a > < b > § 5.2. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Step 2 - Register< / span > < span class = "named-paragraph-number" > 5.2< / span > < / span > < span class = "comment-syntax" > =< / span >
2021-03-26 01:20:37 +02:00
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > imperative_defn_family< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > imperative_defn_family< / span > < span class = "plain-syntax" > ) {< / span >
2021-03-27 17:21:07 +02:00
< span class = "plain-syntax" > < / span > < a href = "5-idf.html#SP6" class = "function-link" > < span class = "function-syntax" > ImperativeDefinitionFamilies::register< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > );< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > initial_problem_count< / span > < span class = "plain-syntax" > < < / span > < span class = "identifier-syntax" > problem_count< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2021-03-26 01:20:37 +02:00
< / pre >
2021-03-27 01:03:25 +02:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "5-id.html#SP5" > § 5< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP5_3" class = "paragraph-anchor" > < / a > < b > § 5.3. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Step 3 - Make the runtime context data< / span > < span class = "named-paragraph-number" > 5.3< / span > < / span > < span class = "comment-syntax" > =< / span >
2021-03-26 01:20:37 +02:00
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > imperative_defn< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > imperative_defn< / span > < span class = "plain-syntax" > )< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > body_of_defn< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > runtime_context_data< / span > < span class = "plain-syntax" > =< / span >
2021-03-27 17:21:07 +02:00
< span class = "plain-syntax" > < / span > < a href = "5-idf.html#SP7" class = "function-link" > < span class = "function-syntax" > ImperativeDefinitionFamilies::to_phrcd< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id< / span > < span class = "plain-syntax" > );< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > initial_problem_count< / span > < span class = "plain-syntax" > < < / span > < span class = "identifier-syntax" > problem_count< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
2021-03-26 01:20:37 +02:00
< / pre >
2021-03-27 01:03:25 +02:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "5-id.html#SP5" > § 5< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP5_4" class = "paragraph-anchor" > < / a > < b > § 5.4. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Step 4 - Complete< / span > < span class = "named-paragraph-number" > 5.4< / span > < / span > < span class = "comment-syntax" > =< / span >
2021-03-26 01:20:37 +02:00
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > imperative_defn_family< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > imperative_defn_family< / span > < span class = "plain-syntax" > ) {< / span >
2021-03-27 17:21:07 +02:00
< span class = "plain-syntax" > < / span > < a href = "5-idf.html#SP8" class = "function-link" > < span class = "function-syntax" > ImperativeDefinitionFamilies::assessment_complete< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > );< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > initial_problem_count< / span > < span class = "plain-syntax" > < < / span > < span class = "identifier-syntax" > problem_count< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > ;< / span >
2021-03-26 01:20:37 +02:00
< span class = "plain-syntax" > }< / span >
< / pre >
2021-03-27 01:03:25 +02:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "5-id.html#SP5" > § 5< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP6" class = "paragraph-anchor" > < / a > < b > § 6. < / b > Whatever is defined probably wants to compile the body of the definition
into at least one (and perhaps more than one) Inter function. This is handled
in two stages. Stage one:
2021-03-26 01:20:37 +02:00
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
2021-03-27 01:03:25 +02:00
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > total_phrases_to_compile< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > total_phrases_compiled< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > ImperativeDefinitions::compile_first_block< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "5-id.html#SP6_1" class = "named-paragraph-link" > < span class = "named-paragraph" > Count up the scale of the task< / span > < span class = "named-paragraph-number" > 6.1< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > imperative_defn_family< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > imperative_defn_family< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > compile_last< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > )< / span >
2021-03-27 17:21:07 +02:00
< span class = "plain-syntax" > < / span > < a href = "5-idf.html#SP12" class = "function-link" > < span class = "function-syntax" > ImperativeDefinitionFamilies::compile< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > ,< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > & < / span > < span class = "identifier-syntax" > total_phrases_compiled< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > total_phrases_to_compile< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > imperative_defn_family< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > compile_last< / span > < span class = "plain-syntax" > )< / span >
2021-03-27 17:21:07 +02:00
< span class = "plain-syntax" > < / span > < a href = "5-idf.html#SP12" class = "function-link" > < span class = "function-syntax" > ImperativeDefinitionFamilies::compile< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > ,< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > & < / span > < span class = "identifier-syntax" > total_phrases_compiled< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > total_phrases_to_compile< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2021-03-26 01:20:37 +02:00
< / pre >
2021-03-27 01:03:25 +02:00
< p class = "commentary firstcommentary" > < a id = "SP6_1" class = "paragraph-anchor" > < / a > < b > § 6.1. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Count up the scale of the task< / span > < span class = "named-paragraph-number" > 6.1< / span > < / span > < span class = "comment-syntax" > =< / span >
2021-03-26 01:20:37 +02:00
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > total_phrases_compiled< / span > < span class = "plain-syntax" > = < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ;< / span >
2021-03-26 01:20:37 +02:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > phrase< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > ph< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > ph< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > phrase< / span > < span class = "plain-syntax" > )< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > ph< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > at_least_one_compiled_form_needed< / span > < span class = "plain-syntax" > )< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > total_phrases_to_compile< / span > < span class = "plain-syntax" > ++;< / span >
2021-03-26 01:20:37 +02:00
< / pre >
2021-03-27 01:03:25 +02:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "5-id.html#SP6" > § 6< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP7" class = "paragraph-anchor" > < / a > < b > § 7. < / b > Stage two happens at least later, and may be repeated, so that it is
important not to do anything twice. This is intended as a final round-up of
any run-time resources which need to be made by the family.
2021-03-26 01:20:37 +02:00
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > ImperativeDefinitions::compile_as_needed< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2021-03-27 01:03:25 +02:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > imperative_defn_family< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > imperative_defn_family< / span > < span class = "plain-syntax" > )< / span >
2021-03-27 17:21:07 +02:00
< span class = "plain-syntax" > < / span > < a href = "5-idf.html#SP13" class = "function-link" > < span class = "function-syntax" > ImperativeDefinitionFamilies::compile_as_needed< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idf< / span > < span class = "plain-syntax" > ,< / span >
2021-03-26 01:20:37 +02:00
< span class = "plain-syntax" > & < / span > < span class = "identifier-syntax" > total_phrases_compiled< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > total_phrases_to_compile< / span > < span class = "plain-syntax" > );< / span >
2021-03-26 17:04:34 +02:00
< span class = "plain-syntax" > }< / span >
< / pre >
2021-03-26 01:20:37 +02:00
< nav role = "progress" > < div class = "progresscontainer" >
2021-03-27 01:03:25 +02:00
< ul class = "progressbar" > < li class = "progressprev" > < a href = "4-imp.html" > ❮ < / a > < / li > < li class = "progresschapter" > < a href = "P-wtmd.html" > P< / a > < / li > < li class = "progresschapter" > < a href = "1-am.html" > 1< / a > < / li > < li class = "progresschapter" > < a href = "2-bv.html" > 2< / a > < / li > < li class = "progresschapter" > < a href = "3-dlr.html" > 3< / a > < / li > < li class = "progresschapter" > < a href = "4-nr.html" > 4< / a > < / li > < li class = "progresscurrentchapter" > 5< / li > < li class = "progresscurrent" > id< / li > < li class = "progresssection" > < a href = "5-idf.html" > idf< / a > < / li > < li class = "progresssection" > < a href = "5-adf.html" > adf< / a > < / li > < li class = "progresssection" > < a href = "5-tpf.html" > tpf< / a > < / li > < li class = "progresssection" > < a href = "5-rf.html" > rf< / a > < / li > < li class = "progresschapter" > < a href = "6-tc.html" > 6< / a > < / li > < li class = "progresschapter" > < a href = "7-kpr.html" > 7< / a > < / li > < li class = "progressnext" > < a href = "5-idf.html" > ❯ < / a > < / li > < / ul > < / div >
2021-03-26 01:20:37 +02:00
< / nav > <!-- End of weave -->
< / main >
< / body >
< / html >
