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 >
2019-08-28 12:35:44 +03:00
< title > 1/pt< / title >
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-03-19 02:11:25 +02:00
< link href = "../inweb.css" rel = "stylesheet" rev = "stylesheet" type = "text/css" >
2019-03-17 14:40:57 +02:00
< / head >
< body >
2020-03-19 02:11:25 +02:00
< nav role = "navigation" >
< h1 > < a href = "../webs.html" > Sources< / a > < / h1 >
< ul >
2020-03-28 21:42:53 +02:00
< li > < a href = "../compiler.html" > < b > compiler tools< / b > < / 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 >
< / ul >
< h2 > Compiler Webs< / h2 >
< ul >
< li > < a href = "../inbuild/index.html" > inbuild< / a > < / li >
< li > < a href = "../inform7/index.html" > inform7< / a > < / li >
< li > < a href = "../inter/index.html" > inter< / a > < / li >
< / ul >
< h2 > Inbuild Modules< / h2 >
< ul >
< li > < a href = "../inbuild-module/index.html" > inbuild< / a > < / li >
< li > < a href = "../arch-module/index.html" > arch< / a > < / li >
< li > < a href = "../words-module/index.html" > words< / a > < / li >
< li > < a href = "../syntax-module/index.html" > syntax< / a > < / li >
< li > < a href = "../html-module/index.html" > html< / a > < / li >
< / ul >
< h2 > Inform7 Modules< / h2 >
< ul >
< li > < a href = "../core-module/index.html" > core< / a > < / li >
< li > < a href = "../problems-module/index.html" > problems< / a > < / li >
< li > < a href = "../inflections-module/index.html" > inflections< / a > < / li >
< li > < a href = "../linguistics-module/index.html" > linguistics< / a > < / li >
< li > < a href = "../kinds-module/index.html" > kinds< / a > < / li >
< li > < a href = "../if-module/index.html" > if< / a > < / li >
< li > < a href = "../multimedia-module/index.html" > multimedia< / a > < / li >
< li > < a href = "../index-module/index.html" > index< / a > < / li >
< / ul >
< h2 > Inter Modules< / h2 >
< ul >
< li > < a href = "../inter-module/index.html" > inter< / a > < / li >
< li > < a href = "../building-module/index.html" > building< / a > < / li >
< li > < a href = "../codegen-module/index.html" > codegen< / a > < / li >
< / ul >
< h2 > Foundation< / h2 >
< ul >
< li > < a href = "../../../inweb/docs/foundation-module/index.html" > foundation< / a > < / li >
< / ul >
< / nav >
< main role = "main" >
2019-08-28 12:35:44 +03:00
<!-- Weave of '1/in' generated by 7 -->
2020-03-22 12:50:19 +02:00
< ul class = "crumbs" > < li > < a href = "../webs.html" > Source< / a > < / li > < li > < a href = "../compiler.html" > Compiler Modules< / a > < / li > < li > < a href = "index.html" > building< / a > < / li > < li > < a href = "index.html#1" > Chapter 1: Architecture< / a > < / li > < li > < b > Inter Namespace< / b > < / li > < / ul > < p class = "purpose" > To manage identifiers, which have names and positions in the Inter hierarchy.< / p >
2019-04-18 03:53:27 +03:00
< ul class = "toc" > < li > < a href = "#SP1" > § 1. Families< / a > < / li > < li > < a href = "#SP2" > § 2. Printing inames< / a > < / li > < li > < a href = "#SP4" > § 4. Making new inames< / a > < / li > < li > < a href = "#SP8" > § 8. Conversion of inames to symbols< / a > < / li > < / ul > < hr class = "tocbar" >
< p class = "inwebparagraph" > < a id = "SP1" > < / a > < b > § 1. Families. < / b > Each inter name comes from a "generator". Some are one-shot, and produce just
one name before being discarded; others produce a numbered sequence of names
in a given pattern, counting upwards from 1 (< code class = "display" > < span class = "extract" > example_1< / span > < / code > , < code class = "display" > < span class = "extract" > example_2< / span > < / code > , ...);
and others still derive new names from existing ones (for example, turning
2019-04-22 17:06:29 +03:00
< code class = "display" > < span class = "extract" > fish< / span > < / code > and < code class = "display" > < span class = "extract" > rumour< / span > < / code > into < code class = "display" > < span class = "extract" > fishmonger< / span > < / code > and < code class = "display" > < span class = "extract" > rumourmonger< / span > < / code > ).
2019-04-18 03:53:27 +03:00
< / p >
2019-03-17 14:40:57 +02:00
< pre class = "definitions" >
2019-04-18 03:53:27 +03:00
< span class = "definitionkeyword" > enum< / span > < span class = "constant" > UNIQUE_INGEN< / span > < span class = "definitionkeyword" > from < / span > < span class = "constant" > 1< / span >
< span class = "definitionkeyword" > enum< / span > < span class = "constant" > MULTIPLE_INGEN< / span >
< span class = "definitionkeyword" > enum< / span > < span class = "constant" > DERIVED_INGEN< / span >
2019-03-17 14:40:57 +02:00
< / pre >
< pre class = "display" >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > typedef< / span > < span class = "plain" > < / span > < span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "reserved" > inter_name_generator< / span > < span class = "plain" > {< / span >
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > ingen< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > name_stem< / span > < span class = "plain" > ;< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > no_generated< / span > < span class = "plain" > ; < / span > < span class = "comment" > relevamt only for < code class = "display" > < span class = "extract" > MULTIPLE_INGEN< / span > < / code > < / span >
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > derived_prefix< / span > < span class = "plain" > ; < / span > < span class = "comment" > relevamt only for < code class = "display" > < span class = "extract" > DERIVED_INGEN< / span > < / code > < / span >
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > derived_suffix< / span > < span class = "plain" > ; < / span > < span class = "comment" > relevamt only for < code class = "display" > < span class = "extract" > DERIVED_INGEN< / span > < / code > < / span >
2019-04-18 03:53:27 +03:00
< span class = "plain" > } < / span > < span class = "reserved" > inter_name_generator< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > inter_name_generator< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::single_use_generator< / span > < span class = "plain" > (< / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > name< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > inter_name_generator< / span > < span class = "plain" > *< / span > < span class = "identifier" > F< / span > < span class = "plain" > = < / span > < span class = "identifier" > CREATE< / span > < span class = "plain" > (< / span > < span class = "reserved" > inter_name_generator< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > F< / span > < span class = "plain" > -> < / span > < span class = "element" > ingen< / span > < span class = "plain" > = < / span > < span class = "constant" > UNIQUE_INGEN< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > F< / span > < span class = "plain" > -> < / span > < span class = "element" > name_stem< / span > < span class = "plain" > = < / span > < span class = "identifier" > Str::duplicate< / span > < span class = "plain" > (< / span > < span class = "identifier" > name< / span > < span class = "plain" > );< / span >
< span class = "identifier" > F< / span > < span class = "plain" > -> < / span > < span class = "element" > derived_prefix< / span > < span class = "plain" > = < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ;< / span >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > F< / span > < span class = "plain" > ;< / span >
< span class = "plain" > }< / span >
< span class = "reserved" > inter_name_generator< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::multiple_use_generator< / span > < span class = "plain" > (< / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > prefix< / span > < span class = "plain" > , < / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > stem< / span > < span class = "plain" > , < / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > suffix< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > inter_name_generator< / span > < span class = "plain" > *< / span > < span class = "identifier" > gen< / span > < span class = "plain" > = < / span > < span class = "functiontext" > InterNames::single_use_generator< / span > < span class = "plain" > (< / span > < span class = "identifier" > stem< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > Str::len< / span > < span class = "plain" > (< / span > < span class = "identifier" > prefix< / span > < span class = "plain" > ) > < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) {< / span >
< span class = "identifier" > gen< / span > < span class = "plain" > -> < / span > < span class = "element" > ingen< / span > < span class = "plain" > = < / span > < span class = "constant" > DERIVED_INGEN< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > gen< / span > < span class = "plain" > -> < / span > < span class = "element" > derived_prefix< / span > < span class = "plain" > = < / span > < span class = "identifier" > Str::duplicate< / span > < span class = "plain" > (< / span > < span class = "identifier" > prefix< / span > < span class = "plain" > );< / span >
< span class = "plain" > } < / span > < span class = "reserved" > else< / span > < span class = "plain" > < / span > < span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > Str::len< / span > < span class = "plain" > (< / span > < span class = "identifier" > suffix< / span > < span class = "plain" > ) > < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) {< / span >
< span class = "identifier" > gen< / span > < span class = "plain" > -> < / span > < span class = "element" > ingen< / span > < span class = "plain" > = < / span > < span class = "constant" > DERIVED_INGEN< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > gen< / span > < span class = "plain" > -> < / span > < span class = "element" > derived_suffix< / span > < span class = "plain" > = < / span > < span class = "identifier" > Str::duplicate< / span > < span class = "plain" > (< / span > < span class = "identifier" > suffix< / span > < span class = "plain" > );< / span >
< span class = "plain" > } < / span > < span class = "reserved" > else< / span > < span class = "plain" > < / span > < span class = "identifier" > gen< / span > < span class = "plain" > -> < / span > < span class = "element" > ingen< / span > < span class = "plain" > = < / span > < span class = "constant" > MULTIPLE_INGEN< / span > < span class = "plain" > ;< / span >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > gen< / span > < span class = "plain" > ;< / span >
< span class = "plain" > }< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > The function InterNames::single_use_generator is used in < a href = "#SP5" > § 5< / a > .< / p >
2019-03-17 14:40:57 +02:00
2019-08-28 12:35:44 +03:00
< p class = "endnote" > The function InterNames::multiple_use_generator is used in 1/trn (< a href = "1-trn.html#SP1" > § 1< / a > ), 1/pck (< a href = "1-pck.html#SP4" > § 4< / a > ).< / p >
2019-04-18 03:53:27 +03:00
2019-08-28 12:35:44 +03:00
< p class = "endnote" > The structure inter_name_generator is accessed in 1/hl, 1/pck and here.< / p >
2019-04-18 03:53:27 +03:00
< p class = "inwebparagraph" > < a id = "SP2" > < / a > < b > § 2. Printing inames. < / b > Inter names are stored not in textual form, but in terms of what would be
required to generate that text. (The memo field, which in principle allows
any text to be stored, is used only for a small proportion of inames.)
< / p >
< pre class = "display" >
2019-03-17 14:40:57 +02:00
< span class = "reserved" > typedef< / span > < span class = "plain" > < / span > < span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "reserved" > inter_name< / span > < span class = "plain" > {< / span >
2019-04-18 11:51:47 +03:00
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "reserved" > inter_name_generator< / span > < span class = "plain" > *< / span > < span class = "identifier" > generated_by< / span > < span class = "plain" > ;< / span >
2019-03-17 14:40:57 +02:00
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > unique_number< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "identifier" > inter_symbol< / span > < span class = "plain" > *< / span > < span class = "identifier" > symbol< / span > < span class = "plain" > ;< / span >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "reserved" > package_request< / span > < span class = "plain" > *< / span > < span class = "identifier" > location_in_hierarchy< / span > < span class = "plain" > ;< / span >
2019-03-17 14:40:57 +02:00
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > memo< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > struct< / span > < span class = "plain" > < / span > < span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "identifier" > derived_from< / span > < span class = "plain" > ;< / span >
< span class = "plain" > } < / span > < span class = "reserved" > inter_name< / span > < span class = "plain" > ;< / span >
< / pre >
< p class = "inwebparagraph" > < / p >
2019-08-24 13:21:48 +03:00
< p class = "endnote" > The structure inter_name is accessed in 3/pi and here.< / p >
2019-03-17 14:40:57 +02:00
2019-04-18 03:53:27 +03:00
< p class = "inwebparagraph" > < a id = "SP3" > < / a > < b > § 3. < / b > This implements the < code class = "display" > < span class = "extract" > %n< / span > < / code > escape, which prints an iname:
< / p >
2019-03-17 14:40:57 +02:00
< pre class = "display" >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > void< / span > < span class = "plain" > < / span > < span class = "functiontext" > InterNames::writer< / span > < span class = "plain" > (< / span > < span class = "identifier" > OUTPUT_STREAM< / span > < span class = "plain" > , < / span > < span class = "reserved" > char< / span > < span class = "plain" > *< / span > < span class = "identifier" > format_string< / span > < span class = "plain" > , < / span > < span class = "reserved" > void< / span > < span class = "plain" > *< / span > < span class = "identifier" > vI< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "identifier" > iname< / span > < span class = "plain" > = (< / span > < span class = "reserved" > inter_name< / span > < span class = "plain" > *) < / span > < span class = "identifier" > vI< / span > < span class = "plain" > ;< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > == < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "< no-inter-name> "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > else< / span > < span class = "plain" > {< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "identifier" > generated_by< / span > < span class = "plain" > == < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ) < / span > < span class = "identifier" > internal_error< / span > < span class = "plain" > (< / span > < span class = "string" > "bad inter_name"< / span > < span class = "plain" > );< / span >
< span class = "reserved" > switch< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > generated_by< / span > < span class = "plain" > -> < / span > < span class = "element" > ingen< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > case< / span > < span class = "plain" > < / span > < span class = "identifier" > DERIVED_INGEN:< / span >
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > generated_by< / span > < span class = "plain" > -> < / span > < span class = "identifier" > derived_prefix< / span > < span class = "plain" > );< / span >
< span class = "functiontext" > InterNames::writer< / span > < span class = "plain" > (< / span > < span class = "identifier" > OUT< / span > < span class = "plain" > , < / span > < span class = "identifier" > format_string< / span > < span class = "plain" > , < / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > derived_from< / span > < span class = "plain" > );< / span >
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > generated_by< / span > < span class = "plain" > -> < / span > < span class = "identifier" > derived_suffix< / span > < span class = "plain" > );< / span >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > break< / span > < span class = "plain" > ;< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > case< / span > < span class = "plain" > < / span > < span class = "identifier" > UNIQUE_INGEN:< / span >
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > generated_by< / span > < span class = "plain" > -> < / span > < span class = "identifier" > name_stem< / span > < span class = "plain" > );< / span >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > break< / span > < span class = "plain" > ;< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > case< / span > < span class = "plain" > < / span > < span class = "identifier" > MULTIPLE_INGEN:< / span >
< span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > generated_by< / span > < span class = "plain" > -> < / span > < span class = "identifier" > name_stem< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "identifier" > unique_number< / span > < span class = "plain" > > = < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "%d"< / span > < span class = "plain" > , < / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > unique_number< / span > < span class = "plain" > );< / span >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > break< / span > < span class = "plain" > ;< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > default:< / span > < span class = "plain" > < / span > < span class = "identifier" > internal_error< / span > < span class = "plain" > (< / span > < span class = "string" > "unknown ingen"< / span > < span class = "plain" > );< / span >
2019-04-18 03:53:27 +03:00
< span class = "plain" > }< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > Str::len< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > memo< / span > < span class = "plain" > ) > < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE< / span > < span class = "plain" > (< / span > < span class = "string" > "_%S"< / span > < span class = "plain" > , < / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > memo< / span > < span class = "plain" > );< / span >
2019-04-18 03:53:27 +03:00
< span class = "plain" > }< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
2019-04-18 03:53:27 +03:00
< / pre >
2019-03-17 14:40:57 +02:00
2019-04-18 03:53:27 +03:00
< p class = "inwebparagraph" > < / p >
2019-03-17 14:40:57 +02:00
2019-08-28 12:35:44 +03:00
< p class = "endnote" > The function InterNames::writer is used in 1/bm (< a href = "1-bm.html#SP4_2" > § 4.2< / a > ).< / p >
2019-03-17 14:40:57 +02:00
2019-04-18 03:53:27 +03:00
< p class = "inwebparagraph" > < a id = "SP4" > < / a > < b > § 4. Making new inames. < / b > We can now make a new iname, which is easy unless there's a memo to attach.
For example, attaching the wording "printing the name of a dark room" to
an iname which would otherwise just be < code class = "display" > < span class = "extract" > V12< / span > < / code > produces < code class = "display" > < span class = "extract" > V12_printing_the_name_of_a_da< / span > < / code > .
2019-04-22 17:06:29 +03:00
Memos exist largely to make the Inter code easier for human eyes to read,
2019-04-18 03:53:27 +03:00
as in this case, but sometimes, as with kind names like < code class = "display" > < span class = "extract" > K2_thing< / span > < / code > , they're
needed because template or explicit I6 inclusion code makes references to them.
< / p >
2019-03-17 14:40:57 +02:00
2019-04-18 03:53:27 +03:00
< p class = "inwebparagraph" > Although most inter names are eventually used to create symbols in the
Inter hierarchy's symbols table, this does not happen immediately, and
for some inames it never will.
< / p >
< pre class = "display" >
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::new< / span > < span class = "plain" > (< / span > < span class = "reserved" > inter_name_generator< / span > < span class = "plain" > *< / span > < span class = "identifier" > F< / span > < span class = "plain" > , < / span > < span class = "reserved" > package_request< / span > < span class = "plain" > *< / span > < span class = "identifier" > R< / span > < span class = "plain" > , < / span > < span class = "identifier" > wording< / span > < span class = "plain" > < / span > < span class = "identifier" > W< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "identifier" > iname< / span > < span class = "plain" > = < / span > < span class = "identifier" > CREATE< / span > < span class = "plain" > (< / span > < span class = "reserved" > inter_name< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > generated_by< / span > < span class = "plain" > = < / span > < span class = "identifier" > F< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > unique_number< / span > < span class = "plain" > = < / span > < span class = "constant" > 0< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > symbol< / span > < span class = "plain" > = < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > derived_from< / span > < span class = "plain" > = < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ;< / span >
< span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > location_in_hierarchy< / span > < span class = "plain" > = < / span > < span class = "identifier" > R< / span > < span class = "plain" > ;< / span >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > Wordings::empty< / span > < span class = "plain" > (< / span > < span class = "identifier" > W< / span > < span class = "plain" > )) {< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > memo< / span > < span class = "plain" > = < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ;< / span >
2019-04-18 03:53:27 +03:00
< span class = "plain" > } < / span > < span class = "reserved" > else< / span > < span class = "plain" > {< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > memo< / span > < span class = "plain" > = < / span > < span class = "identifier" > Str::new< / span > < span class = "plain" > ();< / span >
2019-04-18 03:53:27 +03:00
< < span class = "cwebmacro" > Fill the memo with up to 28 characters of text from the given wording< / span > < span class = "cwebmacronumber" > 4.1< / span > > < span class = "plain" > ;< / span >
< < span class = "cwebmacro" > Ensure that the name, as now extended by the memo, is a legal Inter identifier< / span > < span class = "cwebmacronumber" > 4.2< / span > > < span class = "plain" > ;< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > iname< / span > < span class = "plain" > ;< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
2019-04-18 03:53:27 +03:00
< / pre >
2019-03-17 14:40:57 +02:00
2019-04-18 03:53:27 +03:00
< p class = "inwebparagraph" > < / p >
2019-04-17 20:19:03 +03:00
2019-04-18 03:53:27 +03:00
< p class = "endnote" > The function InterNames::new is used in < a href = "#SP5" > § 5< / a > , < a href = "#SP6" > § 6< / a > .< / p >
2019-03-17 14:40:57 +02:00
2019-04-18 03:53:27 +03:00
< p class = "inwebparagraph" > < a id = "SP4_1" > < / a > < b > § 4.1. < / b > < code class = "display" >
< < span class = "cwebmacrodefn" > Fill the memo with up to 28 characters of text from the given wording< / span > < span class = "cwebmacronumber" > 4.1< / span > > =
< / code > < / p >
< pre class = "displaydefn" >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > c< / span > < span class = "plain" > = < / span > < span class = "constant" > 0< / span > < span class = "plain" > ;< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > LOOP_THROUGH_WORDING< / span > < span class = "plain" > (< / span > < span class = "identifier" > j< / span > < span class = "plain" > , < / span > < span class = "identifier" > W< / span > < span class = "plain" > ) {< / span >
< span class = "comment" > identifier is at this point 32 chars or fewer in length: add at most 30 more< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > c< / span > < span class = "plain" > ++ > < / span > < span class = "constant" > 0< / span > < span class = "plain" > ) < / span > < span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > memo< / span > < span class = "plain" > , < / span > < span class = "string" > " "< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > Wide::len< / span > < span class = "plain" > (< / span > < span class = "identifier" > Lexer::word_text< / span > < span class = "plain" > (< / span > < span class = "identifier" > j< / span > < span class = "plain" > )) > < / span > < span class = "constant" > 30< / span > < span class = "plain" > )< / span >
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > memo< / span > < span class = "plain" > , < / span > < span class = "string" > "etc"< / span > < span class = "plain" > );< / span >
< span class = "reserved" > else< / span > < span class = "plain" > < / span > < span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > memo< / span > < span class = "plain" > , < / span > < span class = "string" > "%N"< / span > < span class = "plain" > , < / span > < span class = "identifier" > j< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > Str::len< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > memo< / span > < span class = "plain" > ) > < / span > < span class = "constant" > 32< / span > < span class = "plain" > ) < / span > < span class = "reserved" > break< / span > < span class = "plain" > ;< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > Str::truncate< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > memo< / span > < span class = "plain" > , < / span > < span class = "constant" > 28< / span > < span class = "plain" > ); < / span > < span class = "comment" > it was at worst 62 chars in size, but is now truncated to 28< / span >
2019-04-18 03:53:27 +03:00
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > This code is used in < a href = "#SP4" > § 4< / a > .< / p >
< p class = "inwebparagraph" > < a id = "SP4_2" > < / a > < b > § 4.2. < / b > < code class = "display" >
< < span class = "cwebmacrodefn" > Ensure that the name, as now extended by the memo, is a legal Inter identifier< / span > < span class = "cwebmacronumber" > 4.2< / span > > =
< / code > < / p >
< pre class = "displaydefn" >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > Identifiers::purify< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > memo< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > NBUFF< / span > < span class = "plain" > );< / span >
2019-04-18 03:53:27 +03:00
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > NBUFF< / span > < span class = "plain" > , < / span > < span class = "string" > "%n"< / span > < span class = "plain" > , < / span > < span class = "identifier" > iname< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > L< / span > < span class = "plain" > = < / span > < span class = "identifier" > Str::len< / span > < span class = "plain" > (< / span > < span class = "identifier" > NBUFF< / span > < span class = "plain" > );< / span >
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > NBUFF< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > L< / span > < span class = "plain" > > < / span > < span class = "constant" > 28< / span > < span class = "plain" > ) < / span > < span class = "identifier" > Str::truncate< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "identifier" > memo< / span > < span class = "plain" > , < / span > < span class = "identifier" > Str::len< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > memo< / span > < span class = "plain" > ) - (< / span > < span class = "identifier" > L< / span > < span class = "plain" > - < / span > < span class = "constant" > 28< / span > < span class = "plain" > ));< / span >
2019-04-18 03:53:27 +03:00
< / pre >
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > This code is used in < a href = "#SP4" > § 4< / a > .< / p >
< p class = "inwebparagraph" > < a id = "SP5" > < / a > < b > § 5. < / b > That creation function should be called only by these, which in turn must
be called only from within the current chapter. First, the single-shot cases,
where the caller wants a single name with fixed wording (but possibly with
a memo to attach):
< / p >
< pre class = "display" >
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::explicitly_named_with_memo< / span > < span class = "plain" > (< / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > name< / span > < span class = "plain" > , < / span > < span class = "reserved" > package_request< / span > < span class = "plain" > *< / span > < span class = "identifier" > R< / span > < span class = "plain" > , < / span > < span class = "identifier" > wording< / span > < span class = "plain" > < / span > < span class = "identifier" > W< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "functiontext" > InterNames::new< / span > < span class = "plain" > (< / span > < span class = "functiontext" > InterNames::single_use_generator< / span > < span class = "plain" > (< / span > < span class = "identifier" > name< / span > < span class = "plain" > ), < / span > < span class = "identifier" > R< / span > < span class = "plain" > , < / span > < span class = "identifier" > W< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::explicitly_named< / span > < span class = "plain" > (< / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > name< / span > < span class = "plain" > , < / span > < span class = "reserved" > package_request< / span > < span class = "plain" > *< / span > < span class = "identifier" > R< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "functiontext" > InterNames::explicitly_named_with_memo< / span > < span class = "plain" > (< / span > < span class = "identifier" > name< / span > < span class = "plain" > , < / span > < span class = "identifier" > R< / span > < span class = "plain" > , < / span > < span class = "identifier" > EMPTY_WORDING< / span > < span class = "plain" > );< / span >
2019-04-17 20:19:03 +03:00
< span class = "plain" > }< / span >
2019-04-19 16:36:05 +03:00
2019-08-28 12:35:44 +03:00
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::explicitly_named_in_template< / span > < span class = "plain" > (< / span > < span class = "identifier" > inter_tree< / span > < span class = "plain" > *< / span > < span class = "identifier" > I< / span > < span class = "plain" > , < / span > < span class = "identifier" > text_stream< / span > < span class = "plain" > *< / span > < span class = "identifier" > name< / span > < span class = "plain" > ) {< / span >
2019-08-31 15:56:36 +03:00
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "identifier" > iname< / span > < span class = "plain" > = < / span > < span class = "functiontext" > InterNames::explicitly_named< / span > < span class = "plain" > (< / span > < span class = "identifier" > name< / span > < span class = "plain" > , < / span > < span class = "functiontext" > Site::connectors_request< / span > < span class = "plain" > (< / span > < span class = "identifier" > I< / span > < span class = "plain" > ));< / span >
< span class = "identifier" > inter_symbol< / span > < span class = "plain" > *< / span > < span class = "identifier" > plug< / span > < span class = "plain" > = < / span > < span class = "identifier" > Inter::Connectors::find_plug< / span > < span class = "plain" > (< / span > < span class = "identifier" > I< / span > < span class = "plain" > , < / span > < span class = "identifier" > name< / span > < span class = "plain" > );< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > plug< / span > < span class = "plain" > == < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ) < / span > < span class = "identifier" > plug< / span > < span class = "plain" > = < / span > < span class = "identifier" > Inter::Connectors::plug< / span > < span class = "plain" > (< / span > < span class = "identifier" > I< / span > < span class = "plain" > , < / span > < span class = "identifier" > name< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > symbol< / span > < span class = "plain" > = < / span > < span class = "identifier" > plug< / span > < span class = "plain" > ;< / span >
2019-04-19 16:36:05 +03:00
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > iname< / span > < span class = "plain" > ;< / span >
< span class = "plain" > }< / span >
2019-04-18 03:53:27 +03:00
< / pre >
< p class = "inwebparagraph" > < / p >
2019-08-28 12:35:44 +03:00
< p class = "endnote" > The function InterNames::explicitly_named_with_memo is used in 1/hl (< a href = "1-hl.html#SP3_1" > § 3.1< / a > ).< / p >
2019-04-18 03:53:27 +03:00
2019-08-31 15:56:36 +03:00
< p class = "endnote" > The function InterNames::explicitly_named is used in 1/bs (< a href = "1-bs.html#SP2" > § 2< / a > ), 1/hl (< a href = "1-hl.html#SP3" > § 3< / a > , < a href = "1-hl.html#SP3_1" > § 3.1< / a > , < a href = "1-hl.html#SP4" > § 4< / a > ), 1/pck (< a href = "1-pck.html#SP15" > § 15< / a > , < a href = "1-pck.html#SP18" > § 18< / a > , < a href = "1-pck.html#SP19" > § 19< / a > , < a href = "1-pck.html#SP20" > § 20< / a > ), 3/pi (< a href = "3-pi.html#SP2" > § 2< / a > ).< / p >
2019-04-19 16:36:05 +03:00
2019-08-28 12:35:44 +03:00
< p class = "endnote" > The function InterNames::explicitly_named_in_template is used in 1/hl (< a href = "1-hl.html#SP3" > § 3< / a > ).< / p >
2019-04-17 20:19:03 +03:00
2019-04-18 03:53:27 +03:00
< p class = "inwebparagraph" > < a id = "SP6" > < / a > < b > § 6. < / b > Second, the generated or derived cases:
< / p >
< pre class = "display" >
2019-04-18 11:51:47 +03:00
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::multiple< / span > < span class = "plain" > (< / span > < span class = "reserved" > inter_name_generator< / span > < span class = "plain" > *< / span > < span class = "identifier" > G< / span > < span class = "plain" > , < / span > < span class = "reserved" > package_request< / span > < span class = "plain" > *< / span > < span class = "identifier" > R< / span > < span class = "plain" > , < / span > < span class = "identifier" > wording< / span > < span class = "plain" > < / span > < span class = "identifier" > W< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > G< / span > < span class = "plain" > == < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ) < / span > < span class = "identifier" > internal_error< / span > < span class = "plain" > (< / span > < span class = "string" > "no generator"< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > G< / span > < span class = "plain" > -> < / span > < span class = "element" > ingen< / span > < span class = "plain" > == < / span > < span class = "constant" > UNIQUE_INGEN< / span > < span class = "plain" > ) < / span > < span class = "identifier" > internal_error< / span > < span class = "plain" > (< / span > < span class = "string" > "not a generator name"< / span > < span class = "plain" > );< / span >
2019-04-18 11:51:47 +03:00
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "identifier" > iname< / span > < span class = "plain" > = < / span > < span class = "functiontext" > InterNames::new< / span > < span class = "plain" > (< / span > < span class = "identifier" > G< / span > < span class = "plain" > , < / span > < span class = "identifier" > R< / span > < span class = "plain" > , < / span > < span class = "identifier" > W< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > G< / span > < span class = "plain" > -> < / span > < span class = "element" > ingen< / span > < span class = "plain" > != < / span > < span class = "constant" > DERIVED_INGEN< / span > < span class = "plain" > ) < / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > unique_number< / span > < span class = "plain" > = ++< / span > < span class = "identifier" > G< / span > < span class = "plain" > -> < / span > < span class = "element" > no_generated< / span > < span class = "plain" > ;< / span >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > iname< / span > < span class = "plain" > ;< / span >
2019-04-17 20:19:03 +03:00
< span class = "plain" > }< / span >
2019-04-22 17:06:29 +03:00
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::generated_in< / span > < span class = "plain" > (< / span > < span class = "reserved" > inter_name_generator< / span > < span class = "plain" > *< / span > < span class = "identifier" > G< / span > < span class = "plain" > , < / span > < span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > fix< / span > < span class = "plain" > , < / span > < span class = "identifier" > wording< / span > < span class = "plain" > < / span > < span class = "identifier" > W< / span > < span class = "plain" > , < / span > < span class = "reserved" > package_request< / span > < span class = "plain" > *< / span > < span class = "identifier" > R< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "identifier" > iname< / span > < span class = "plain" > = < / span > < span class = "functiontext" > InterNames::multiple< / span > < span class = "plain" > (< / span > < span class = "identifier" > G< / span > < span class = "plain" > , < / span > < span class = "identifier" > R< / span > < span class = "plain" > , < / span > < span class = "identifier" > W< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > fix< / span > < span class = "plain" > != -1) < / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > unique_number< / span > < span class = "plain" > = < / span > < span class = "identifier" > fix< / span > < span class = "plain" > ;< / span >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > iname< / span > < span class = "plain" > ;< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
2019-04-22 17:06:29 +03:00
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::generated< / span > < span class = "plain" > (< / span > < span class = "reserved" > inter_name_generator< / span > < span class = "plain" > *< / span > < span class = "identifier" > G< / span > < span class = "plain" > , < / span > < span class = "reserved" > int< / span > < span class = "plain" > < / span > < span class = "identifier" > fix< / span > < span class = "plain" > , < / span > < span class = "identifier" > wording< / span > < span class = "plain" > < / span > < span class = "identifier" > W< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "functiontext" > InterNames::generated_in< / span > < span class = "plain" > (< / span > < span class = "identifier" > G< / span > < span class = "plain" > , < / span > < span class = "identifier" > fix< / span > < span class = "plain" > , < / span > < span class = "identifier" > W< / span > < span class = "plain" > , < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > );< / span >
< span class = "plain" > }< / span >
2019-04-18 11:51:47 +03:00
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::derived< / span > < span class = "plain" > (< / span > < span class = "reserved" > inter_name_generator< / span > < span class = "plain" > *< / span > < span class = "identifier" > G< / span > < span class = "plain" > , < / span > < span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "identifier" > from< / span > < span class = "plain" > , < / span > < span class = "identifier" > wording< / span > < span class = "plain" > < / span > < span class = "identifier" > W< / span > < span class = "plain" > ) {< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > G< / span > < span class = "plain" > -> < / span > < span class = "element" > ingen< / span > < span class = "plain" > != < / span > < span class = "constant" > DERIVED_INGEN< / span > < span class = "plain" > ) < / span > < span class = "identifier" > internal_error< / span > < span class = "plain" > (< / span > < span class = "string" > "not a derived generator"< / span > < span class = "plain" > );< / span >
< span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "identifier" > iname< / span > < span class = "plain" > = < / span > < span class = "functiontext" > InterNames::multiple< / span > < span class = "plain" > (< / span > < span class = "identifier" > G< / span > < span class = "plain" > , < / span > < span class = "identifier" > from< / span > < span class = "plain" > -> < / span > < span class = "element" > location_in_hierarchy< / span > < span class = "plain" > , < / span > < span class = "identifier" > W< / span > < span class = "plain" > );< / span >
< span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > derived_from< / span > < span class = "plain" > = < / span > < span class = "identifier" > from< / span > < span class = "plain" > ;< / span >
2019-04-18 03:53:27 +03:00
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > iname< / span > < span class = "plain" > ;< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
2019-04-18 03:53:27 +03:00
< / pre >
2019-03-17 14:40:57 +02:00
2019-04-18 03:53:27 +03:00
< p class = "inwebparagraph" > < / p >
< p class = "endnote" > The function InterNames::multiple appears nowhere else.< / p >
2019-08-28 12:35:44 +03:00
< p class = "endnote" > The function InterNames::generated_in is used in 1/pck (< a href = "1-pck.html#SP4" > § 4< / a > ).< / p >
2019-04-22 17:06:29 +03:00
2019-08-28 12:35:44 +03:00
< p class = "endnote" > The function InterNames::generated is used in 1/hl (< a href = "1-hl.html#SP3" > § 3< / a > ).< / p >
2019-04-18 03:53:27 +03:00
2019-08-28 12:35:44 +03:00
< p class = "endnote" > The function InterNames::derived is used in 1/hl (< a href = "1-hl.html#SP3" > § 3< / a > ).< / p >
2019-04-18 03:53:27 +03:00
2019-04-20 12:51:59 +03:00
< p class = "inwebparagraph" > < a id = "SP7" > < / a > < b > § 7. < / b > Now that inames have been created, we allow their locations to be read:
< / p >
2019-04-18 03:53:27 +03:00
< pre class = "display" >
2019-04-18 11:51:47 +03:00
< span class = "reserved" > package_request< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::location< / span > < span class = "plain" > (< / span > < span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "identifier" > iname< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > == < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ) < / span > < span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ;< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > location_in_hierarchy< / span > < span class = "plain" > ;< / span >
2019-04-18 03:53:27 +03:00
< span class = "plain" > }< / span >
2019-04-20 12:51:59 +03:00
< span class = "identifier" > inter_symbols_table< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::scope< / span > < span class = "plain" > (< / span > < span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "identifier" > iname< / span > < span class = "plain" > ) {< / span >
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > == < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ) < / span > < span class = "identifier" > internal_error< / span > < span class = "plain" > (< / span > < span class = "string" > "can't determine scope of null name"< / span > < span class = "plain" > );< / span >
< span class = "reserved" > package_request< / span > < span class = "plain" > *< / span > < span class = "identifier" > P< / span > < span class = "plain" > = < / span > < span class = "functiontext" > InterNames::location< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > );< / span >
2019-08-31 15:56:36 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > P< / span > < span class = "plain" > == < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ) < / span > < span class = "identifier" > internal_error< / span > < span class = "plain" > (< / span > < span class = "string" > "can't determine scope of unlocated name"< / span > < span class = "plain" > );< / span >
< span class = "comment" > return Inter::Tree::global_scope(InterNames::tree(iname));< / span >
2019-04-20 12:51:59 +03:00
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > Inter::Packages::scope< / span > < span class = "plain" > (< / span > < span class = "functiontext" > Packaging::incarnate< / span > < span class = "plain" > (< / span > < span class = "identifier" > P< / span > < span class = "plain" > ));< / span >
< span class = "plain" > }< / span >
2019-04-18 03:53:27 +03:00
< / pre >
< p class = "inwebparagraph" > < / p >
2019-08-28 12:35:44 +03:00
< p class = "endnote" > The function InterNames::location is used in 1/hl (< a href = "1-hl.html#SP3" > § 3< / a > ), 1/pck (< a href = "1-pck.html#SP2" > § 2< / a > , < a href = "1-pck.html#SP12" > § 12< / a > , < a href = "1-pck.html#SP19" > § 19< / a > ), 3/pi (< a href = "3-pi.html#SP3" > § 3< / a > ).< / p >
2019-04-20 12:51:59 +03:00
< p class = "endnote" > The function InterNames::scope is used in < a href = "#SP8" > § 8< / a > .< / p >
2019-04-18 03:53:27 +03:00
< p class = "inwebparagraph" > < a id = "SP8" > < / a > < b > § 8. Conversion of inames to symbols. < / b > The purpose of inames is not quite to represent identifier names occurring in
given packages inside the Inter hierarchy: it would be more accurate to say
that they represent potential identifiers, which may or may not be used.
At some point they will probably (but not certainly) undergo "conversion",
when they are matched up with actual symbols in the symbols tables of the
2019-04-19 16:36:05 +03:00
given packages. An exception to this is that inames pointing to externally
defined resources in the template are never converted: see above.
2019-04-18 03:53:27 +03:00
< / p >
< p class = "inwebparagraph" > Conversion is done on-demand, and thus left as late as possible. It happens
2019-04-19 16:36:05 +03:00
automatically here:
2019-04-18 03:53:27 +03:00
< / p >
< pre class = "display" >
< span class = "identifier" > inter_symbol< / span > < span class = "plain" > *< / span > < span class = "functiontext" > InterNames::to_symbol< / span > < span class = "plain" > (< / span > < span class = "reserved" > inter_name< / span > < span class = "plain" > *< / span > < span class = "identifier" > iname< / span > < span class = "plain" > ) {< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > if< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "identifier" > symbol< / span > < span class = "plain" > == < / span > < span class = "identifier" > NULL< / span > < span class = "plain" > ) {< / span >
2019-04-18 03:53:27 +03:00
< span class = "identifier" > TEMPORARY_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > NBUFF< / span > < span class = "plain" > );< / span >
< span class = "identifier" > WRITE_TO< / span > < span class = "plain" > (< / span > < span class = "identifier" > NBUFF< / span > < span class = "plain" > , < / span > < span class = "string" > "%n"< / span > < span class = "plain" > , < / span > < span class = "identifier" > iname< / span > < span class = "plain" > );< / span >
2019-04-20 12:51:59 +03:00
< span class = "identifier" > inter_symbols_table< / span > < span class = "plain" > *< / span > < span class = "identifier" > T< / span > < span class = "plain" > = < / span > < span class = "functiontext" > InterNames::scope< / span > < span class = "plain" > (< / span > < span class = "identifier" > iname< / span > < span class = "plain" > );< / span >
2020-04-07 03:06:09 +03:00
< span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > symbol< / span > < span class = "plain" > = < / span > < span class = "functiontext" > Produce::new_symbol< / span > < span class = "plain" > (< / span > < span class = "identifier" > T< / span > < span class = "plain" > , < / span > < span class = "identifier" > NBUFF< / span > < span class = "plain" > );< / span >
2019-04-18 03:53:27 +03:00
< span class = "identifier" > DISCARD_TEXT< / span > < span class = "plain" > (< / span > < span class = "identifier" > NBUFF< / span > < span class = "plain" > );< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
2020-04-07 03:06:09 +03:00
< span class = "reserved" > return< / span > < span class = "plain" > < / span > < span class = "identifier" > iname< / span > < span class = "plain" > -> < / span > < span class = "element" > symbol< / span > < span class = "plain" > ;< / span >
2019-03-17 14:40:57 +02:00
< span class = "plain" > }< / span >
2019-04-17 20:19:03 +03:00
< / pre >
2019-03-17 14:40:57 +02:00
2019-04-17 20:19:03 +03:00
< p class = "inwebparagraph" > < / p >
2019-03-17 14:40:57 +02:00
2019-08-28 12:35:44 +03:00
< p class = "endnote" > The function InterNames::to_symbol is used in 2/eis (< a href = "2-eis.html#SP4" > § 4< / a > ), 3/pi (< a href = "3-pi.html#SP2" > § 2< / a > , < a href = "3-pi.html#SP3" > § 3< / a > ).< / p >
2019-04-17 20:19:03 +03:00
2019-03-17 14:40:57 +02:00
< hr class = "tocbar" >
2019-08-28 12:35:44 +03:00
< ul class = "toc" > < li > < a href = "1-pt.html" > Back to 'Package Types'< / a > < / li > < li > < i > (This section ends Chapter 1: Architecture.)< / i > < / li > < / ul > < hr class = "tocbar" >
2019-04-22 17:42:10 +03:00
<!-- End of weave -->
2020-03-19 02:11:25 +02:00
< / main >
2019-03-17 14:40:57 +02:00
< / body >
< / html >
