2021-04-03 16:32:59 +03:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
< html >
< head >
< title > Phrase Requests< / 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" >
2021-04-08 17:06:01 +03:00
< script src = "http://code.jquery.com/jquery-1.12.4.min.js"
integrity="sha256-ZosEbRLbNQzLpnKIkEdrPv7lOy9C27hHQ+Xp8a4MxAQ=" crossorigin="anonymous">< / script >
< script src = "../docs-assets/Bigfoot.js" > < / script >
< link href = "../docs-assets/Bigfoot.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
2021-04-03 16:32:59 +03:00
< 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" >
2022-04-28 19:37:28 +03:00
< h1 > < a href = "../index.html" >
2021-04-03 16:32:59 +03:00
< img src = "../docs-assets/Inform.png" height = 72" >
< / a > < / h1 >
2022-04-28 19:37:28 +03:00
< ul > < li > < a href = "../index.html" > home< / a > < / li >
2022-04-04 20:31:44 +03:00
< / ul > < h2 > Compiler< / h2 > < ul >
< li > < a href = "../structure.html" > structure< / a > < / li >
< li > < a href = "../inbuildn.html" > inbuild< / a > < / li >
< li > < a href = "../inform7n.html" > inform7< / a > < / li >
< li > < a href = "../intern.html" > inter< / a > < / li >
< li > < a href = "../services.html" > services< / a > < / li >
2022-04-18 17:46:46 +03:00
< li > < a href = "../secrets.html" > secrets< / a > < / li >
2022-04-04 20:31:44 +03:00
< / ul > < h2 > Other Tools< / h2 > < ul >
< li > < a href = "../inblorbn.html" > inblorb< / a > < / li >
< li > < a href = "../indocn.html" > indoc< / a > < / li >
< li > < a href = "../inform6.html" > inform6< / a > < / li >
< li > < a href = "../inpolicyn.html" > inpolicy< / a > < / li >
< li > < a href = "../inrtpsn.html" > inrtps< / a > < / li >
2022-04-07 01:30:32 +03:00
< / ul > < h2 > Resources< / h2 > < ul >
< li > < a href = "../extensions.html" > extensions< / a > < / li >
< li > < a href = "../kits.html" > kits< / a > < / li >
2022-04-04 20:31:44 +03:00
< / ul > < h2 > Repository< / h2 > < ul >
< li > < a href = "https://github.com/ganelson/inform" > < img src = "../docs-assets/github.png" height = 18 > github< / a > < / li >
< / ul > < h2 > Related Projects< / h2 > < ul >
2022-04-28 19:20:06 +03:00
< li > < a href = "../../../inweb/index.html" > inweb< / a > < / li >
< li > < a href = "../../../intest/index.html" > intest< / a > < / li >
2021-04-03 16:32:59 +03:00
< / ul >
< / nav >
< main role = "main" >
<!-- Weave of 'Phrase Requests' generated by Inweb -->
< div class = "breadcrumbs" >
2022-04-28 19:37:28 +03:00
< ul class = "crumbs" > < li > < a href = "../index.html" > Home< / a > < / li > < li > < a href = "../inform7n.html" > Inform7< / a > < / li > < li > < a href = "index.html" > imperative< / a > < / li > < li > < a href = "index.html#3" > Chapter 3: Functions< / a > < / li > < li > < b > Phrase Requests< / b > < / li > < / ul > < / div >
2021-04-03 16:32:59 +03:00
< p class = "purpose" > To store and later fill requests to compile To... phrases.< / p >
< p class = "commentary firstcommentary" > < a id = "SP1" class = "paragraph-anchor" > < / a > < b > § 1. < / b > "To..." phrases are compiled only when needed, and they can be compiled in
2021-04-08 17:06:01 +03:00
variant forms depending on the kinds of their arguments. Each of those forms
is compiled as a different function at runtime.< sup id = "fnref:1" > < a href = "#fn:1" rel = "footnote" > 1< / a > < / sup > For example, given the
2021-04-03 16:32:59 +03:00
definition:
< / p >
< blockquote >
< p > To judge (V - a value) against (W - a value): ...< / p >
< / blockquote >
< p class = "commentary" > the invocation:
< / p >
< blockquote >
< p > judge 2 against "two";< / p >
< / blockquote >
< p class = "commentary" > would result in a request to compile a version of "to judge... against..."
with the kind < span class = "extract" > < span class = "extract-syntax" > phrase (number, text) -> nothing< / span > < / span > .
< / p >
< p class = "commentary" > If the kind involves variables, the caller must also supply the current
values in force, so that there is no possible ambiguity in how we read K.
< / p >
< p class = "commentary" > When we want to invoke "to judge... against...", then, we call one of the
following twp functions. It returns the iname of the function we should
call, and makes a note for later that it will need to compile that function.
< / p >
2021-04-08 17:06:01 +03:00
< ul class = "footnotetexts" > < li class = "footnote" id = "fn:1" > < p class = "inwebfootnote" > < sup id = "fnref:1" > < a href = "#fn:1" rel = "footnote" > 1< / a > < / sup > I believe this practice is called monomorphisation, and is also how Rust
and most C++ compilers handle the same issue.
< a href = "#fnref:1" title = "return to text" > ↩ < / a > < / p > < / li > < / ul >
2021-04-03 16:32:59 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-04-10 19:55:28 +03:00
< span class = "identifier-syntax" > inter_name< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > PhraseRequests::simple_request< / 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" > PhraseRequests::simple_request< / span > < / span > :< br / > < a href = "3-pr.html#SP5" > § 5< / a > < br / > Closures - < a href = "3-cls.html#SP3_1" > § 3.1< / a > < br / > Compile Solutions to Equations - < a href = "5-cste.html#SP4" > § 4< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id_body< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > kind< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > req_kind< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < a href = "3-pr.html#SP1" class = "function-link" > < span class = "function-syntax" > PhraseRequests::complex_request< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > req_kind< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > EMPTY_WORDING< / span > < span class = "plain-syntax" > );< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > }< / span >
2021-04-10 19:55:28 +03:00
< span class = "identifier-syntax" > inter_name< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > PhraseRequests::complex_request< / span > < button class = "popup" onclick = "togglePopup('usagePopup2')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup2" > Usage of < span class = "code-font" > < span class = "function-syntax" > PhraseRequests::complex_request< / span > < / span > :< br / > Compile Invocations As Calls - < a href = "5-ciac.html#SP1" > § 1< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id_body< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > kind< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > req_kind< / span > < span class = "plain-syntax" > ,< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > kind_variable_declaration< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > kvd< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > wording< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > W< / 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" > IDTypeData::invoked_inline< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > ))< / span >
2021-04-10 19:55:28 +03:00
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "3-pr.html#SP1_1" class = "named-paragraph-link" > < span class = "named-paragraph" > Avoid the need for a request by using an inline typeless Inter function< / span > < span class = "named-paragraph-number" > 1.1< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > to_phrase_request< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > = < / span > < a href = "3-pr.html#SP2" class = "function-link" > < span class = "function-syntax" > PhraseRequests::request_inner< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > req_kind< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > kvd< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > W< / span > < span class = "plain-syntax" > );< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > req_iname< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP1_1" class = "paragraph-anchor" > < / a > < b > § 1.1. < / b > Suppose the phrase is defined inline, like so:
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "identifier-syntax" > To< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > judge< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > V< / span > < span class = "plain-syntax" > - < / span > < span class = "identifier-syntax" > a< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > value< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > against< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > W< / span > < span class = "plain-syntax" > - < / span > < span class = "identifier-syntax" > a< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > value< / span > < span class = "plain-syntax" > ):< / span >
< span class = "plain-syntax" > (- < / span > < span class = "identifier-syntax" > JudgeAgainst< / span > < span class = "plain-syntax" > ({< / span > < span class = "identifier-syntax" > V< / span > < span class = "plain-syntax" > }, {< / span > < span class = "identifier-syntax" > W< / span > < span class = "plain-syntax" > }); -)< / span >
< / pre >
< p class = "commentary" > We then assume that < span class = "extract" > < span class = "extract-syntax" > JudgeAgainst< / span > < / span > is provided by some kit of Inter code, and
can handle values of any kind which this may produce. So we return its iname,
and do not make a request. If the definition is any more complex than this,
we simply give in and throw a problem.
< / p >
< p class = "commentary" > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Avoid the need for a request by using an inline typeless Inter function< / span > < span class = "named-paragraph-number" > 1.1< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TEMPORARY_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > identifier< / span > < span class = "plain-syntax" > )< / span >
2021-04-10 19:55:28 +03:00
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "3-pr.html#SP1_1_1" class = "named-paragraph-link" > < span class = "named-paragraph" > Extract an identifier from the inline definition< / span > < span class = "named-paragraph-number" > 1.1.1< / span > < / a > < / 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" > Str::len< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > identifier< / span > < span class = "plain-syntax" > ) == < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ) < / span > < span class = "named-paragraph-container code-font" > < a href = "3-pr.html#SP1_1_2" class = "named-paragraph-link" > < span class = "named-paragraph" > Issue PM_PhraseNamedI6Failed< / span > < span class = "named-paragraph-number" > 1.1.2< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
2022-01-22 18:44:52 +02:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inter_name< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > symb< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > HierarchyLocations::find_by_name< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Emit::tree< / span > < span class = "plain-syntax" > (), < / span > < span class = "identifier-syntax" > identifier< / span > < span class = "plain-syntax" > );< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > DISCARD_TEXT< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > identifier< / 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" > symb< / span > < span class = "plain-syntax" > ;< / span >
< / pre >
2021-04-10 19:55:28 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "3-pr.html#SP1" > § 1< / a > .< / li > < / ul >
2021-04-03 16:32:59 +03:00
< p class = "commentary firstcommentary" > < a id = "SP1_1_1" class = "paragraph-anchor" > < / a > < b > § 1.1.1. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Extract an identifier from the inline definition< / span > < span class = "named-paragraph-number" > 1.1.1< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
2021-04-11 23:41:26 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > wchar_t< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > = < / span > < a href = "3-cid.html#SP6" class = "function-link" > < span class = "function-syntax" > CompileImperativeDefn::get_inline_definition< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > );< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > for< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > =0; < / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ]; < / span > < span class = "identifier-syntax" > i< / 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" > Characters::isalpha< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / 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" > j< / 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" > while< / span > < span class = "plain-syntax" > (((< / span > < span class = "identifier-syntax" > Characters::isalpha< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ])) ||< / span >
< span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Characters::isdigit< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ])) || (< / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ] == < / span > < span class = "character-syntax" > '_'< / span > < span class = "plain-syntax" > )) & & (< / span > < span class = "identifier-syntax" > j< / span > < span class = "plain-syntax" > ++ < < / span > < span class = "constant-syntax" > 31< / span > < span class = "plain-syntax" > ))< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > PUT_TO< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > identifier< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > p< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ++]);< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > break< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
2021-04-10 19:55:28 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "3-pr.html#SP1_1" > § 1.1< / a > .< / li > < / ul >
2021-04-03 16:32:59 +03:00
< p class = "commentary firstcommentary" > < a id = "SP1_1_2" class = "paragraph-anchor" > < / a > < b > § 1.1.2. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Issue PM_PhraseNamedI6Failed< / span > < span class = "named-paragraph-number" > 1.1.2< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > current_sentence< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > ImperativeDefinitions::body_at< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Problems::quote_source< / span > < span class = "plain-syntax" > (1, < / span > < span class = "identifier-syntax" > current_sentence< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Problems::quote_phrase< / span > < span class = "plain-syntax" > (2, < / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > StandardProblems::handmade_problem< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Task::syntax_tree< / span > < span class = "plain-syntax" > (),< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > _p_< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > PM_PhraseNamedI6Failed< / span > < span class = "plain-syntax" > ));< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Problems::issue_problem_segment< / span > < span class = "plain-syntax" > (< / span >
< span class = "plain-syntax" > < / span > < span class = "string-syntax" > "You wrote %1, defining the phrase '%2' with a piece of Inform 6 "< / span >
< span class = "plain-syntax" > < / span > < span class = "string-syntax" > "code, but also giving it a name as a function to be used in an "< / span >
< span class = "plain-syntax" > < / span > < span class = "string-syntax" > "equation, or in some functional programming context. That's only "< / span >
< span class = "plain-syntax" > < / span > < span class = "string-syntax" > "allowed if the I6 definition consists simply of a call to an "< / span >
< span class = "plain-syntax" > < / span > < span class = "string-syntax" > "I6 function - and this doesn't, so far as I can see."< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Problems::issue_problem_end< / 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" > identifier< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "ErrorRecoverySymbol"< / span > < span class = "plain-syntax" > );< / span >
< / pre >
2021-04-10 19:55:28 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "3-pr.html#SP1_1" > § 1.1< / a > .< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP2" class = "paragraph-anchor" > < / a > < b > § 2. < / b > That function calls this one, which returns a < a href = "3-pr.html#SP2" class = "internal" > to_phrase_request< / a > object
2021-04-03 16:32:59 +03:00
for the request needed.
< / 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" > to_phrase_request< / span > < span class = "plain-syntax" > {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > id_body< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > compile_from< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > kind< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > req_kind< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > kind< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > kv_interpretation< / span > < span class = "plain-syntax" > [27];< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inter_name< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > req_iname< / span > < span class = "plain-syntax" > ;< / span >
2021-09-21 01:17:10 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inter_name< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > md_iname< / span > < span class = "plain-syntax" > ;< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CLASS_DEFINITION< / span >
< span class = "plain-syntax" > } < / span > < span class = "reserved-syntax" > to_phrase_request< / span > < span class = "plain-syntax" > ;< / span >
2021-04-10 19:55:28 +03:00
< span class = "reserved-syntax" > to_phrase_request< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > PhraseRequests::request_inner< / span > < button class = "popup" onclick = "togglePopup('usagePopup3')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup3" > Usage of < span class = "code-font" > < span class = "function-syntax" > PhraseRequests::request_inner< / span > < / span > :< br / > < a href = "3-pr.html#SP1" > § 1< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > id_body< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > kind< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > K< / span > < span class = "plain-syntax" > ,< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > kind_variable_declaration< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > kvd< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > wording< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > W< / span > < span class = "plain-syntax" > ) {< / span >
2021-04-10 19:55:28 +03:00
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "3-pr.html#SP2_1" class = "named-paragraph-link" > < span class = "named-paragraph" > Issue a problem if K is still too vague< / span > < span class = "named-paragraph-number" > 2.1< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "3-pr.html#SP2_2" class = "named-paragraph-link" > < span class = "named-paragraph" > Check whether this request has already been made< / span > < span class = "named-paragraph-number" > 2.2< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "named-paragraph-container code-font" > < a href = "3-pr.html#SP2_3" class = "named-paragraph-link" > < span class = "named-paragraph" > Return a fresh request< / span > < span class = "named-paragraph-number" > 2.3< / span > < / a > < / span > < span class = "plain-syntax" > ;< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > }< / span >
< / pre >
2021-04-10 19:55:28 +03:00
< ul class = "endnotetexts" > < li > The structure to_phrase_request is accessed in 3/cid and here.< / li > < / ul >
2021-04-03 16:32:59 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2_1" class = "paragraph-anchor" > < / a > < b > § 2.1. < / b > It's quite hard to get this, but if you supply the empty list written as
a constant to a phrase which uses a kind variable in the form "list of K",
then K would have be just "value", since Inform doesn't know what the empty
list is a list of. The result would be:
< / p >
< p class = "commentary" > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Issue a problem if K is still too vague< / span > < span class = "named-paragraph-number" > 2.1< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) || (< / span > < span class = "identifier-syntax" > K< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > )) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "bad request"< / 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" > Kinds::Behaviour::semidefinite< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > K< / span > < span class = "plain-syntax" > ) == < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Problems::quote_source< / span > < span class = "plain-syntax" > (1, < / span > < span class = "identifier-syntax" > ImperativeDefinitions::body_at< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > ));< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > StandardProblems::handmade_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_UndeterminedKind< / 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" > Wordings::empty< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > W< / span > < span class = "plain-syntax" > )) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Problems::issue_problem_segment< / span > < span class = "plain-syntax" > (< / span >
< span class = "plain-syntax" > < / span > < span class = "string-syntax" > "The phrase %1 needs to be used in such a way that I know what kinds "< / span >
< span class = "plain-syntax" > < / span > < span class = "string-syntax" > "of values go into it."< / 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" > Problems::quote_wording_as_source< / span > < span class = "plain-syntax" > (2, < / span > < span class = "identifier-syntax" > W< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Problems::issue_problem_segment< / span > < span class = "plain-syntax" > (< / span >
< span class = "plain-syntax" > < / span > < span class = "string-syntax" > "The phrase %1 needs to be used in such a way that I know what kinds "< / span >
< span class = "plain-syntax" > < / span > < span class = "string-syntax" > "of values go into it; so I'm not sure how to make sense of it from %2."< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Problems::issue_problem_end< / span > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
2021-04-10 19:55:28 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "3-pr.html#SP2" > § 2< / a > .< / li > < / ul >
2021-04-03 16:32:59 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2_2" class = "paragraph-anchor" > < / a > < b > § 2.2. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Check whether this request has already been made< / span > < span class = "named-paragraph-number" > 2.2< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > to_phrase_request< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > req< / 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" > req< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > to_phrase_request< / 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" > idb< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > compile_from< / 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" > Kinds::eq< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > K< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > req_kind< / 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" > req< / span > < span class = "plain-syntax" > ;< / span >
< / pre >
2021-04-10 19:55:28 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "3-pr.html#SP2" > § 2< / a > .< / li > < / ul >
2021-04-03 16:32:59 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2_3" class = "paragraph-anchor" > < / a > < b > § 2.3. < / b > < span class = "named-paragraph-container code-font" > < span class = "named-paragraph-defn" > Return a fresh request< / span > < span class = "named-paragraph-number" > 2.3< / span > < / span > < span class = "comment-syntax" > =< / span >
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > to_phrase_request< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > CREATE< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > to_phrase_request< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > req_kind< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > K< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > compile_from< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Latticework::unpack_kvd< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > kv_interpretation< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > kvd< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > package_request< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Hierarchy::package_within< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > REQUESTS_HAP< / span > < span class = "plain-syntax" > ,< / span >
2022-01-23 02:32:26 +02:00
< span class = "plain-syntax" > < / span > < a href = "3-cid.html#SP8" class = "function-link" > < span class = "function-syntax" > CompileImperativeDefn::requests_package< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > idb< / span > < span class = "plain-syntax" > ));< / span >
2021-04-19 00:42:39 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > req_iname< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Hierarchy::make_iname_in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > PHRASE_FN_HL< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > );< / span >
2021-09-21 01:17:10 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > md_iname< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Hierarchy::make_iname_in< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > PHRASE_SYNTAX_MD_HL< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > );< / span >
2021-04-26 01:49:45 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > desc< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Str::new< / 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" > desc< / span > < span class = "plain-syntax" > , < / span > < span class = "string-syntax" > "phrase request (%u) for '%W'"< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > K< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > Node::get_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > compile_from< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > head_of_defn< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > at< / span > < span class = "plain-syntax" > ));< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Sequence::queue< / span > < span class = "plain-syntax" > (& < / span > < a href = "3-pr.html#SP4" class = "function-link" > < span class = "function-syntax" > PhraseRequests::compilation_agent< / span > < / a > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > STORE_POINTER_to_phrase_request< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > ), < / span > < span class = "identifier-syntax" > desc< / span > < span class = "plain-syntax" > );< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > ;< / span >
< / pre >
2021-04-10 19:55:28 +03:00
< ul class = "endnotetexts" > < li > This code is used in < a href = "3-pr.html#SP2" > § 2< / a > .< / li > < / ul >
2021-04-03 16:32:59 +03:00
< p class = "commentary firstcommentary" > < a id = "SP3" class = "paragraph-anchor" > < / a > < b > § 3. < / b > Two access functions:
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
2021-04-11 23:41:26 +03:00
< span class = "identifier-syntax" > kind< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > PhraseRequests::kind_of_request< / span > < button class = "popup" onclick = "togglePopup('usagePopup4')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup4" > Usage of < span class = "code-font" > < span class = "function-syntax" > PhraseRequests::kind_of_request< / span > < / span > :< br / > Compile Imperative Definitions - < a href = "3-cid.html#SP2_1" > § 2.1< / a > , < a href = "3-cid.html#SP2_2" > § 2.2< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > to_phrase_request< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > ) {< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "null request"< / 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" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = " element-syntax " > req_kind< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2021-04-11 23:41:26 +03:00
< span class = "identifier-syntax" > kind< / span > < span class = "plain-syntax" > **< / span > < span class = "function-syntax" > PhraseRequests::kind_variables_for_request< / span > < button class = "popup" onclick = "togglePopup('usagePopup5')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup5" > Usage of < span class = "code-font" > < span class = "function-syntax" > PhraseRequests::kind_variables_for_request< / span > < / span > :< br / > Compile Imperative Definitions - < a href = "3-cid.html#SP2_2" > § 2.2< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > to_phrase_request< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > ) {< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "null request"< / 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" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > kv_interpretation< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
2021-04-26 01:49:45 +03:00
< p class = "commentary firstcommentary" > < a id = "SP4" class = "paragraph-anchor" > < / a > < b > § 4. < / b > The following agent acts on a pending requests for phrase compilation: see
< a href = "../core-module/1-htc.html" class = "internal" > How To Compile (in core)< / a > .
2021-04-03 16:32:59 +03:00
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
2021-04-26 01:49:45 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > PhraseRequests::compilation_agent< / span > < button class = "popup" onclick = "togglePopup('usagePopup6')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup6" > Usage of < span class = "code-font" > < span class = "function-syntax" > PhraseRequests::compilation_agent< / span > < / span > :< br / > < a href = "3-pr.html#SP2_3" > § 2.3< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > compilation_subtask< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > task< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > to_phrase_request< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > RETRIEVE_POINTER_to_phrase_request< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > task< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > data< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "3-cid.html#SP2" class = "function-link" > < span class = "function-syntax" > CompileImperativeDefn::go< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > compile_from< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "3-cid.html#SP1" class = "function-link" > < span class = "function-syntax" > CompileImperativeDefn::advance_progress_bar< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > compile_from< / span > < span class = "plain-syntax" > ,< / span >
< 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" > req< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > compile_from< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > compilation_data< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > at_least_one_compiled_form_needed< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > }< / span >
< / pre >
< p class = "commentary firstcommentary" > < a id = "SP5" class = "paragraph-anchor" > < / a > < b > § 5. < / b > In Basic Inform, only, execution begins at the "To..." phrase "To begin", and
this is done by compiling a "submain" function which calls the function for
that phrase. This provides a neat example of how to make a phrase request:
< / 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" > PhraseRequests::invoke_to_begin< / 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" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > Task::begin_execution_at_to_begin< / span > < span class = "plain-syntax" > ()) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inter_name< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > iname< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Hierarchy::find< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > SUBMAIN_HL< / span > < span class = "plain-syntax" > );< / span >
2021-04-10 19:55:28 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > packaging_state< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > save< / span > < span class = "plain-syntax" > = < / span > < a href = "3-fnc.html#SP2" class = "function-link" > < span class = "function-syntax" > Functions::begin< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > iname< / span > < span class = "plain-syntax" > );< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > imperative_defn< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > beginner< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > ToPhraseFamily::to_begin< / 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" > beginner< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inter_name< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > begin_fn< / span > < span class = "plain-syntax" > =< / span >
2021-04-10 19:55:28 +03:00
< span class = "plain-syntax" > < / span > < a href = "3-pr.html#SP1" class = "function-link" > < span class = "function-syntax" > PhraseRequests::simple_request< / span > < / a > < span class = "plain-syntax" > (< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > beginner< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > body_of_defn< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Kinds::function_kind< / span > < span class = "plain-syntax" > (0, < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > K_nil< / span > < span class = "plain-syntax" > ));< / span >
2021-04-17 17:28:28 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > EmitCode::call< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > begin_fn< / span > < span class = "plain-syntax" > );< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > }< / span >
2021-04-10 19:55:28 +03:00
< span class = "plain-syntax" > < / span > < a href = "3-fnc.html#SP6" class = "function-link" > < span class = "function-syntax" > Functions::end< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > save< / span > < span class = "plain-syntax" > );< / span >
2021-04-17 17:28:28 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Hierarchy::make_available< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > iname< / span > < span class = "plain-syntax" > );< / span >
2021-04-03 16:32:59 +03:00
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
< nav role = "progress" > < div class = "progresscontainer" >
2021-05-10 11:31:35 +03:00
< ul class = "progressbar" > < li class = "progressprev" > < a href = "3-jl.html" > ❮ < / a > < / li > < li class = "progresschapter" > < a href = "P-wtmd.html" > P< / a > < / li > < li class = "progresschapter" > < a href = "1-im.html" > 1< / a > < / li > < li class = "progresschapter" > < a href = "2-cv.html" > 2< / a > < / li > < li class = "progresscurrentchapter" > 3< / li > < li class = "progresssection" > < a href = "3-sf.html" > sf< / a > < / li > < li class = "progresssection" > < a href = "3-lvs.html" > lvs< / a > < / li > < li class = "progresssection" > < a href = "3-lv.html" > lv< / a > < / li > < li class = "progresssection" > < a href = "3-tv.html" > tv< / a > < / li > < li class = "progresssection" > < a href = "3-lp.html" > lp< / a > < / li > < li class = "progresssection" > < a href = "3-cb.html" > cb< / a > < / li > < li class = "progresssection" > < a href = "3-fnc.html" > fnc< / a > < / li > < li class = "progresssection" > < a href = "3-jl.html" > jl< / a > < / li > < li class = "progresscurrent" > pr< / li > < li class = "progresssection" > < a href = "3-cls.html" > cls< / a > < / li > < li class = "progresssection" > < a href = "3-cid.html" > cid< / a > < / li > < li class = "progresschapter" > < a href = "4-cs.html" > 4< / a > < / li > < li class = "progresschapter" > < a href = "5-cbal.html" > 5< / a > < / li > < li class = "progressnext" > < a href = "3-cls.html" > ❯ < / a > < / li > < / ul > < / div >
2021-04-03 16:32:59 +03:00
< / nav > <!-- End of weave -->
< / main >
< / body >
< / html >