2019-03-17 14:40:57 +02:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
< html >
< head >
2020-04-14 19:56:54 +03:00
< title > Code Generation< / title >
2020-05-03 03:20:55 +03:00
< link href = "../docs-assets/Breadcrumbs.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
2020-03-19 02:11:25 +02:00
< meta name = "viewport" content = "width=device-width initial-scale=1" >
2019-03-17 14:40:57 +02:00
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" >
< meta http-equiv = "Content-Language" content = "en-gb" >
2020-05-03 03:01:21 +03:00
2020-05-03 03:20:55 +03:00
< 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" >
2020-05-03 03:01:21 +03:00
< script >
function togglePopup(material_id) {
var popup = document.getElementById(material_id);
popup.classList.toggle("show");
}
< / script >
2020-05-03 03:20:55 +03:00
< 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" >
2020-04-14 19:56:54 +03:00
2019-03-17 14:40:57 +02:00
< / head >
2020-05-03 03:01:21 +03:00
< body class = "commentary-font" >
2020-03-19 02:11:25 +02:00
< nav role = "navigation" >
2020-04-14 19:56:54 +03:00
< h1 > < a href = "../index.html" >
2020-05-03 18:34:53 +03:00
< img src = "../docs-assets/Inform.png" height = 72" >
2020-04-14 19:56:54 +03:00
< / a > < / h1 >
< ul > < li > < a href = "../compiler.html" > compiler tools< / a > < / li >
2020-03-19 02:11:25 +02:00
< 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 >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Compiler Webs< / h2 > < ul >
2020-03-19 02:11:25 +02:00
< 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 >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Inbuild Modules< / h2 > < ul >
< li > < a href = "../supervisor-module/index.html" > supervisor< / a > < / li >
< / ul > < h2 > Inform7 Modules< / h2 > < ul >
2020-03-19 02:11:25 +02:00
< li > < a href = "../core-module/index.html" > core< / a > < / li >
2020-08-27 17:50:24 +03:00
< li > < a href = "../assertions-module/index.html" > assertions< / 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 >
2020-03-19 02:11:25 +02:00
< 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 >
2020-04-14 19:56:54 +03:00
< / ul > < h2 > Inter Modules< / h2 > < ul >
< li > < a href = "../bytecode-module/index.html" > bytecode< / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../building-module/index.html" > building< / a > < / li >
2021-08-10 13:01:03 +03:00
< li > < a href = "../pipeline-module/index.html" > pipeline< / a > < / li >
< li > < a href = "index.html" > < span class = "selectedlink" > final< / span > < / a > < / li >
2020-05-20 02:02:28 +03:00
< / ul > < h2 > Services< / h2 > < ul >
2020-04-14 19:56:54 +03:00
< li > < a href = "../arch-module/index.html" > arch< / a > < / li >
2020-08-27 17:50:24 +03:00
< li > < a href = "../calculus-module/index.html" > calculus< / a > < / li >
2020-04-14 19:56:54 +03:00
< li > < a href = "../html-module/index.html" > html< / a > < / li >
2020-05-20 02:02:28 +03:00
< li > < a href = "../inflections-module/index.html" > inflections< / a > < / li >
2020-08-27 17:50:24 +03:00
< li > < a href = "../kinds-module/index.html" > kinds< / a > < / li >
2020-05-20 02:02:28 +03:00
< li > < a href = "../linguistics-module/index.html" > linguistics< / a > < / li >
< li > < a href = "../problems-module/index.html" > problems< / a > < / li >
2020-08-27 17:50:24 +03:00
< li > < a href = "../syntax-module/index.html" > syntax< / a > < / li >
< li > < a href = "../words-module/index.html" > words< / a > < / li >
2020-03-19 02:11:25 +02:00
< li > < a href = "../../../inweb/docs/foundation-module/index.html" > foundation< / a > < / li >
2020-04-14 19:56:54 +03:00
< / ul >
2020-03-19 02:11:25 +02:00
< / nav >
< main role = "main" >
2020-05-03 03:01:21 +03:00
<!-- Weave of 'Code Generation' generated by Inweb -->
< div class = "breadcrumbs" >
2021-08-10 13:01:03 +03:00
< ul class = "crumbs" > < li > < a href = "../index.html" > Home< / a > < / li > < li > < a href = "../compiler.html" > Inter Modules< / a > < / li > < li > < a href = "index.html" > final< / a > < / li > < li > < a href = "index.html#2" > Chapter 2: Mechanism< / a > < / li > < li > < b > Code Generation< / b > < / li > < / ul > < / div >
2020-05-03 03:01:21 +03:00
< p class = "purpose" > To generate final code from intermediate code.< / p >
2019-03-17 14:40:57 +02:00
2021-09-25 20:21:49 +03:00
< ul class = "toc" > < li > < a href = "2-cg.html#SP1" > § 1. Pipeline stage< / a > < / li > < li > < a href = "2-cg.html#SP3" > § 3. Ad hoc generation< / a > < / li > < li > < a href = "2-cg.html#SP4" > § 4. Segmentation< / a > < / li > < li > < a href = "2-cg.html#SP12" > § 12. Transients< / a > < / li > < li > < a href = "2-cg.html#SP14" > § 14. Names< / a > < / li > < / ul > < hr class = "tocbar" >
2019-03-17 14:40:57 +02:00
2021-09-22 00:34:09 +03:00
< p class = "commentary firstcommentary" > < a id = "SP1" class = "paragraph-anchor" > < / a > < b > § 1. Pipeline stage. < / b > This whole module exists to provide a single pipeline stage, making the final
generation of code from a tree of fully-linked and generally complete Inter.
< / p >
< p class = "commentary" > It comes in two forms (the optional one writes nothing if no filename is supplied
to it; the compulsory one throws an error in that case), but note that both call
the same function.
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-08-10 13:01:03 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::create_pipeline_stage< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2021-09-24 01:48:56 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CodeGen::Stage::new< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "generate"< / span > < span class = "plain-syntax" > , < / span > < a href = "2-cg.html#SP1" class = "function-link" > < span class = "function-syntax" > CodeGen::run_pipeline_stage< / span > < / a > < span class = "plain-syntax" > ,< / span >
2021-09-22 00:34:09 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > TEXT_OUT_STAGE_ARG< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > );< / span >
2021-09-24 01:48:56 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CodeGen::Stage::new< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "string-syntax" > "optionally-generate"< / span > < span class = "plain-syntax" > , < / span > < a href = "2-cg.html#SP1" class = "function-link" > < span class = "function-syntax" > CodeGen::run_pipeline_stage< / span > < / a > < span class = "plain-syntax" > ,< / span >
2021-09-22 00:34:09 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > OPTIONAL_TEXT_OUT_STAGE_ARG< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::run_pipeline_stage< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pipeline_step< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > step< / span > < span class = "plain-syntax" > ) {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > step< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > generator_argument< / span > < span class = "plain-syntax" > ) {< / span >
2021-09-24 01:48:56 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > = < / span > < a href = "2-cg.html#SP2" class = "function-link" > < span class = "function-syntax" > CodeGen::new_generation< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > step< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > parsed_filename< / span > < span class = "plain-syntax" > ,< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > step< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > to_stream< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > step< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > repository< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > step< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > package_argument< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > step< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > generator_argument< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > step< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > for_VM< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "2-cg2.html#SP4" class = "function-link" > < span class = "function-syntax" > Generators::go< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< 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" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2019-06-11 01:06:40 +03:00
< / pre >
2021-09-24 01:48:56 +03:00
< p class = "commentary firstcommentary" > < a id = "SP2" class = "paragraph-anchor" > < / a > < b > § 2. < / b > A "generation" is a single act of translating inter code into final code.
2021-09-22 19:28:55 +03:00
It will be carried out by the "generator", using the data held in the following
object.
2019-06-27 01:50:30 +03:00
< / p >
2020-05-03 03:01:21 +03:00
< 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" > code_generation< / span > < span class = "plain-syntax" > {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > code_generator< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > generator< / 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" > target_vm< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > for_VM< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > generator_private_data< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > depending on the target generated to< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > filename< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > to_file< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > filename of output, and/or...< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > to_stream< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > stream for textual output< / span >
2021-09-22 00:34:09 +03:00
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inter_tree< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > 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" > inter_package< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > just_this_package< / span > < span class = "plain-syntax" > ;< / span >
2021-09-22 00:34:09 +03:00
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > segmentation_data< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > segmentation< / span > < span class = "plain-syntax" > ;< / span >
2021-09-24 01:48:56 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > void_level< / span > < span class = "plain-syntax" > ;< / span >
2021-09-25 20:21:49 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > literal_text_mode< / 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" > linked_list< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > global_variables< / span > < span class = "plain-syntax" > ;< / span >
2020-05-09 15:07:39 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CLASS_DEFINITION< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > } < / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > ;< / span >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > CodeGen::new_generation< / 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" > CodeGen::new_generation< / span > < / span > :< br / > < a href = "2-cg.html#SP1" > § 1< / a > , < a href = "2-cg.html#SP3" > § 3< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > filename< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > F< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > T< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > inter_tree< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > ,< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inter_package< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > just< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > code_generator< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > generator< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > target_vm< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > VM< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > CREATE< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > );< / span >
2021-09-22 00:34:09 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > to_file< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > F< / span > < span class = "plain-syntax" > ;< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > to_stream< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > T< / 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" > VM< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) & & (< / span > < span class = "identifier-syntax" > generator< / 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" > "no way to determine format"< / 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" > VM< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > VM< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > TargetVMs::find< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > generator< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > generator_name< / span > < span class = "plain-syntax" > );< / span >
2021-09-22 00:34:09 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > for_VM< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > VM< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > from< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > ;< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > generator< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > generator< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > just< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > just_this_package< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > just< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > else< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > just_this_package< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Site::main_package< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > );< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > = < / span > < a href = "2-cg.html#SP5" class = "function-link" > < span class = "function-syntax" > CodeGen::new_segmentation_data< / span > < / a > < span class = "plain-syntax" > ();< / span >
2021-09-24 01:48:56 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > void_level< / span > < span class = "plain-syntax" > = -1;< / span >
2021-09-25 20:21:49 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > literal_text_mode< / 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" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > global_variables< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NEW_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inter_symbol< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2019-06-29 15:17:29 +03:00
< / pre >
2021-09-25 20:21:49 +03:00
< ul class = "endnotetexts" > < li > The structure code_generation is accessed in 2/cg2, 2/tvg, 2/vc, 2/vo, 2/vc2, 3/fti, 3/fbi, 3/fi, 4/fi6, 5/fnc, 5/cnm, 5/cmm, 5/cpc, 5/ccn, 5/com, 5/cfm, 5/clt and here.< / li > < / ul >
2021-09-24 01:48:56 +03:00
< p class = "commentary firstcommentary" > < a id = "SP3" class = "paragraph-anchor" > < / a > < b > § 3. Ad hoc generation. < / b > This module would be more elegant if the following function did not exist. But
it is a consequence of the < span class = "extract" > < span class = "extract-syntax" > (+< / span > < / span > ... < span class = "extract" > < span class = "extract-syntax" > +)< / span > < / span > feature of Inform, which plunges
right through all kinds of conceptual barriers better left unplunged-through.
Happily, it's both limited and little-used. The task is to turn a single Inter
value-pair into the text of an expression which will represent it at run-time.
< / p >
< p class = "commentary" > This is called by Inform 7 during a drastically earlier phase of compilation,
long before the < a href = "index.html" class = "internal" > final< / a > module would otherwise be involved, and there's no
question of performing a full generation of an entire Inter tree. So we make
a sort of mock-generation object, the < span class = "extract" > < span class = "extract-syntax" > ad_hoc_generation< / span > < / span > , just for the purpose
of this function call. We could make a new mock object every time, because there
aren't such a lot of calls to this function, but instead we make just one and
re-use it.
< / p >
< p class = "commentary" > The mock generator makes no use of segmentation (see below) except for the
single temporary segement, which is set to < span class = "extract" > < span class = "extract-syntax" > OUT< / span > < / span > .
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > ad_hoc_generation< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::val_to_text< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUTPUT_STREAM< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > inter_bookmark< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > IBM< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inter_ti< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > val1< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > inter_ti< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > val2< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > target_vm< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > VM< / 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" > ad_hoc_generation< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / 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" > VM< / 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" > "no VM given"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > code_generator< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > generator< / span > < span class = "plain-syntax" > = < / span > < a href = "2-cg2.html#SP2" class = "function-link" > < span class = "function-syntax" > Generators::find_for< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > VM< / 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" > generator< / 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" > "VM family with no generator"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ad_hoc_generation< / span > < span class = "plain-syntax" > =< / span >
< span class = "plain-syntax" > < / span > < a href = "2-cg.html#SP2" class = "function-link" > < span class = "function-syntax" > CodeGen::new_generation< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > Inter::Bookmarks::tree< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > IBM< / span > < span class = "plain-syntax" > ), < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > generator< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > VM< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > code_generator< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > generator< / span > < span class = "plain-syntax" > = < / span > < a href = "2-cg2.html#SP2" class = "function-link" > < span class = "function-syntax" > Generators::find_for< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > VM< / 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" > generator< / 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" > "VM family with no generator"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ad_hoc_generation< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > for_VM< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > VM< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ad_hoc_generation< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > generator< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > generator< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < a href = "2-cg.html#SP9" class = "function-link" > < span class = "function-syntax" > CodeGen::select_temporary< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > ad_hoc_generation< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > OUT< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "2-vc.html#SP2" class = "function-link" > < span class = "function-syntax" > VanillaConstants::val_to_text< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > ad_hoc_generation< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > IBM< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > val1< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > val2< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < a href = "2-cg.html#SP9" class = "function-link" > < span class = "function-syntax" > CodeGen::deselect_temporary< / span > < / a > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > ad_hoc_generation< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
2021-09-22 19:28:55 +03:00
< p class = "commentary firstcommentary" > < a id = "SP4" class = "paragraph-anchor" > < / a > < b > § 4. Segmentation. < / b > Generators have flexibility in how they go about their business, but if they are
making what amounts to a text file with a lot of internal structure then the
following system may be a convenience. It allows text to be assembled as a set
of "segments" which can be appended to in any order, and which are then put
together in a logical order at the end.
< / p >
< p class = "commentary" > Segments are identified by ID numbers counting up from 0, 1, 2, ...: one of
them, numbered 0, is the special "temporary" segment. This is used only as a
stash for text not going into the final output but needed for some intermediate
calculations. Sgements are, at present, just wrappers for tect streams, but one
could imagine them becoming more elaborate.
2019-06-29 15:17:29 +03:00
< / p >
2021-09-22 19:28:55 +03:00
< pre class = "definitions code-font" > < span class = "definition-keyword" > enum< / span > < span class = "constant-syntax" > temporary_I7CGS< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > from< / span > < span class = "plain-syntax" > < / span > < span class = "constant-syntax" > 0< / span >
< / pre >
2020-05-03 03:01:21 +03:00
< 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" > generated_segment< / 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" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > generated_code< / span > < span class = "plain-syntax" > ;< / span >
2020-05-09 15:07:39 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > CLASS_DEFINITION< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > } < / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > ;< / span >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > CodeGen::new_segment< / 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" > CodeGen::new_segment< / span > < / span > :< br / > < a href = "2-cg.html#SP6" > § 6< / a > , < a href = "2-cg.html#SP7" > § 7< / a > , < a href = "2-cg.html#SP9" > § 9< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > seg< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > CREATE< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > seg< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > generated_code< / 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 = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > seg< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2021-09-22 19:28:55 +03:00
< / pre >
< ul class = "endnotetexts" > < li > The structure generated_segment is private to this section.< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP5" class = "paragraph-anchor" > < / a > < b > § 5. < / b > Each generation has its own copy of every possible numbered segment, though
by default those are < span class = "extract" > < span class = "extract-syntax" > NULL< / span > < / span > .
< / p >
2021-08-12 01:49:36 +03:00
2021-09-22 19:28:55 +03:00
< 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" > segmentation_data< / span > < span class = "plain-syntax" > {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > segments< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > NO_DEFINED_I7CGS_VALUES< / 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" > linked_list< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > segment_sequence< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > of < / span > < span class = "extract" > < span class = "extract-syntax" > generated_segment< / span > < / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > linked_list< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > additional_segment_sequence< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > of < / span > < span class = "extract" > < span class = "extract-syntax" > generated_segment< / span > < / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > temporarily_diverted< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > to the temporary segment< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > struct< / span > < span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > current_segment< / span > < span class = "plain-syntax" > ; < / span > < span class = "comment-syntax" > the one currently being written to< / span >
< span class = "plain-syntax" > } < / span > < span class = "reserved-syntax" > segmentation_data< / span > < span class = "plain-syntax" > ;< / span >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > segmentation_data< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::new_segmentation_data< / 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" > CodeGen::new_segmentation_data< / span > < / span > :< br / > < a href = "2-cg.html#SP2" > § 2< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > ) {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > segmentation_data< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > sd< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > sd< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > current_segment< / 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" > sd< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segment_sequence< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NEW_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > sd< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > additional_segment_sequence< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NEW_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > sd< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > temporarily_diverted< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
< 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" > i< / span > < span class = "plain-syntax" > < < / span > < span class = "identifier-syntax" > NO_DEFINED_I7CGS_VALUES< / span > < span class = "plain-syntax" > ; < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ++) < / span > < span class = "identifier-syntax" > sd< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segments< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ] = < / span > < span class = "identifier-syntax" > NULL< / 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" > sd< / span > < span class = "plain-syntax" > ;< / span >
2021-08-12 01:49:36 +03:00
< span class = "plain-syntax" > }< / span >
2021-09-22 19:28:55 +03:00
< / pre >
< ul class = "endnotetexts" > < li > The structure segmentation_data is private to this section.< / li > < / ul >
< p class = "commentary firstcommentary" > < a id = "SP6" class = "paragraph-anchor" > < / a > < b > § 6. < / b > If a generator wants to use this system, it should call < a href = "2-cg.html#SP6" class = "internal" > CodeGen::create_segments< / a >
to say which segments it wants to be created, passing an array of ID numbers. The
order of these is significant — it's the order in which they will appear in the final
output.
< / p >
2021-09-18 20:54:26 +03:00
2021-09-22 19:28:55 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::create_segments< / 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" > CodeGen::create_segments< / span > < / span > :< br / > Generating Inform 6 - < a href = "4-fi6.html#SP3" > § 3< / a > < br / > Final C - < a href = "5-fnc.html#SP5" > § 5< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > data< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > codes< / span > < span class = "plain-syntax" > []) {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segment_sequence< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NEW_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > );< / span >
2021-09-18 20:54:26 +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" > codes< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ] > = < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ; < / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ++) {< / span >
2021-09-22 00:34:09 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > codes< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ] > = < / span > < span class = "identifier-syntax" > NO_DEFINED_I7CGS_VALUES< / span > < span class = "plain-syntax" > ) ||< / span >
2021-09-18 20:54:26 +03:00
< span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > codes< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ] == < / span > < span class = "constant-syntax" > temporary_I7CGS< / span > < span class = "plain-syntax" > )) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "bad segment sequence"< / span > < span class = "plain-syntax" > );< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segments< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > codes< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ]] = < / span > < a href = "2-cg.html#SP4" class = "function-link" > < span class = "function-syntax" > CodeGen::new_segment< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ADD_TO_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segments< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > codes< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ]], < / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segment_sequence< / span > < span class = "plain-syntax" > );< / span >
2021-09-18 20:54:26 +03:00
< span class = "plain-syntax" > }< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > generator_private_data< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > data< / span > < span class = "plain-syntax" > ;< / span >
2021-09-18 20:54:26 +03:00
< span class = "plain-syntax" > }< / span >
2019-06-27 01:50:30 +03:00
< / pre >
2021-09-22 19:28:55 +03:00
< p class = "commentary firstcommentary" > < a id = "SP7" class = "paragraph-anchor" > < / a > < b > § 7. < / b > An optional "alternative" set can also be created.
2019-06-29 15:17:29 +03:00
< / p >
2019-06-27 01:50:30 +03:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::additional_segments< / 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" > CodeGen::additional_segments< / span > < / span > :< br / > Final C - < a href = "5-fnc.html#SP5" > § 5< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > codes< / span > < span class = "plain-syntax" > []) {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > additional_segment_sequence< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NEW_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > );< / span >
< 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" > codes< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ] > = < / span > < span class = "constant-syntax" > 0< / 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" > codes< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ] > = < / span > < span class = "identifier-syntax" > NO_DEFINED_I7CGS_VALUES< / span > < span class = "plain-syntax" > ) ||< / span >
< span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > codes< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ] == < / span > < span class = "constant-syntax" > temporary_I7CGS< / span > < span class = "plain-syntax" > )) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "bad segment sequence"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segments< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > codes< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ]] = < / span > < a href = "2-cg.html#SP4" class = "function-link" > < span class = "function-syntax" > CodeGen::new_segment< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > ADD_TO_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segments< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > codes< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ]], < / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > ,< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > additional_segment_sequence< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
2019-06-29 15:17:29 +03:00
< / pre >
2021-09-22 19:28:55 +03:00
< p class = "commentary firstcommentary" > < a id = "SP8" class = "paragraph-anchor" > < / a > < b > § 8. < / b > At any given time, a generation has a "current" segment, to which output is
being written. The generator should use < a href = "2-cg.html#SP8" class = "internal" > CodeGen::select< / a > to switch to a given
segment, which must be one of those it has created, and then use < a href = "2-cg.html#SP8" class = "internal" > CodeGen::deselect< / a >
to go back to where it was. These calls must be made in properly nested pairs.
2019-06-29 15:17:29 +03:00
< / p >
2019-03-17 14:40:57 +02:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-09-25 20:21:49 +03:00
< span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > CodeGen::select< / 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" > CodeGen::select< / span > < / span > :< br / > The Vanilla Generator - < a href = "2-tvg.html#SP1_7" > § 1.7< / a > , < a href = "2-tvg.html#SP1_9" > § 1.9< / a > < br / > Vanilla Constants - < a href = "2-vc.html#SP2" > § 2< / a > < br / > Vanilla Objects - < a href = "2-vo.html#SP1" > § 1< / a > , < a href = "2-vo.html#SP4_5" > § 4.5< / a > , < a href = "2-vo.html#SP4_6" > § 4.6< / a > , < a href = "2-vo.html#SP5" > § 5< / a > , < a href = "2-vo.html#SP6" > § 6< / a > < br / > Generating Inform 6 - < a href = "4-fi6.html#SP3" > § 3< / a > , < a href = "4-fi6.html#SP7" > § 7< / a > , < a href = "4-fi6.html#SP8" > § 8< / a > , < a href = "4-fi6.html#SP10" > § 10< / a > < br / > Final C - < a href = "5-fnc.html#SP5" > § 5< / a > < br / > C Global Variables - < a href = "5-cgv.html#SP1" > § 1< / a > , < a href = "5-cgv.html#SP2" > § 2< / a > < br / > C Memory Model - < a href = "5-cmm.html#SP3" > § 3< / a > , < a href = "5-cmm.html#SP4" > § 4< / a > , < a href = "5-cmm.html#SP10_2" > § 10.2< / a > , < a href = "5-cmm.html#SP11" > § 11< / a > , < a href = "5-cmm.html#SP14" > § 14< / a > < br / > C Object Model - < a href = "5-com.html#SP1_3" > § 1.3< / a > , < a href = "5-com.html#SP4" > § 4< / a > , < a href = "5-com.html#SP7" > § 7< / a > , < a href = "5-com.html#SP8" > § 8< / a > , < a href = "5-com.html#SP1_4" > § 1.4< / a > , < a href = "5-com.html#SP1_5" > § 1.5< / a > , < a href = "5-com.html#SP1_6" > § 1.6< / a > , < a href = "5-com.html#SP10" > § 10< / a > < br / > C Function Model - < a href = "5-cfm.html#SP1" > § 1< / a > < br / > C Literals - < a href = "5-clt.html#SP1" > § 1< / a > , < a href = "5-clt.html#SP2" > § 2< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > gen< / 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" > ) {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > saved< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > current_segment< / span > < span class = "plain-syntax" > ;< / span >
2021-09-22 00:34:09 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > < < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ) || (< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > > = < / span > < span class = "identifier-syntax" > NO_DEFINED_I7CGS_VALUES< / span > < span class = "plain-syntax" > )) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "out of range"< / span > < span class = "plain-syntax" > );< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > temporarily_diverted< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "poorly timed selection"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > current_segment< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segments< / 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" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > current_segment< / 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" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "generator does not use this segment ID"< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > saved< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2021-09-25 20:21:49 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::deselect< / span > < button class = "popup" onclick = "togglePopup('usagePopup7')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup7" > Usage of < span class = "code-font" > < span class = "function-syntax" > CodeGen::deselect< / span > < / span > :< br / > The Vanilla Generator - < a href = "2-tvg.html#SP1_7" > § 1.7< / a > , < a href = "2-tvg.html#SP1_9" > § 1.9< / a > < br / > Vanilla Constants - < a href = "2-vc.html#SP2" > § 2< / a > < br / > Vanilla Objects - < a href = "2-vo.html#SP1" > § 1< / a > , < a href = "2-vo.html#SP4_5" > § 4.5< / a > , < a href = "2-vo.html#SP4_6" > § 4.6< / a > , < a href = "2-vo.html#SP5" > § 5< / a > , < a href = "2-vo.html#SP6" > § 6< / a > < br / > Generating Inform 6 - < a href = "4-fi6.html#SP3" > § 3< / a > , < a href = "4-fi6.html#SP7" > § 7< / a > , < a href = "4-fi6.html#SP8" > § 8< / a > , < a href = "4-fi6.html#SP10" > § 10< / a > < br / > Final C - < a href = "5-fnc.html#SP5" > § 5< / a > < br / > C Global Variables - < a href = "5-cgv.html#SP1" > § 1< / a > , < a href = "5-cgv.html#SP2" > § 2< / a > < br / > C Memory Model - < a href = "5-cmm.html#SP3" > § 3< / a > , < a href = "5-cmm.html#SP4" > § 4< / a > , < a href = "5-cmm.html#SP10_2" > § 10.2< / a > , < a href = "5-cmm.html#SP11" > § 11< / a > , < a href = "5-cmm.html#SP14" > § 14< / a > < br / > C Object Model - < a href = "5-com.html#SP1_3" > § 1.3< / a > , < a href = "5-com.html#SP4" > § 4< / a > , < a href = "5-com.html#SP7" > § 7< / a > , < a href = "5-com.html#SP8" > § 8< / a > , < a href = "5-com.html#SP1_4" > § 1.4< / a > , < a href = "5-com.html#SP1_5" > § 1.5< / a > , < a href = "5-com.html#SP1_6" > § 1.6< / a > , < a href = "5-com.html#SP10" > § 10< / a > < br / > C Function Model - < a href = "5-cfm.html#SP1" > § 1< / a > < br / > C Literals - < a href = "5-clt.html#SP1" > § 1< / a > , < a href = "5-clt.html#SP2" > § 2< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > saved< / span > < span class = "plain-syntax" > ) {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > temporarily_diverted< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "poorly timed deselection"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > current_segment< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > saved< / span > < span class = "plain-syntax" > ;< / span >
2021-09-18 20:54:26 +03:00
< span class = "plain-syntax" > }< / span >
2019-06-29 15:17:29 +03:00
< / pre >
2021-09-22 19:28:55 +03:00
< p class = "commentary firstcommentary" > < a id = "SP9" class = "paragraph-anchor" > < / a > < b > § 9. < / b > However, we can also temporarily divert the whole system to send its text to
some temporary stream somewhere. For that, use the following pair:
2019-06-29 15:17:29 +03:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::select_temporary< / span > < button class = "popup" onclick = "togglePopup('usagePopup8')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup8" > Usage of < span class = "code-font" > < span class = "function-syntax" > CodeGen::select_temporary< / span > < / span > :< br / > < a href = "2-cg.html#SP3" > § 3< / a > < br / > Vanilla Constants - < a href = "2-vc.html#SP1" > § 1< / a > , < a href = "2-vc.html#SP2" > § 2< / a > < br / > Vanilla Objects - < a href = "2-vo.html#SP5_8_5_1_1" > § 5.8.5.1.1< / a > , < a href = "2-vo.html#SP5_11_1" > § 5.11.1< / a > , < a href = "2-vo.html#SP8" > § 8< / a > < br / > C Global Variables - < a href = "5-cgv.html#SP2" > § 2< / a > < br / > C Assembly - < a href = "5-cas.html#SP3" > § 3< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > T< / span > < span class = "plain-syntax" > ) {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segments< / span > < span class = "plain-syntax" > [< / span > < span class = "constant-syntax" > temporary_I7CGS< / 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" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segments< / span > < span class = "plain-syntax" > [< / span > < span class = "constant-syntax" > temporary_I7CGS< / span > < span class = "plain-syntax" > ] = < / span > < a href = "2-cg.html#SP4" class = "function-link" > < span class = "function-syntax" > CodeGen::new_segment< / span > < / a > < span class = "plain-syntax" > ();< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segments< / span > < span class = "plain-syntax" > [< / span > < span class = "constant-syntax" > temporary_I7CGS< / span > < span class = "plain-syntax" > ]-> < / span > < span class = "element-syntax" > generated_code< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > temporarily_diverted< / span > < span class = "plain-syntax" > ) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "nested temporary segments"< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > temporarily_diverted< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > TRUE< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segments< / span > < span class = "plain-syntax" > [< / span > < span class = "constant-syntax" > temporary_I7CGS< / span > < span class = "plain-syntax" > ]-> < / span > < span class = "element-syntax" > generated_code< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > T< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::deselect_temporary< / span > < button class = "popup" onclick = "togglePopup('usagePopup9')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup9" > Usage of < span class = "code-font" > < span class = "function-syntax" > CodeGen::deselect_temporary< / span > < / span > :< br / > < a href = "2-cg.html#SP3" > § 3< / a > < br / > Vanilla Constants - < a href = "2-vc.html#SP1" > § 1< / a > , < a href = "2-vc.html#SP2" > § 2< / a > < br / > Vanilla Objects - < a href = "2-vo.html#SP5_8_5_1_1" > § 5.8.5.1.1< / a > , < a href = "2-vo.html#SP5_11_1" > § 5.11.1< / a > , < a href = "2-vo.html#SP8" > § 8< / a > < br / > C Global Variables - < a href = "5-cgv.html#SP2" > § 2< / a > < br / > C Assembly - < a href = "5-cas.html#SP3" > § 3< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > ) {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > temporarily_diverted< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > FALSE< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
2019-06-29 15:17:29 +03:00
< / pre >
2021-09-22 19:28:55 +03:00
< p class = "commentary firstcommentary" > < a id = "SP10" class = "paragraph-anchor" > < / a > < b > § 10. < / b > The following returns the text stream a generator should write to. Note that
if it has been "temporarily diverted" then the regiular selection is ignored.
2019-06-29 15:17:29 +03:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-09-25 20:21:49 +03:00
< span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > CodeGen::current< / span > < button class = "popup" onclick = "togglePopup('usagePopup10')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup10" > Usage of < span class = "code-font" > < span class = "function-syntax" > CodeGen::current< / span > < / span > :< br / > The Vanilla Generator - < a href = "2-tvg.html#SP3" > § 3< / a > < br / > Vanilla Constants - < a href = "2-vc.html#SP2" > § 2< / a > < br / > Vanilla Objects - < a href = "2-vo.html#SP4_6" > § 4.6< / a > , < a href = "2-vo.html#SP5" > § 5< / a > , < a href = "2-vo.html#SP6" > § 6< / a > , < a href = "2-vo.html#SP8" > § 8< / a > < br / > Generating Inform 6 - < a href = "4-fi6.html#SP3" > § 3< / a > , < a href = "4-fi6.html#SP4" > § 4< / a > , < a href = "4-fi6.html#SP5" > § 5< / a > , < a href = "4-fi6.html#SP6" > § 6< / a > , < a href = "4-fi6.html#SP7" > § 7< / a > , < a href = "4-fi6.html#SP8" > § 8< / a > , < a href = "4-fi6.html#SP9" > § 9< / a > , < a href = "4-fi6.html#SP10" > § 10< / a > < br / > Final C - < a href = "5-fnc.html#SP5" > § 5< / a > < br / > C Namespace - < a href = "5-cnm.html#SP3" > § 3< / a > < br / > C References - < a href = "5-crf.html#SP4" > § 4< / a > < br / > C Global Variables - < a href = "5-cgv.html#SP1" > § 1< / a > , < a href = "5-cgv.html#SP2" > § 2< / a > < br / > C Memory Model - < a href = "5-cmm.html#SP3" > § 3< / a > , < a href = "5-cmm.html#SP4" > § 4< / a > , < a href = "5-cmm.html#SP10_2" > § 10.2< / a > , < a href = "5-cmm.html#SP11" > § 11< / a > , < a href = "5-cmm.html#SP12" > § 12< / a > , < a href = "5-cmm.html#SP14" > § 14< / a > , < a href = "5-cmm.html#SP15" > § 15< / a > < br / > C Assembly - < a href = "5-cas.html#SP3" > § 3< / a > < br / > C Program Control - < a href = "5-cpc.html#SP1" > § 1< / a > , < a href = "5-cpc.html#SP2" > § 2< / a > < br / > C Arithmetic - < a href = "5-car.html#SP1" > § 1< / a > < br / > C Conditions - < a href = "5-ccn.html#SP1" > § 1< / a > , < a href = "5-ccn.html#SP2" > § 2< / a > < br / > C Object Model - < a href = "5-com.html#SP1_3" > § 1.3< / a > , < a href = "5-com.html#SP4" > § 4< / a > , < a href = "5-com.html#SP7" > § 7< / a > , < a href = "5-com.html#SP8" > § 8< / a > , < a href = "5-com.html#SP1_4" > § 1.4< / a > , < a href = "5-com.html#SP1_5" > § 1.5< / a > , < a href = "5-com.html#SP1_6" > § 1.6< / a > , < a href = "5-com.html#SP10" > § 10< / a > , < a href = "5-com.html#SP11" > § 11< / a > < br / > C Function Model - < a href = "5-cfm.html#SP1" > § 1< / a > < br / > C Literals - < a href = "5-clt.html#SP1" > § 1< / a > , < a href = "5-clt.html#SP2" > § 2< / a > , < a href = "5-clt.html#SP4" > § 4< / a > , < a href = "5-clt.html#SP5" > § 5< / a > < br / > C Input-Output Model - < a href = "5-cim.html#SP2" > § 2< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > ) {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > temporarily_diverted< / 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" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "identifier-syntax" > segments< / span > < span class = "plain-syntax" > [< / span > < span class = "constant-syntax" > temporary_I7CGS< / span > < span class = "plain-syntax" > ]-> < / span > < span class = "element-syntax" > generated_code< / 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" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > current_segment< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > NULL< / 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" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > current_segment< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > generated_code< / span > < span class = "plain-syntax" > ;< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
2019-06-29 15:17:29 +03:00
< / pre >
2021-09-22 19:28:55 +03:00
< p class = "commentary firstcommentary" > < a id = "SP11" class = "paragraph-anchor" > < / a > < b > § 11. < / b > And then all we do is concatenate them in order:
2019-06-29 15:17:29 +03:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::write_segments< / span > < button class = "popup" onclick = "togglePopup('usagePopup11')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup11" > Usage of < span class = "code-font" > < span class = "function-syntax" > CodeGen::write_segments< / span > < / span > :< br / > Code Generators - < a href = "2-cg2.html#SP4" > § 4< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUTPUT_STREAM< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > ) {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > seg< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > seg< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segment_sequence< / 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" > "%S"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > seg< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > generated_code< / span > < span class = "plain-syntax" > );< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
2019-06-29 15:17:29 +03:00
2021-09-22 19:28:55 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::write_additional_segments< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > OUTPUT_STREAM< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > seg< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > LOOP_OVER_LINKED_LIST< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > seg< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > generated_segment< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > additional_segment_sequence< / 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" > "%S"< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > seg< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > generated_code< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2021-09-24 01:48:56 +03:00
< span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > CodeGen::content< / span > < button class = "popup" onclick = "togglePopup('usagePopup12')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup12" > Usage of < span class = "code-font" > < span class = "function-syntax" > CodeGen::content< / span > < / span > :< br / > Final C - < a href = "5-fnc.html#SP5" > § 5< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "reserved-syntax" > code_generation< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > gen< / 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" > ) {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > if< / span > < span class = "plain-syntax" > ((< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > < < / span > < span class = "constant-syntax" > 0< / span > < span class = "plain-syntax" > ) || (< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > > = < / span > < span class = "identifier-syntax" > NO_DEFINED_I7CGS_VALUES< / span > < span class = "plain-syntax" > )) < / span > < span class = "identifier-syntax" > internal_error< / span > < span class = "plain-syntax" > (< / span > < span class = "string-syntax" > "out of range"< / 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" > gen< / span > < span class = "plain-syntax" > -> < / span > < span class = "element-syntax" > segmentation< / span > < span class = "plain-syntax" > .< / span > < span class = "element-syntax" > segments< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ]-> < / span > < span class = "element-syntax" > generated_code< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
2019-06-29 15:17:29 +03:00
< / pre >
2021-09-22 19:28:55 +03:00
< p class = "commentary firstcommentary" > < a id = "SP12" class = "paragraph-anchor" > < / a > < b > § 12. Transients. < / b > One other optional service for the use of generators:
2020-05-03 03:01:21 +03:00
< / p >
2019-06-29 15:17:29 +03:00
2021-09-22 19:28:55 +03:00
< p class = "commentary" > Transient flags on symbols are used temporarily during code generation, but do
not change the meaning of the tree: they're just a way to keep track of, say,
what we've worked on so far.
2020-05-03 03:01:21 +03:00
< / p >
2019-06-29 15:17:29 +03:00
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::clear_all_transients< / span > < button class = "popup" onclick = "togglePopup('usagePopup13')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup13" > Usage of < span class = "code-font" > < span class = "function-syntax" > CodeGen::clear_all_transients< / span > < / span > :< br / > Code Generators - < a href = "2-cg2.html#SP4" > § 4< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inter_tree< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > ) {< / span >
2021-09-22 19:28:55 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > InterTree::traverse< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > , < / span > < a href = "2-cg.html#SP12" class = "function-link" > < span class = "function-syntax" > CodeGen::clear_transients< / span > < / a > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > PACKAGE_IST< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2020-05-03 03:01:21 +03:00
2021-09-22 19:28:55 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::clear_transients< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inter_tree< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > I< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > inter_tree_node< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > P< / span > < span class = "plain-syntax" > , < / span > < span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > state< / span > < span class = "plain-syntax" > ) {< / span >
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > inter_package< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > pack< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Inter::Package::defined_by_frame< / 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" > inter_symbols_table< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > T< / span > < span class = "plain-syntax" > = < / span > < span class = "identifier-syntax" > Inter::Packages::scope< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > pack< / span > < span class = "plain-syntax" > );< / span >
< 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" > i< / span > < span class = "function-syntax" > < T-> < / span > < span class = "identifier-syntax" > size< / 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" > T< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > symbol_array< / 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" > Inter::Symbols::clear_transient_flags< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > T< / span > < span class = "plain-syntax" > -> < / span > < span class = "identifier-syntax" > symbol_array< / span > < span class = "plain-syntax" > [< / span > < span class = "identifier-syntax" > i< / span > < span class = "plain-syntax" > ]);< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > }< / span >
2019-06-30 13:38:16 +03:00
< / pre >
2021-09-22 19:28:55 +03:00
< p class = "commentary firstcommentary" > < a id = "SP13" class = "paragraph-anchor" > < / a > < b > § 13. < / b > In particular the < span class = "extract" > < span class = "extract-syntax" > TRAVERSE_MARK_BIT< / span > < / span > flag is sometimes convenient to use.
2019-06-29 15:17:29 +03:00
< / p >
2020-05-03 03:01:21 +03:00
< pre class = "displayed-code all-displayed-code code-font" >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > int< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::marked< / span > < button class = "popup" onclick = "togglePopup('usagePopup14')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup14" > Usage of < span class = "code-font" > < span class = "function-syntax" > CodeGen::marked< / span > < / span > :< br / > Vanilla Objects - < a href = "2-vo.html#SP5_8_4" > § 5.8.4< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inter_symbol< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > symb_name< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Inter::Symbols::get_flag< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > symb_name< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > TRAVERSE_MARK_BIT< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::mark< / span > < button class = "popup" onclick = "togglePopup('usagePopup15')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup15" > Usage of < span class = "code-font" > < span class = "function-syntax" > CodeGen::mark< / span > < / span > :< br / > Vanilla Objects - < a href = "2-vo.html#SP5_8_4" > § 5.8.4< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inter_symbol< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > symb_name< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Inter::Symbols::set_flag< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > symb_name< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > TRAVERSE_MARK_BIT< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2021-09-24 01:48:56 +03:00
< span class = "reserved-syntax" > void< / span > < span class = "plain-syntax" > < / span > < span class = "function-syntax" > CodeGen::unmark< / span > < button class = "popup" onclick = "togglePopup('usagePopup16')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup16" > Usage of < span class = "code-font" > < span class = "function-syntax" > CodeGen::unmark< / span > < / span > :< br / > Vanilla Objects - < a href = "2-vo.html#SP5_8" > § 5.8< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inter_symbol< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > symb_name< / span > < span class = "plain-syntax" > ) {< / span >
2020-05-03 03:01:21 +03:00
< span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Inter::Symbols::clear_flag< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > symb_name< / span > < span class = "plain-syntax" > , < / span > < span class = "identifier-syntax" > TRAVERSE_MARK_BIT< / span > < span class = "plain-syntax" > );< / span >
< span class = "plain-syntax" > }< / span >
2019-03-17 14:40:57 +02:00
< / pre >
2021-09-25 20:21:49 +03:00
< p class = "commentary firstcommentary" > < a id = "SP14" class = "paragraph-anchor" > < / a > < b > § 14. Names. < / b > Finally, this function is frequently needed:
< / p >
< pre class = "displayed-code all-displayed-code code-font" >
< span class = "identifier-syntax" > text_stream< / span > < span class = "plain-syntax" > *< / span > < span class = "function-syntax" > CodeGen::name< / span > < button class = "popup" onclick = "togglePopup('usagePopup17')" > < span class = "comment-syntax" > ?< / span > < span class = "popuptext" id = "usagePopup17" > Usage of < span class = "code-font" > < span class = "function-syntax" > CodeGen::name< / span > < / span > :< br / > The Vanilla Generator - < a href = "2-tvg.html#SP3" > § 3< / a > < br / > Vanilla Constants - < a href = "2-vc.html#SP2" > § 2< / a > < br / > Vanilla Objects - < a href = "2-vo.html#SP1" > § 1< / a > , < a href = "2-vo.html#SP4_5" > § 4.5< / a > , < a href = "2-vo.html#SP4_6" > § 4.6< / a > , < a href = "2-vo.html#SP5_5" > § 5.5< / a > , < a href = "2-vo.html#SP5_7" > § 5.7< / a > , < a href = "2-vo.html#SP5_8_4" > § 5.8.4< / a > , < a href = "2-vo.html#SP5_9" > § 5.9< / a > , < a href = "2-vo.html#SP5_11" > § 5.11< / a > , < a href = "2-vo.html#SP5_11_2" > § 5.11.2< / a > , < a href = "2-vo.html#SP5_11_2_1" > § 5.11.2.1< / a > , < a href = "2-vo.html#SP5_11_2_2" > § 5.11.2.2< / a > , < a href = "2-vo.html#SP6" > § 6< / a > , < a href = "2-vo.html#SP8" > § 8< / a > < br / > Vanilla Code - < a href = "2-vc2.html#SP4" > § 4< / a > < br / > Generating Inform 6 - < a href = "4-fi6.html#SP7" > § 7< / a > , < a href = "4-fi6.html#SP8" > § 8< / a > , < a href = "4-fi6.html#SP9" > § 9< / a > < br / > Final C - < a href = "5-fnc.html#SP5" > § 5< / a > < br / > C Global Variables - < a href = "5-cgv.html#SP2" > § 2< / a > < br / > C Memory Model - < a href = "5-cmm.html#SP12" > § 12< / a > < br / > C Object Model - < a href = "5-com.html#SP6" > § 6< / a > < br / > C Function Model - < a href = "5-cfm.html#SP1" > § 1< / a > < br / > C Literals - < a href = "5-clt.html#SP2" > § 2< / a > < / span > < / button > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > inter_symbol< / span > < span class = "plain-syntax" > *< / span > < span class = "identifier-syntax" > symb< / 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" > symb< / span > < span class = "plain-syntax" > == < / span > < span class = "identifier-syntax" > NULL< / span > < span class = "plain-syntax" > ) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > NULL< / 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" > Inter::Symbols::get_translate< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > symb< / span > < span class = "plain-syntax" > )) < / span > < span class = "reserved-syntax" > return< / span > < span class = "plain-syntax" > < / span > < span class = "identifier-syntax" > Inter::Symbols::get_translate< / span > < span class = "plain-syntax" > (< / span > < span class = "identifier-syntax" > symb< / 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 > < span class = "identifier-syntax" > symbol_name< / span > < span class = "plain-syntax" > ;< / span >
< span class = "plain-syntax" > }< / span >
< / pre >
2020-05-03 03:01:21 +03:00
< nav role = "progress" > < div class = "progresscontainer" >
2021-09-25 20:21:49 +03:00
< ul class = "progressbar" > < li class = "progressprev" > < a href = "1-fm.html" > ❮ < / a > < / li > < li class = "progresschapter" > < a href = "1-fm.html" > 1< / a > < / li > < li class = "progresscurrentchapter" > 2< / li > < li class = "progresscurrent" > cg< / li > < li class = "progresssection" > < a href = "2-cg2.html" > cg2< / a > < / li > < li class = "progresssection" > < a href = "2-tvg.html" > tvg< / a > < / li > < li class = "progresssection" > < a href = "2-vc.html" > vc< / a > < / li > < li class = "progresssection" > < a href = "2-vo.html" > vo< / a > < / li > < li class = "progresssection" > < a href = "2-vc2.html" > vc2< / a > < / li > < li class = "progresschapter" > < a href = "3-fti.html" > 3< / a > < / li > < li class = "progresschapter" > < a href = "4-fi6.html" > 4< / a > < / li > < li class = "progresschapter" > < a href = "5-fnc.html" > 5< / a > < / li > < li class = "progressnext" > < a href = "2-cg2.html" > ❯ < / a > < / li > < / ul > < / div >
2020-05-03 03:01:21 +03:00
< / nav > <!-- End of weave -->
2019-03-17 14:40:57 +02:00
2020-03-19 02:11:25 +02:00
< / main >
2019-03-17 14:40:57 +02:00
< / body >
< / html >
