mirror of
https://github.com/ganelson/inform.git
synced 2024-07-09 02:24:21 +03:00
366 lines
44 KiB
HTML
366 lines
44 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<title>Name Clusters</title>
|
|
<meta name="viewport" content="width=device-width initial-scale=1">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<meta http-equiv="Content-Language" content="en-gb">
|
|
<link href="../inweb.css" rel="stylesheet" rev="stylesheet" type="text/css">
|
|
|
|
</head>
|
|
<body>
|
|
<nav role="navigation">
|
|
<h1><a href="../index.html">
|
|
<img src="../docs-src/Figures/Inform.png" height=72">
|
|
</a></h1>
|
|
<ul><li><a href="../compiler.html">compiler tools</a></li>
|
|
<li><a href="../other.html">other tools</a></li>
|
|
<li><a href="../extensions.html">extensions and kits</a></li>
|
|
<li><a href="../units.html">unit test tools</a></li>
|
|
</ul><h2>Compiler Webs</h2><ul>
|
|
<li><a href="../inbuild/index.html">inbuild</a></li>
|
|
<li><a href="../inform7/index.html">inform7</a></li>
|
|
<li><a href="../inter/index.html">inter</a></li>
|
|
</ul><h2>Inbuild Modules</h2><ul>
|
|
<li><a href="../supervisor-module/index.html">supervisor</a></li>
|
|
</ul><h2>Inform7 Modules</h2><ul>
|
|
<li><a href="../core-module/index.html">core</a></li>
|
|
<li><a href="index.html"><span class="selectedlink">inflections</span></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="../problems-module/index.html">problems</a></li>
|
|
<li><a href="../index-module/index.html">index</a></li>
|
|
</ul><h2>Inter Modules</h2><ul>
|
|
<li><a href="../bytecode-module/index.html">bytecode</a></li>
|
|
<li><a href="../building-module/index.html">building</a></li>
|
|
<li><a href="../codegen-module/index.html">codegen</a></li>
|
|
</ul><h2>Shared Modules</h2><ul>
|
|
<li><a href="../arch-module/index.html">arch</a></li>
|
|
<li><a href="../syntax-module/index.html">syntax</a></li>
|
|
<li><a href="../words-module/index.html">words</a></li>
|
|
<li><a href="../html-module/index.html">html</a></li>
|
|
<li><a href="../../../inweb/docs/foundation-module/index.html">foundation</a></li>
|
|
|
|
</ul>
|
|
</nav>
|
|
<main role="main">
|
|
|
|
<!--Weave of 'Name Clusters' generated by 7-->
|
|
<ul class="crumbs"><li><a href="../index.html">Home</a></li><li><a href="../compiler.html">Inform7 Modules</a></li><li><a href="index.html">inflections</a></li><li><a href="index.html#2">Chapter 2: Machinery</a></li><li><b>Name Clusters</b></li></ul><p class="purpose">Name clusters are sets of noun or adjective forms, perhaps multiple or in multiple languages, which have in common that they share a meaning.</p>
|
|
|
|
<ul class="toc"><li><a href="#SP1">§1. Cluster</a></li><li><a href="#SP5">§5. Plural fixing</a></li><li><a href="#SP6">§6. Searching declensions</a></li><li><a href="#SP9">§9. Meanings</a></li></ul><hr class="tocbar">
|
|
|
|
<p class="inwebparagraph"><a id="SP1"></a><b>§1. Cluster. </b>A cluster is a linked list of wordings, in effect, but they are annotated
|
|
with lingistic roles. For example, the cluster of names for the common noun
|
|
"man" might be:
|
|
</p>
|
|
|
|
<blockquote>
|
|
<p>man (En, singular), men (En, plural), homme (Fr, singular), hommes (Fr, plural)</p>
|
|
|
|
</blockquote>
|
|
|
|
<p class="inwebparagraph">(at least in the nominative case). Clusters can be used for adjectives too.
|
|
</p>
|
|
|
|
<pre class="display">
|
|
<span class="reserved">typedef</span><span class="plain"> </span><span class="reserved">struct</span><span class="plain"> </span><span class="reserved">name_cluster</span><span class="plain"> {</span>
|
|
<span class="reserved">struct</span><span class="plain"> </span><span class="reserved">individual_name</span><span class="plain"> *</span><span class="identifier">first_name</span><span class="plain">;</span>
|
|
<span class="identifier">MEMORY_MANAGEMENT</span>
|
|
<span class="plain">} </span><span class="reserved">name_cluster</span><span class="plain">;</span>
|
|
|
|
<span class="reserved">typedef</span><span class="plain"> </span><span class="reserved">struct</span><span class="plain"> </span><span class="reserved">individual_name</span><span class="plain"> {</span>
|
|
<span class="identifier">general_pointer</span><span class="plain"> </span><span class="identifier">principal_meaning</span><span class="plain">; </span><span class="comment"> for the client to attach some meaning</span>
|
|
<span class="reserved">struct</span><span class="plain"> </span><span class="reserved">declension</span><span class="plain"> </span><span class="identifier">name</span><span class="plain">; </span><span class="comment"> text of name</span>
|
|
<span class="reserved">int</span><span class="plain"> </span><span class="identifier">name_number</span><span class="plain">; </span><span class="comment"> 1 for singular, 2 for plural</span>
|
|
<span class="reserved">int</span><span class="plain"> </span><span class="identifier">name_gender</span><span class="plain">; </span><span class="comment"> 1 is neuter, 2 is masculine, 3 is feminine</span>
|
|
<span class="identifier">PREFORM_LANGUAGE_TYPE</span><span class="plain"> *</span><span class="identifier">name_language</span><span class="plain">; </span><span class="comment"> always non-null</span>
|
|
<span class="reserved">struct</span><span class="plain"> </span><span class="reserved">individual_name</span><span class="plain"> *</span><span class="identifier">next</span><span class="plain">; </span><span class="comment"> within its cluster</span>
|
|
<span class="identifier">MEMORY_MANAGEMENT</span>
|
|
<span class="plain">} </span><span class="reserved">individual_name</span><span class="plain">;</span>
|
|
</pre>
|
|
|
|
<p class="inwebparagraph"></p>
|
|
|
|
<p class="endnote">The structure name_cluster is private to this section.</p>
|
|
|
|
<p class="endnote">The structure individual_name is accessed in 2/np and here.</p>
|
|
|
|
<p class="inwebparagraph"><a id="SP2"></a><b>§2. </b>A cluster begins empty.
|
|
</p>
|
|
|
|
<pre class="display">
|
|
<span class="reserved">name_cluster</span><span class="plain"> *</span><span class="functiontext">Clusters::new<button class="popup" onclick="togglePopup('usagePopup13')">...<span class="popuptext" id="usagePopup13">Usage of <b>Clusters::new</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">void</span><span class="plain">) {</span>
|
|
<span class="reserved">name_cluster</span><span class="plain"> *</span><span class="identifier">names</span><span class="plain"> = </span><span class="identifier">CREATE</span><span class="plain">(</span><span class="reserved">name_cluster</span><span class="plain">);</span>
|
|
<span class="identifier">names</span><span class="plain">-></span><span class="element">first_name</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">names</span><span class="plain">;</span>
|
|
<span class="plain">}</span>
|
|
</pre>
|
|
|
|
<p class="inwebparagraph"></p>
|
|
|
|
<p class="inwebparagraph"><a id="SP3"></a><b>§3. </b>The following can add either a single name, or a name and its plural(s):
|
|
</p>
|
|
|
|
<pre class="display">
|
|
<span class="reserved">individual_name</span><span class="plain"> *</span><span class="functiontext">Clusters::add<button class="popup" onclick="togglePopup('usagePopup14')">...<span class="popuptext" id="usagePopup14">Usage of <b>Clusters::add</b>:<br><a href="#SP3_1">§3.1</a>, <a href="#SP4">§4</a>, <a href="#SP4_1">§4.1</a>, <a href="#SP5">§5</a></span></button></span><span class="plain">(</span><span class="reserved">name_cluster</span><span class="plain"> *</span><span class="identifier">names</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="identifier">PREFORM_LANGUAGE_TYPE</span><span class="plain"> *</span><span class="identifier">nl</span><span class="plain">, </span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">gender</span><span class="plain">, </span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">number</span><span class="plain">, </span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">pluralise</span><span class="plain">) {</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">nl</span><span class="plain"> == </span><span class="identifier">NULL</span><span class="plain">) </span><span class="identifier">nl</span><span class="plain"> = </span><span class="identifier">English_language</span><span class="plain">;</span>
|
|
<span class="reserved">individual_name</span><span class="plain"> *</span><span class="identifier">in</span><span class="plain"> = </span><span class="identifier">CREATE</span><span class="plain">(</span><span class="reserved">individual_name</span><span class="plain">);</span>
|
|
<span class="identifier">in</span><span class="plain">-></span><span class="element">principal_meaning</span><span class="plain"> = </span><span class="identifier">NULL_GENERAL_POINTER</span><span class="plain">;</span>
|
|
<span class="identifier">in</span><span class="plain">-></span><span class="element">name</span><span class="plain"> = </span><span class="functiontext"><a href="3-dcl.html#SP2">Declensions::decline</a></span><span class="plain">(</span><span class="identifier">W</span><span class="plain">, </span><span class="identifier">nl</span><span class="plain">, </span><span class="identifier">gender</span><span class="plain">, </span><span class="identifier">number</span><span class="plain">);</span>
|
|
<span class="identifier">in</span><span class="plain">-></span><span class="element">name_language</span><span class="plain"> = </span><span class="identifier">nl</span><span class="plain">;</span>
|
|
<span class="identifier">in</span><span class="plain">-></span><span class="element">name_number</span><span class="plain"> = </span><span class="identifier">number</span><span class="plain">;</span>
|
|
<span class="identifier">in</span><span class="plain">-></span><span class="element">name_gender</span><span class="plain"> = </span><span class="identifier">gender</span><span class="plain">;</span>
|
|
<span class="identifier">in</span><span class="plain">-></span><span class="element">next</span><span class="plain"> = </span><span class="identifier">NULL</span><span class="plain">;</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">names</span><span class="plain">-></span><span class="identifier">first_name</span><span class="plain"> == </span><span class="identifier">NULL</span><span class="plain">) </span><span class="identifier">names</span><span class="plain">-></span><span class="element">first_name</span><span class="plain"> = </span><span class="identifier">in</span><span class="plain">;</span>
|
|
<span class="reserved">else</span><span class="plain"> {</span>
|
|
<span class="reserved">individual_name</span><span class="plain"> *</span><span class="identifier">in2</span><span class="plain">;</span>
|
|
<span class="reserved">for</span><span class="plain"> (</span><span class="identifier">in2</span><span class="plain"> = </span><span class="identifier">names</span><span class="plain">-></span><span class="element">first_name</span><span class="plain">; ((</span><span class="identifier">in2</span><span class="plain">) && (</span><span class="identifier">in2</span><span class="plain">-></span><span class="element">next</span><span class="plain">)); </span><span class="identifier">in2</span><span class="plain"> = </span><span class="identifier">in2</span><span class="plain">-></span><span class="element">next</span><span class="plain">) ;</span>
|
|
<span class="identifier">in2</span><span class="plain">-></span><span class="element">next</span><span class="plain"> = </span><span class="identifier">in</span><span class="plain">;</span>
|
|
<span class="plain">}</span>
|
|
<span class="reserved">if</span><span class="plain"> ((</span><span class="identifier">pluralise</span><span class="plain">) && (</span><span class="identifier">number</span><span class="plain"> == </span><span class="constant">1</span><span class="plain">))</span>
|
|
<<span class="cwebmacro">Add plural names as well</span> <span class="cwebmacronumber">3.1</span>><span class="plain">;</span>
|
|
<span class="reserved">return</span><span class="plain"> </span><span class="identifier">in</span><span class="plain">;</span>
|
|
<span class="plain">}</span>
|
|
</pre>
|
|
|
|
<p class="inwebparagraph"></p>
|
|
|
|
<p class="inwebparagraph"><a id="SP3_1"></a><b>§3.1. </b>The following makes all possible plurals and registers those too. (Note
|
|
that every instance gets a plural name: even something palpably unique, like
|
|
"the Koh-i-Noor diamond".) The plural dictionary supports multiple plurals,
|
|
so there may be any number of names registered: for instance, the kind
|
|
"person" is registered with plurals "persons" and "people".
|
|
</p>
|
|
|
|
|
|
<p class="macrodefinition"><code class="display">
|
|
<<span class="cwebmacrodefn">Add plural names as well</span> <span class="cwebmacronumber">3.1</span>> =
|
|
</code></p>
|
|
|
|
|
|
<pre class="displaydefn">
|
|
<span class="reserved">plural_dictionary_entry</span><span class="plain"> *</span><span class="identifier">pde</span><span class="plain"> = </span><span class="identifier">NULL</span><span class="plain">;</span>
|
|
<span class="reserved">int</span><span class="plain"> </span><span class="identifier">k</span><span class="plain"> = </span><span class="constant">0</span><span class="plain">;</span>
|
|
<span class="reserved">do</span><span class="plain"> {</span>
|
|
<span class="identifier">k</span><span class="plain">++;</span>
|
|
<span class="identifier">wording</span><span class="plain"> </span><span class="identifier">PW</span><span class="plain"> = </span><span class="identifier">EMPTY_WORDING</span><span class="plain">;</span>
|
|
<span class="identifier">pde</span><span class="plain"> = </span><span class="functiontext"><a href="3-plr.html#SP3">Pluralisation::make</a></span><span class="plain">(</span><span class="identifier">W</span><span class="plain">, &</span><span class="identifier">PW</span><span class="plain">, </span><span class="identifier">pde</span><span class="plain">, </span><span class="identifier">nl</span><span class="plain">);</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">Wordings::nonempty</span><span class="plain">(</span><span class="identifier">PW</span><span class="plain">)) {</span>
|
|
<span class="identifier">LOGIF</span><span class="plain">(</span><span class="identifier">CONSTRUCTED_PLURALS</span><span class="plain">, </span><span class="string">"(%d) Reading plural of <%W> as <%W>\n"</span><span class="plain">, </span><span class="identifier">k</span><span class="plain">,</span>
|
|
<span class="identifier">W</span><span class="plain">, </span><span class="identifier">PW</span><span class="plain">);</span>
|
|
<span class="functiontext"><a href="#SP3">Clusters::add</a></span><span class="plain">(</span><span class="identifier">names</span><span class="plain">, </span><span class="identifier">PW</span><span class="plain">, </span><span class="identifier">nl</span><span class="plain">, </span><span class="identifier">gender</span><span class="plain">, </span><span class="constant">2</span><span class="plain">, </span><span class="identifier">FALSE</span><span class="plain">);</span>
|
|
<span class="plain">}</span>
|
|
<span class="plain">} </span><span class="reserved">while</span><span class="plain"> (</span><span class="identifier">pde</span><span class="plain">);</span>
|
|
</pre>
|
|
|
|
<p class="inwebparagraph"></p>
|
|
|
|
<p class="endnote">This code is used in <a href="#SP3">§3</a>.</p>
|
|
|
|
<p class="inwebparagraph"><a id="SP4"></a><b>§4. </b>The following is more suited to adjectives, or to words which are used
|
|
adjectivally, such as past participles in French. This time we generate all
|
|
possible gender and number agreements — except in English, where no variation
|
|
occurs: please don't argue about blond/blonde.
|
|
</p>
|
|
|
|
<p class="inwebparagraph">GNA is a traditional Inform term, standing for "gender-number-animation".
|
|
At run time, it's an integer from 0 to 11 which encodes all possible
|
|
combinations. Here we only work through six, ignoring animation:
|
|
</p>
|
|
|
|
<pre class="display">
|
|
<span class="reserved">void</span><span class="plain"> </span><span class="functiontext">Clusters::add_with_agreements<button class="popup" onclick="togglePopup('usagePopup15')">...<span class="popuptext" id="usagePopup15">Usage of <b>Clusters::add_with_agreements</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">name_cluster</span><span class="plain"> *</span><span class="identifier">cl</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="identifier">PREFORM_LANGUAGE_TYPE</span><span class="plain"> *</span><span class="identifier">nl</span><span class="plain">) {</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">nl</span><span class="plain"> == </span><span class="identifier">NULL</span><span class="plain">) </span><span class="identifier">nl</span><span class="plain"> = </span><span class="identifier">English_language</span><span class="plain">;</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">nl</span><span class="plain"> == </span><span class="identifier">English_language</span><span class="plain">) {</span>
|
|
<span class="functiontext"><a href="#SP3">Clusters::add</a></span><span class="plain">(</span><span class="identifier">cl</span><span class="plain">, </span><span class="identifier">W</span><span class="plain">, </span><span class="identifier">nl</span><span class="plain">, </span><span class="constant">NEUTER_GENDER</span><span class="plain">, </span><span class="constant">1</span><span class="plain">, </span><span class="identifier">FALSE</span><span class="plain">);</span>
|
|
<span class="plain">} </span><span class="reserved">else</span><span class="plain"> {</span>
|
|
<span class="reserved">int</span><span class="plain"> </span><span class="identifier">gna</span><span class="plain">;</span>
|
|
<span class="reserved">for</span><span class="plain"> (</span><span class="identifier">gna</span><span class="plain"> = </span><span class="constant">0</span><span class="plain">; </span><span class="identifier">gna</span><span class="plain"> < </span><span class="constant">6</span><span class="plain">; </span><span class="identifier">gna</span><span class="plain">++)</span>
|
|
<<span class="cwebmacro">Generate agreement form in this GNA and add to the declension</span> <span class="cwebmacronumber">4.1</span>><span class="plain">;</span>
|
|
<span class="plain">}</span>
|
|
<span class="plain">}</span>
|
|
</pre>
|
|
|
|
<p class="inwebparagraph"></p>
|
|
|
|
<p class="inwebparagraph"><a id="SP4_1"></a><b>§4.1. </b>We use tries to modify the base text, which is taken to be the neuter
|
|
singular form, into the other five forms.
|
|
</p>
|
|
|
|
|
|
<p class="macrodefinition"><code class="display">
|
|
<<span class="cwebmacrodefn">Generate agreement form in this GNA and add to the declension</span> <span class="cwebmacronumber">4.1</span>> =
|
|
</code></p>
|
|
|
|
|
|
<pre class="displaydefn">
|
|
<span class="identifier">nonterminal</span><span class="plain"> *</span><span class="identifier">step1</span><span class="plain"> = </span><span class="identifier">NULL</span><span class="plain">, *</span><span class="identifier">step2</span><span class="plain"> = </span><span class="identifier">NULL</span><span class="plain">;</span>
|
|
<span class="reserved">int</span><span class="plain"> </span><span class="identifier">form_number</span><span class="plain"> = </span><span class="constant">1</span><span class="plain">, </span><span class="identifier">form_gender</span><span class="plain"> = </span><span class="constant">NEUTER_GENDER</span><span class="plain">;</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">gna</span><span class="plain"> >= </span><span class="constant">3</span><span class="plain">) </span><span class="identifier">form_number</span><span class="plain"> = </span><span class="constant">2</span><span class="plain">;</span>
|
|
<span class="reserved">switch</span><span class="plain"> (</span><span class="identifier">gna</span><span class="plain">) {</span>
|
|
<span class="reserved">case</span><span class="plain"> </span><span class="constant">0</span><span class="plain">: </span><span class="identifier">step1</span><span class="plain"> = <</span><span class="identifier">adjective</span><span class="plain">-</span><span class="identifier">to</span><span class="plain">-</span><span class="identifier">masculine</span><span class="plain">-</span><span class="identifier">singular</span><span class="plain">>;</span>
|
|
<span class="identifier">form_gender</span><span class="plain"> = </span><span class="constant">MASCULINE_GENDER</span><span class="plain">; </span><span class="reserved">break</span><span class="plain">;</span>
|
|
<span class="reserved">case</span><span class="plain"> </span><span class="constant">1</span><span class="plain">: </span><span class="identifier">step1</span><span class="plain"> = <</span><span class="identifier">adjective</span><span class="plain">-</span><span class="identifier">to</span><span class="plain">-</span><span class="identifier">feminine</span><span class="plain">-</span><span class="identifier">singular</span><span class="plain">>;</span>
|
|
<span class="identifier">form_gender</span><span class="plain"> = </span><span class="constant">FEMININE_GENDER</span><span class="plain">; </span><span class="reserved">break</span><span class="plain">;</span>
|
|
<span class="reserved">case</span><span class="plain"> </span><span class="constant">2</span><span class="plain">: </span><span class="reserved">break</span><span class="plain">;</span>
|
|
<span class="reserved">case</span><span class="plain"> </span><span class="constant">3</span><span class="plain">: </span><span class="identifier">step1</span><span class="plain"> = <</span><span class="identifier">adjective</span><span class="plain">-</span><span class="identifier">to</span><span class="plain">-</span><span class="identifier">masculine</span><span class="plain">-</span><span class="identifier">singular</span><span class="plain">>;</span>
|
|
<span class="identifier">step2</span><span class="plain"> = <</span><span class="identifier">adjective</span><span class="plain">-</span><span class="identifier">to</span><span class="plain">-</span><span class="identifier">masculine</span><span class="plain">-</span><span class="identifier">plural</span><span class="plain">>;</span>
|
|
<span class="identifier">form_gender</span><span class="plain"> = </span><span class="constant">MASCULINE_GENDER</span><span class="plain">; </span><span class="reserved">break</span><span class="plain">;</span>
|
|
<span class="reserved">case</span><span class="plain"> </span><span class="constant">4</span><span class="plain">: </span><span class="identifier">step1</span><span class="plain"> = <</span><span class="identifier">adjective</span><span class="plain">-</span><span class="identifier">to</span><span class="plain">-</span><span class="identifier">feminine</span><span class="plain">-</span><span class="identifier">singular</span><span class="plain">>;</span>
|
|
<span class="identifier">step2</span><span class="plain"> = <</span><span class="identifier">adjective</span><span class="plain">-</span><span class="identifier">to</span><span class="plain">-</span><span class="identifier">feminine</span><span class="plain">-</span><span class="identifier">plural</span><span class="plain">>;</span>
|
|
<span class="identifier">form_gender</span><span class="plain"> = </span><span class="constant">FEMININE_GENDER</span><span class="plain">; </span><span class="reserved">break</span><span class="plain">;</span>
|
|
<span class="reserved">case</span><span class="plain"> </span><span class="constant">5</span><span class="plain">: </span><span class="identifier">step1</span><span class="plain"> = <</span><span class="identifier">adjective</span><span class="plain">-</span><span class="identifier">to</span><span class="plain">-</span><span class="identifier">plural</span><span class="plain">>; </span><span class="reserved">break</span><span class="plain">;</span>
|
|
<span class="plain">}</span>
|
|
<span class="identifier">wording</span><span class="plain"> </span><span class="identifier">FW</span><span class="plain"> = </span><span class="identifier">EMPTY_WORDING</span><span class="plain">;</span>
|
|
<<span class="cwebmacro">Process via the agreement trie in this pipeline</span> <span class="cwebmacronumber">4.1.1</span>><span class="plain">;</span>
|
|
<span class="functiontext"><a href="#SP3">Clusters::add</a></span><span class="plain">(</span><span class="identifier">cl</span><span class="plain">, </span><span class="identifier">FW</span><span class="plain">, </span><span class="identifier">nl</span><span class="plain">, </span><span class="identifier">form_gender</span><span class="plain">, </span><span class="identifier">form_number</span><span class="plain">, </span><span class="identifier">FALSE</span><span class="plain">);</span>
|
|
</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_1_1"></a><b>§4.1.1. </b>Not much of a pipeline, really: we start with the base case and work
|
|
through one or two tries.
|
|
</p>
|
|
|
|
|
|
<p class="macrodefinition"><code class="display">
|
|
<<span class="cwebmacrodefn">Process via the agreement trie in this pipeline</span> <span class="cwebmacronumber">4.1.1</span>> =
|
|
</code></p>
|
|
|
|
|
|
<pre class="displaydefn">
|
|
<span class="identifier">word_assemblage</span><span class="plain"> </span><span class="identifier">wa</span><span class="plain"> = </span><span class="identifier">WordAssemblages::from_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">step1</span><span class="plain">)</span>
|
|
<span class="identifier">wa</span><span class="plain"> = </span><span class="functiontext"><a href="2-tai.html#SP2">Inflections::apply_trie_to_wa</a></span><span class="plain">(</span><span class="identifier">wa</span><span class="plain">,</span>
|
|
<span class="functiontext"><a href="2-np.html#SP7">Preform::Nonparsing::define_trie</a></span><span class="plain">(</span><span class="identifier">step1</span><span class="plain">, </span><span class="identifier">TRIE_END</span><span class="plain">, </span><span class="identifier">nl</span><span class="plain">));</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">step2</span><span class="plain">)</span>
|
|
<span class="identifier">wa</span><span class="plain"> = </span><span class="functiontext"><a href="2-tai.html#SP2">Inflections::apply_trie_to_wa</a></span><span class="plain">(</span><span class="identifier">wa</span><span class="plain">,</span>
|
|
<span class="functiontext"><a href="2-np.html#SP7">Preform::Nonparsing::define_trie</a></span><span class="plain">(</span><span class="identifier">step2</span><span class="plain">, </span><span class="identifier">TRIE_END</span><span class="plain">, </span><span class="identifier">nl</span><span class="plain">));</span>
|
|
<span class="identifier">FW</span><span class="plain"> = </span><span class="identifier">WordAssemblages::to_wording</span><span class="plain">(&</span><span class="identifier">wa</span><span class="plain">);</span>
|
|
</pre>
|
|
|
|
<p class="inwebparagraph"></p>
|
|
|
|
<p class="endnote">This code is used in <a href="#SP4_1">§4.1</a>.</p>
|
|
|
|
<p class="inwebparagraph"><a id="SP5"></a><b>§5. Plural fixing. </b>Less elegantly, we can force the plural of a name in a cluster to a given
|
|
fixed text, overwriting it if it's already there. In practice this is done
|
|
only when the built-in kinds are being given plural names; some of these
|
|
(those for kind constructors with optional wordings) have a peculiar format,
|
|
and wouldn't pass through the pluralising tries intact.
|
|
</p>
|
|
|
|
<pre class="display">
|
|
<span class="reserved">void</span><span class="plain"> </span><span class="functiontext">Clusters::set_plural_name<button class="popup" onclick="togglePopup('usagePopup16')">...<span class="popuptext" id="usagePopup16">Usage of <b>Clusters::set_plural_name</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">name_cluster</span><span class="plain"> *</span><span class="identifier">cl</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="identifier">PREFORM_LANGUAGE_TYPE</span><span class="plain"> *</span><span class="identifier">nl</span><span class="plain">) {</span>
|
|
<span class="reserved">individual_name</span><span class="plain"> *</span><span class="identifier">in</span><span class="plain">;</span>
|
|
<span class="reserved">for</span><span class="plain"> (</span><span class="identifier">in</span><span class="plain"> = </span><span class="identifier">cl</span><span class="plain">-></span><span class="element">first_name</span><span class="plain">; </span><span class="identifier">in</span><span class="plain">; </span><span class="identifier">in</span><span class="plain"> = </span><span class="identifier">in</span><span class="plain">-></span><span class="element">next</span><span class="plain">)</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">in</span><span class="plain">-></span><span class="element">name_number</span><span class="plain"> == </span><span class="constant">2</span><span class="plain">) {</span>
|
|
<span class="identifier">in</span><span class="plain">-></span><span class="element">name</span><span class="plain"> = </span><span class="functiontext"><a href="3-dcl.html#SP2">Declensions::decline</a></span><span class="plain">(</span><span class="identifier">W</span><span class="plain">, </span><span class="identifier">nl</span><span class="plain">, </span><span class="constant">NEUTER_GENDER</span><span class="plain">, </span><span class="constant">2</span><span class="plain">);</span>
|
|
<span class="reserved">return</span><span class="plain">;</span>
|
|
<span class="plain">}</span>
|
|
<span class="functiontext"><a href="#SP3">Clusters::add</a></span><span class="plain">(</span><span class="identifier">cl</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="constant">NEUTER_GENDER</span><span class="plain">, </span><span class="constant">2</span><span class="plain">, </span><span class="identifier">FALSE</span><span class="plain">);</span>
|
|
<span class="plain">}</span>
|
|
</pre>
|
|
|
|
<p class="inwebparagraph"></p>
|
|
|
|
<p class="inwebparagraph"><a id="SP6"></a><b>§6. Searching declensions. </b>These are always quite small, so there's no need for any efficient device
|
|
to search them.
|
|
</p>
|
|
|
|
<p class="inwebparagraph">The first routine finds the earliest name with the correct number (singular
|
|
or plural):
|
|
</p>
|
|
|
|
<pre class="display">
|
|
<span class="identifier">wording</span><span class="plain"> </span><span class="functiontext">Clusters::get_name<button class="popup" onclick="togglePopup('usagePopup17')">...<span class="popuptext" id="usagePopup17">Usage of <b>Clusters::get_name</b>:<br><a href="#SP7">§7</a></span></button></span><span class="plain">(</span><span class="reserved">name_cluster</span><span class="plain"> *</span><span class="identifier">cl</span><span class="plain">, </span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">plural_flag</span><span class="plain">) {</span>
|
|
<span class="reserved">int</span><span class="plain"> </span><span class="identifier">number_sought</span><span class="plain"> = </span><span class="constant">1</span><span class="plain">;</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">plural_flag</span><span class="plain">) </span><span class="identifier">number_sought</span><span class="plain"> = </span><span class="constant">2</span><span class="plain">;</span>
|
|
<span class="reserved">individual_name</span><span class="plain"> *</span><span class="identifier">in</span><span class="plain">;</span>
|
|
<span class="reserved">for</span><span class="plain"> (</span><span class="identifier">in</span><span class="plain"> = </span><span class="identifier">cl</span><span class="plain">-></span><span class="element">first_name</span><span class="plain">; </span><span class="identifier">in</span><span class="plain">; </span><span class="identifier">in</span><span class="plain"> = </span><span class="identifier">in</span><span class="plain">-></span><span class="element">next</span><span class="plain">)</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">in</span><span class="plain">-></span><span class="element">name_number</span><span class="plain"> == </span><span class="identifier">number_sought</span><span class="plain">)</span>
|
|
<span class="reserved">return</span><span class="plain"> </span><span class="functiontext"><a href="3-dcl.html#SP3">Declensions::in_case</a></span><span class="plain">(&(</span><span class="identifier">in</span><span class="plain">-></span><span class="element">name</span><span class="plain">), </span><span class="constant">NOMINATIVE_CASE</span><span class="plain">);</span>
|
|
<span class="reserved">return</span><span class="plain"> </span><span class="identifier">EMPTY_WORDING</span><span class="plain">;</span>
|
|
<span class="plain">}</span>
|
|
</pre>
|
|
|
|
<p class="inwebparagraph"></p>
|
|
|
|
<p class="inwebparagraph"><a id="SP7"></a><b>§7. </b>The following variant finds the earliest name in the language of play,
|
|
falling back on English if there's none registered:
|
|
</p>
|
|
|
|
<pre class="display">
|
|
<span class="identifier">wording</span><span class="plain"> </span><span class="functiontext">Clusters::get_name_in_play<button class="popup" onclick="togglePopup('usagePopup18')">...<span class="popuptext" id="usagePopup18">Usage of <b>Clusters::get_name_in_play</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">name_cluster</span><span class="plain"> *</span><span class="identifier">cl</span><span class="plain">, </span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">plural_flag</span><span class="plain">, </span><span class="identifier">PREFORM_LANGUAGE_TYPE</span><span class="plain"> *</span><span class="identifier">nl</span><span class="plain">) {</span>
|
|
<span class="reserved">int</span><span class="plain"> </span><span class="identifier">number_sought</span><span class="plain"> = </span><span class="constant">1</span><span class="plain">;</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">plural_flag</span><span class="plain">) </span><span class="identifier">number_sought</span><span class="plain"> = </span><span class="constant">2</span><span class="plain">;</span>
|
|
<span class="reserved">individual_name</span><span class="plain"> *</span><span class="identifier">in</span><span class="plain">;</span>
|
|
<span class="reserved">for</span><span class="plain"> (</span><span class="identifier">in</span><span class="plain"> = </span><span class="identifier">cl</span><span class="plain">-></span><span class="element">first_name</span><span class="plain">; </span><span class="identifier">in</span><span class="plain">; </span><span class="identifier">in</span><span class="plain"> = </span><span class="identifier">in</span><span class="plain">-></span><span class="element">next</span><span class="plain">)</span>
|
|
<span class="reserved">if</span><span class="plain"> ((</span><span class="identifier">in</span><span class="plain">-></span><span class="element">name_number</span><span class="plain"> == </span><span class="identifier">number_sought</span><span class="plain">) &&</span>
|
|
<span class="plain">(</span><span class="identifier">in</span><span class="plain">-></span><span class="element">name_language</span><span class="plain"> == </span><span class="identifier">nl</span><span class="plain">))</span>
|
|
<span class="reserved">return</span><span class="plain"> </span><span class="functiontext"><a href="3-dcl.html#SP3">Declensions::in_case</a></span><span class="plain">(&(</span><span class="identifier">in</span><span class="plain">-></span><span class="element">name</span><span class="plain">), </span><span class="constant">NOMINATIVE_CASE</span><span class="plain">);</span>
|
|
<span class="reserved">return</span><span class="plain"> </span><span class="functiontext"><a href="#SP6">Clusters::get_name</a></span><span class="plain">(</span><span class="identifier">cl</span><span class="plain">, </span><span class="identifier">plural_flag</span><span class="plain">);</span>
|
|
<span class="plain">}</span>
|
|
</pre>
|
|
|
|
<p class="inwebparagraph"></p>
|
|
|
|
<p class="inwebparagraph"><a id="SP8"></a><b>§8. </b>A more specific search, which can optionally test for number and gender.
|
|
</p>
|
|
|
|
<pre class="display">
|
|
<span class="identifier">wording</span><span class="plain"> </span><span class="functiontext">Clusters::get_name_general<button class="popup" onclick="togglePopup('usagePopup19')">...<span class="popuptext" id="usagePopup19">Usage of <b>Clusters::get_name_general</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">name_cluster</span><span class="plain"> *</span><span class="identifier">cl</span><span class="plain">,</span>
|
|
<span class="identifier">PREFORM_LANGUAGE_TYPE</span><span class="plain"> *</span><span class="identifier">nl</span><span class="plain">, </span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">number_sought</span><span class="plain">, </span><span class="reserved">int</span><span class="plain"> </span><span class="identifier">gender_sought</span><span class="plain">) {</span>
|
|
<span class="reserved">individual_name</span><span class="plain"> *</span><span class="identifier">in</span><span class="plain">;</span>
|
|
<span class="reserved">for</span><span class="plain"> (</span><span class="identifier">in</span><span class="plain"> = </span><span class="identifier">cl</span><span class="plain">-></span><span class="element">first_name</span><span class="plain">; </span><span class="identifier">in</span><span class="plain">; </span><span class="identifier">in</span><span class="plain"> = </span><span class="identifier">in</span><span class="plain">-></span><span class="element">next</span><span class="plain">)</span>
|
|
<span class="reserved">if</span><span class="plain"> (((</span><span class="identifier">number_sought</span><span class="plain"> == -1) || (</span><span class="identifier">number_sought</span><span class="plain"> == </span><span class="identifier">in</span><span class="plain">-></span><span class="element">name_number</span><span class="plain">)) &&</span>
|
|
<span class="plain">((</span><span class="identifier">gender_sought</span><span class="plain"> == -1) || (</span><span class="identifier">gender_sought</span><span class="plain"> == </span><span class="identifier">in</span><span class="plain">-></span><span class="element">name_gender</span><span class="plain">)) &&</span>
|
|
<span class="plain">(</span><span class="identifier">in</span><span class="plain">-></span><span class="element">name_language</span><span class="plain"> == </span><span class="identifier">nl</span><span class="plain">))</span>
|
|
<span class="reserved">return</span><span class="plain"> </span><span class="functiontext"><a href="3-dcl.html#SP3">Declensions::in_case</a></span><span class="plain">(&(</span><span class="identifier">in</span><span class="plain">-></span><span class="element">name</span><span class="plain">), </span><span class="constant">NOMINATIVE_CASE</span><span class="plain">);</span>
|
|
<span class="reserved">return</span><span class="plain"> </span><span class="identifier">EMPTY_WORDING</span><span class="plain">;</span>
|
|
<span class="plain">}</span>
|
|
</pre>
|
|
|
|
<p class="inwebparagraph"></p>
|
|
|
|
<p class="inwebparagraph"><a id="SP9"></a><b>§9. Meanings. </b>We will come to how excerpts of text are given meanings later on. For now, it's
|
|
enough to say that each individual name can have one, and that the pointer
|
|
to an <code class="display"><span class="extract">excerpt_meaning</span></code> records it.
|
|
</p>
|
|
|
|
<pre class="display">
|
|
<span class="reserved">void</span><span class="plain"> </span><span class="functiontext">Clusters::set_principal_meaning<button class="popup" onclick="togglePopup('usagePopup20')">...<span class="popuptext" id="usagePopup20">Usage of <b>Clusters::set_principal_meaning</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">individual_name</span><span class="plain"> *</span><span class="identifier">in</span><span class="plain">, </span><span class="identifier">general_pointer</span><span class="plain"> </span><span class="identifier">meaning</span><span class="plain">) {</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">in</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 individual name"</span><span class="plain">);</span>
|
|
<span class="identifier">in</span><span class="plain">-></span><span class="element">principal_meaning</span><span class="plain"> = </span><span class="identifier">meaning</span><span class="plain">;</span>
|
|
<span class="plain">}</span>
|
|
|
|
<span class="identifier">general_pointer</span><span class="plain"> </span><span class="functiontext">Clusters::get_principal_meaning<button class="popup" onclick="togglePopup('usagePopup21')">...<span class="popuptext" id="usagePopup21">Usage of <b>Clusters::get_principal_meaning</b>:<br>none</span></button></span><span class="plain">(</span><span class="reserved">name_cluster</span><span class="plain"> *</span><span class="identifier">cl</span><span class="plain">) {</span>
|
|
<span class="reserved">if</span><span class="plain"> (</span><span class="identifier">cl</span><span class="plain">-></span><span class="element">first_name</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_GENERAL_POINTER</span><span class="plain">;</span>
|
|
<span class="reserved">return</span><span class="plain"> </span><span class="identifier">cl</span><span class="plain">-></span><span class="identifier">first_name</span><span class="plain">-></span><span class="element">principal_meaning</span><span class="plain">;</span>
|
|
<span class="plain">}</span>
|
|
</pre>
|
|
|
|
<p class="inwebparagraph"></p>
|
|
|
|
<hr class="tocbar">
|
|
<ul class="toc"><li><a href="2-tai.html">Back to 'Tries and Inflections'</a></li><li><i>(This section ends Chapter 2: Machinery.)</i></li></ul><hr class="tocbar">
|
|
<!--End of weave-->
|
|
<script>
|
|
function togglePopup(material_id) {
|
|
var popup = document.getElementById(material_id);
|
|
popup.classList.toggle("show");
|
|
}
|
|
</script>
|
|
|
|
<link href="Popups.css" rel="stylesheet" rev="stylesheet" type="text/css">
|
|
</main>
|
|
</body>
|
|
</html>
|
|
|