collections.html
api/sleela/3.1/version-027/package/collections.html · 339 line(s) · html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Package collections — SleelaDoc API</title>
<link rel="stylesheet" href="../style.css">
</head>
<body>
<header class="top">
<div class="brand"><a href="../index.html">SleelaDoc API</a></div>
<div class="tag">HTML documentation for the SLeeLa standard library (/lib)</div>
</header>
<div class="wrap">
<nav class="side">
<a href="../index.html"><strong>Home</strong></a>
<a href="../packages.html"><strong>All packages</strong></a>
<a href="../glossary.html"><strong>Glossary</strong></a>
<a href="../authorship.html"><strong>Authorship</strong></a>
<h2>Packages</h2><ul>
<li><a href="../package/advantage.html">advantage</a></li>
<li><a href="../package/alphabet.html">alphabet</a></li>
<li><a href="../package/antivirus.html">antivirus</a></li>
<li><a href="../package/api.html">api</a></li>
<li><a href="../package/array.html">array</a></li>
<li><a href="../package/audio.html">audio</a></li>
<li><a href="../package/autocad.html">autocad</a></li>
<li><a href="../package/ballum.html">ballum</a></li>
<li><a href="../package/bash.html">bash</a></li>
<li><a href="../package/boolean.html">boolean</a></li>
<li><a href="../package/cdma.html">cdma</a></li>
<li><a href="../package/char.html">char</a></li>
<li><a href="../package/character.html">character</a></li>
<li><a href="../package/character-recognition.html">character-recognition</a></li>
<li><a href="../package/churn.html">churn</a></li>
<li><a href="../package/citizen.html">citizen</a></li>
<li><a href="../package/codecs.html">codecs</a></li>
<li><a href="../package/collections.html">collections</a></li>
<li><a href="../package/common-rails.html">common-rails</a></li>
<li><a href="../package/compiler.html">compiler</a></li>
<li><a href="../package/compression.html">compression</a></li>
<li><a href="../package/config.html">config</a></li>
<li><a href="../package/connector.html">connector</a></li>
<li><a href="../package/coorenagraph.html">coorenagraph</a></li>
<li><a href="../package/core.html">core</a></li>
<li><a href="../package/cpu.html">cpu</a></li>
<li><a href="../package/crypto.html">crypto</a></li>
<li><a href="../package/data.html">data</a></li>
<li><a href="../package/data-structures.html">data-structures</a></li>
<li><a href="../package/database.html">database</a></li>
<li><a href="../package/debugger.html">debugger</a></li>
<li><a href="../package/decompiler.html">decompiler</a></li>
<li><a href="../package/deliberation.html">deliberation</a></li>
<li><a href="../package/drivers.html">drivers</a></li>
<li><a href="../package/examples.html">examples</a></li>
<li><a href="../package/filesystem.html">filesystem</a></li>
<li><a href="../package/gameplay.html">gameplay</a></li>
<li><a href="../package/governance.html">governance</a></li>
<li><a href="../package/gui.html">gui</a></li>
<li><a href="../package/guidoc.html">guidoc</a></li>
<li><a href="../package/hotlink.html">hotlink</a></li>
<li><a href="../package/html.html">html</a></li>
<li><a href="../package/http.html">http</a></li>
<li><a href="../package/http-1.0.html">http-1.0</a></li>
<li><a href="../package/http-2.0.html">http-2.0</a></li>
<li><a href="../package/http-3.0.html">http-3.0</a></li>
<li><a href="../package/http-4.0.html">http-4.0</a></li>
<li><a href="../package/http-5.0.html">http-5.0</a></li>
<li><a href="../package/http-6.0.html">http-6.0</a></li>
<li><a href="../package/http-7.0.html">http-7.0</a></li>
<li><a href="../package/http-8.0.html">http-8.0</a></li>
<li><a href="../package/http-9.0.html">http-9.0</a></li>
<li><a href="../package/http-servers.html">http-servers</a></li>
<li><a href="../package/ide.html">ide</a></li>
<li><a href="../package/ide-workbench.html">ide-workbench</a></li>
<li><a href="../package/idea.html">idea</a></li>
<li><a href="../package/inference-model.html">inference-model</a></li>
<li><a href="../package/inputs.html">inputs</a></li>
<li><a href="../package/international-criminal-court.html">international-criminal-court</a></li>
<li><a href="../package/io.html">io</a></li>
<li><a href="../package/java.html">java</a></li>
<li><a href="../package/java28.html">java28</a></li>
<li><a href="../package/journey.html">journey</a></li>
<li><a href="../package/languages.html">languages</a></li>
<li><a href="../package/large-language-models.html">large-language-models</a></li>
<li><a href="../package/ledger.html">ledger</a></li>
<li><a href="../package/linux-editors.html">linux-editors</a></li>
<li><a href="../package/manifesto.html">manifesto</a></li>
<li><a href="../package/math.html">math</a></li>
<li><a href="../package/memory.html">memory</a></li>
<li><a href="../package/modules.html">modules</a></li>
<li><a href="../package/moral-capacitor.html">moral-capacitor</a></li>
<li><a href="../package/munction.html">munction</a></li>
<li><a href="../package/native.html">native</a></li>
<li><a href="../package/net.html">net</a></li>
<li><a href="../package/neural-nets.html">neural-nets</a></li>
<li><a href="../package/nordshrift.html">nordshrift</a></li>
<li><a href="../package/observer.html">observer</a></li>
<li><a href="../package/opcodes.html">opcodes</a></li>
<li><a href="../package/operating-system.html">operating-system</a></li>
<li><a href="../package/os-level-support.html">os-level-support</a></li>
<li><a href="../package/philosophers.html">philosophers</a></li>
<li><a href="../package/philosophy.html">philosophy</a></li>
<li><a href="../package/politico.html">politico</a></li>
<li><a href="../package/process.html">process</a></li>
<li><a href="../package/psychiatry.html">psychiatry</a></li>
<li><a href="../package/public.html">public</a></li>
<li><a href="../package/reflection.html">reflection</a></li>
<li><a href="../package/regex.html">regex</a></li>
<li><a href="../package/registry.html">registry</a></li>
<li><a href="../package/rmi.html">rmi</a></li>
<li><a href="../package/rrs.html">rrs</a></li>
<li><a href="../package/runtime.html">runtime</a></li>
<li><a href="../package/security.html">security</a></li>
<li><a href="../package/server-edition.html">server-edition</a></li>
<li><a href="../package/signal-processing.html">signal-processing</a></li>
<li><a href="../package/sldocument.html">sldocument</a></li>
<li><a href="../package/sleela.html">sleela</a></li>
<li><a href="../package/sleela-sql.html">sleela-sql</a></li>
<li><a href="../package/sleela-terminal.html">sleela-terminal</a></li>
<li><a href="../package/sleeladoc.html">sleeladoc</a></li>
<li><a href="../package/slrtp.html">slrtp</a></li>
<li><a href="../package/social-model.html">social-model</a></li>
<li><a href="../package/softlisten.html">softlisten</a></li>
<li><a href="../package/sommeliers.html">sommeliers</a></li>
<li><a href="../package/spatial.html">spatial</a></li>
<li><a href="../package/sst.html">sst</a></li>
<li><a href="../package/synchro.html">synchro</a></li>
<li><a href="../package/systems.html">systems</a></li>
<li><a href="../package/telephony-skya.html">telephony-skya</a></li>
<li><a href="../package/terminal.html">terminal</a></li>
<li><a href="../package/terminal_pixel.html">terminal_pixel</a></li>
<li><a href="../package/text.html">text</a></li>
<li><a href="../package/ui.html">ui</a></li>
<li><a href="../package/us-infrastructure.html">us-infrastructure</a></li>
<li><a href="../package/user-interface.html">user-interface</a></li>
<li><a href="../package/video.html">video</a></li>
<li><a href="../package/vm.html">vm</a></li>
<li><a href="../package/web-server-technology.html">web-server-technology</a></li>
<li><a href="../package/website.html">website</a></li>
<li><a href="../package/wifi.html">wifi</a></li>
<li><a href="../package/xlt.html">xlt</a></li>
<li><a href="../package/xml.html">xml</a></li>
</ul>
</nav>
<main>
<div class="crumbs"><a href="../index.html">Home</a> › <a href="../packages.html">Packages</a> › collections</div>
<h1>Package <code>collections</code></h1>
<div class="lead">This package contains <strong>9</strong> source unit(s) defining <strong>9</strong> class(es) / struct(s). Each unit below lists its fields (the values it stores) and methods (the actions it performs), with a plain explanation of each.</div>
<input class="search" placeholder="Filter on this page (Ctrl+F also works)…" oninput="flt(this.value)">
<h2 class="section" data-u="slarray">SLArray <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/collections/SLArray.sleela)</span></h2>
<div data-u="slarray slarray">
<h3 id="SLArray">SLArray <span class="pill">class</span></h3>
<p class="desc">A concrete, fixed-capacity, bounds-safe String array wrapper built directly on the VM-managed native array primitive. Unlike SLList, the logical length equals the capacity: every slot is addressable from construction and defaults to null. This first implementation deliberately avoids Generics and mirrors the storage discipline of SLList.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>values</code></td><td><span class="sig">String[] values = new String[0]</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>size</code></td><td><span class="sig">int size = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>allocate</code></td><td><span class="sig">void allocate(int n)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>length</code></td><td><span class="sig">int length()</span></td><td class="desc">Number of addressable slots.</td></tr>
<tr><td><code>empty</code></td><td><span class="sig">boolean empty()</span></td><td class="desc">True when there are no slots.</td></tr>
<tr><td><code>inBounds</code></td><td><span class="sig">boolean inBounds(int index)</span></td><td class="desc">True when index addresses a real slot.</td></tr>
<tr><td><code>get</code></td><td><span class="sig">String get(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>set</code></td><td><span class="sig">boolean set(int index, String value)</span></td><td class="desc">Write the slot at index; returns false when the index is out of range.</td></tr>
<tr><td><code>fill</code></td><td><span class="sig">void fill(String value)</span></td><td class="desc">Set every slot to value.</td></tr>
<tr><td><code>clear</code></td><td><span class="sig">void clear()</span></td><td class="desc">Set every slot back to null.</td></tr>
<tr><td><code>indexOf</code></td><td><span class="sig">int indexOf(String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>contains</code></td><td><span class="sig">boolean contains(String value)</span></td><td class="desc">True when value is present at any slot.</td></tr>
<tr><td><code>reverse</code></td><td><span class="sig">void reverse()</span></td><td class="desc">Reverse the contents of the array in place.</td></tr>
<tr><td><code>copyTo</code></td><td><span class="sig">int copyTo(SLArray dest, int srcPos, int destPos, int length)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>toList</code></td><td><span class="sig">SLList toList()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="sliterator">SLIterator <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/collections/SLIterator.sleela)</span></h2>
<div data-u="sliterator sliterator">
<h3 id="SLIterator">SLIterator <span class="pill">class</span></h3>
<p class="desc">Defines the SLeeLa standard-library type SLIterator used within the collections library family.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
</div>
<h2 class="section" data-u="sllist">SLList <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/collections/SLList.sleela)</span></h2>
<div data-u="sllist sllist">
<h3 id="SLList">SLList <span class="pill">class</span></h3>
<p class="desc">A concrete, string-valued list with stable order and bounded index behavior. This first implementation deliberately avoids Generics.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>values</code></td><td><span class="sig">String[] values = new String[0]</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>size</code></td><td><span class="sig">int size = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>add</code></td><td><span class="sig">void add(String value)</span></td><td class="desc">Append one String. Existing capacity is reused after removals.</td></tr>
<tr><td><code>get</code></td><td><span class="sig">String get(int index)</span></td><td class="desc">Return null for an invalid index; valid indices are 0 through length()-1.</td></tr>
<tr><td><code>set</code></td><td><span class="sig">boolean set(int index, String value)</span></td><td class="desc">Replace a value; return false when the index is invalid.</td></tr>
<tr><td><code>removeAt</code></td><td><span class="sig">boolean removeAt(int index)</span></td><td class="desc">Remove at index and preserve the order of remaining values.</td></tr>
<tr><td><code>remove</code></td><td><span class="sig">void remove()</span></td><td class="desc">Compatibility convenience: remove the final item, if present.</td></tr>
<tr><td><code>clear</code></td><td><span class="sig">void clear()</span></td><td class="desc">Clear the logical list; capacity remains available for reuse.</td></tr>
<tr><td><code>length</code></td><td><span class="sig">int length()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>empty</code></td><td><span class="sig">boolean empty()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slmap">SLMap <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/collections/SLMap.sleela)</span></h2>
<div data-u="slmap slmap">
<h3 id="SLMap">SLMap <span class="pill">class</span></h3>
<p class="desc">A concrete, String-keyed, String-valued map backed by two parallel VM-managed growable native arrays (keys and values at matching indices). Keys are unique; lookup is a linear scan (suited to small-to-moderate maps). Deliberately avoids Generics.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>keys</code></td><td><span class="sig">String[] keys = new String[0]</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>vals</code></td><td><span class="sig">String[] vals = new String[0]</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>size</code></td><td><span class="sig">int size = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>indexOfKey</code></td><td><span class="sig">int indexOfKey(String key)</span></td><td class="desc">Index of key, or -1 when absent. A null key is never stored.</td></tr>
<tr><td><code>containsKey</code></td><td><span class="sig">boolean containsKey(String key)</span></td><td class="desc">True when key is present.</td></tr>
<tr><td><code>put</code></td><td><span class="sig">boolean put(String key, String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>get</code></td><td><span class="sig">String get(String key)</span></td><td class="desc">Value associated with key, or null when the key is absent.</td></tr>
<tr><td><code>removeKey</code></td><td><span class="sig">boolean removeKey(String key)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>keyAt</code></td><td><span class="sig">String keyAt(int index)</span></td><td class="desc">Key at the given insertion-order index, or null when out of range.</td></tr>
<tr><td><code>valueAt</code></td><td><span class="sig">String valueAt(int index)</span></td><td class="desc">Value at the given insertion-order index, or null when out of range.</td></tr>
<tr><td><code>clear</code></td><td><span class="sig">void clear()</span></td><td class="desc">Drop every entry; capacity remains available for reuse.</td></tr>
<tr><td><code>length</code></td><td><span class="sig">int length()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>empty</code></td><td><span class="sig">boolean empty()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slqueue">SLQueue <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/collections/SLQueue.sleela)</span></h2>
<div data-u="slqueue slqueue">
<h3 id="SLQueue">SLQueue <span class="pill">class</span></h3>
<p class="desc">A concrete, String-valued FIFO queue backed by the VM-managed growable native array. enqueue appends to the tail; dequeue removes from the head. A head cursor avoids shifting on every dequeue; storage is compacted when the dead prefix dominates. Deliberately avoids Generics.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>values</code></td><td><span class="sig">String[] values = new String[0]</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>head</code></td><td><span class="sig">int head = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>tail</code></td><td><span class="sig">int tail = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>compact</code></td><td><span class="sig">void compact()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>enqueue</code></td><td><span class="sig">void enqueue(String value)</span></td><td class="desc">Append one value to the tail. Freed capacity is reused after dequeues.</td></tr>
<tr><td><code>front</code></td><td><span class="sig">String front()</span></td><td class="desc">Return the head value without removing it; null when empty.</td></tr>
<tr><td><code>dequeue</code></td><td><span class="sig">String dequeue()</span></td><td class="desc">Remove and return the head value; null when empty.</td></tr>
<tr><td><code>add</code></td><td><span class="sig">void add(String value)</span></td><td class="desc">Compatibility convenience: enqueue defers to add for a uniform API.</td></tr>
<tr><td><code>remove</code></td><td><span class="sig">void remove()</span></td><td class="desc">Compatibility convenience: discard the head item, if present.</td></tr>
<tr><td><code>clear</code></td><td><span class="sig">void clear()</span></td><td class="desc">Drop every item; capacity remains available for reuse.</td></tr>
<tr><td><code>length</code></td><td><span class="sig">int length()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>empty</code></td><td><span class="sig">boolean empty()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slrange">SLRange <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/collections/SLRange.sleela)</span></h2>
<div data-u="slrange slrange">
<h3 id="SLRange">SLRange <span class="pill">class</span></h3>
<p class="desc">Defines the SLeeLa standard-library type SLRange used within the collections library family.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
</div>
<h2 class="section" data-u="slset">SLSet <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/collections/SLSet.sleela)</span></h2>
<div data-u="slset slset">
<h3 id="SLSet">SLSet <span class="pill">class</span></h3>
<p class="desc">A concrete, String-valued set with no duplicate members, backed by the VM-managed growable native array. Membership and insertion are linear scans (suited to small-to-moderate sets); order of iteration is insertion order. This first implementation deliberately avoids Generics.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>values</code></td><td><span class="sig">String[] values = new String[0]</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>size</code></td><td><span class="sig">int size = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>indexOf</code></td><td><span class="sig">int indexOf(String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>contains</code></td><td><span class="sig">boolean contains(String value)</span></td><td class="desc">True when value is a member.</td></tr>
<tr><td><code>add</code></td><td><span class="sig">boolean add(String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>discard</code></td><td><span class="sig">boolean discard(String value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>at</code></td><td><span class="sig">String at(int index)</span></td><td class="desc">Member at the given insertion-order index, or null when out of range.</td></tr>
<tr><td><code>remove</code></td><td><span class="sig">void remove()</span></td><td class="desc">Compatibility convenience: drop one member (the last), if present.</td></tr>
<tr><td><code>clear</code></td><td><span class="sig">void clear()</span></td><td class="desc">Drop every member; capacity remains available for reuse.</td></tr>
<tr><td><code>length</code></td><td><span class="sig">int length()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>empty</code></td><td><span class="sig">boolean empty()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slstack">SLStack <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/collections/SLStack.sleela)</span></h2>
<div data-u="slstack slstack">
<h3 id="SLStack">SLStack <span class="pill">class</span></h3>
<p class="desc">A concrete, String-valued LIFO stack backed by the VM-managed growable native array. push appends; pop and peek address the top. This first implementation deliberately avoids Generics.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>values</code></td><td><span class="sig">String[] values = new String[0]</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>size</code></td><td><span class="sig">int size = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>push</code></td><td><span class="sig">void push(String value)</span></td><td class="desc">Push one value onto the top. Freed capacity is reused after pops.</td></tr>
<tr><td><code>peek</code></td><td><span class="sig">String peek()</span></td><td class="desc">Return the top value without removing it; null when empty.</td></tr>
<tr><td><code>pop</code></td><td><span class="sig">String pop()</span></td><td class="desc">Remove and return the top value; null when empty.</td></tr>
<tr><td><code>add</code></td><td><span class="sig">void add(String value)</span></td><td class="desc">Compatibility convenience: push defers to add for a uniform collection API.</td></tr>
<tr><td><code>remove</code></td><td><span class="sig">void remove()</span></td><td class="desc">Compatibility convenience: discard the top item, if present.</td></tr>
<tr><td><code>clear</code></td><td><span class="sig">void clear()</span></td><td class="desc">Drop every item; capacity remains available for reuse.</td></tr>
<tr><td><code>length</code></td><td><span class="sig">int length()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>empty</code></td><td><span class="sig">boolean empty()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<h2 class="section" data-u="slvaluelist">SLValueList <span class="pill syntax">#sleela 2.5</span> <span class="muted" style="font-size:13px">(lib/collections/SLValueList.sleela)</span></h2>
<div data-u="slvaluelist slvaluelist">
<h3 id="SLValueList">SLValueList <span class="pill">class</span></h3>
<p class="desc">a non-generic heterogeneous list for VM values.</p>
<div class="meta-note">Carries the standard <strong>Metadata Class record</strong> — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.</div>
<p class="muted"><strong>Fields</strong> — the named values this unit stores.</p>
<table class="members"><tr><th>Field</th><th>Declaration</th><th>What it holds</th></tr>
<tr><td><code>values</code></td><td><span class="sig">Any[] values = new Any[0]</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>size</code></td><td><span class="sig">int size = 0</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
<p class="muted"><strong>Methods</strong> — the actions this unit can perform.</p>
<table class="members"><tr><th>Method</th><th>Signature</th><th>What it does</th></tr>
<tr><td><code>add</code></td><td><span class="sig">void add(Any value)</span></td><td class="desc">Append a value of any supported runtime kind, preserving reference identity.</td></tr>
<tr><td><code>get</code></td><td><span class="sig">Any get(int index)</span></td><td class="desc">Return null when index is outside the logical list.</td></tr>
<tr><td><code>set</code></td><td><span class="sig">boolean set(int index, Any value)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>removeAt</code></td><td><span class="sig">boolean removeAt(int index)</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>remove</code></td><td><span class="sig">void remove()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>clear</code></td><td><span class="sig">void clear()</span></td><td class="desc">Capacity is retained for reuse; removed references are cleared for GC.</td></tr>
<tr><td><code>length</code></td><td><span class="sig">int length()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
<tr><td><code>empty</code></td><td><span class="sig">boolean empty()</span></td><td class="desc"><span class="muted">No description in source.</span></td></tr>
</table>
</div>
<script>function flt(q){q=q.toLowerCase();document.querySelectorAll('[data-u]').forEach(function(el){el.style.display = el.getAttribute('data-u').indexOf(q)>=0||q==''?'':'none';});}</script>
<footer>
Generated by <code>tools/generate-sleeladoc-api.py</code> from the live
<code>/lib</code> tree on 2026-11-15 04:08 UTC.
SleelaDoc — the SLeeLa documentation brand. SLeeLa — MEARVK LLC · Max Rupplin · UNCW, NCSU, Harvard · 2026 · George Soros 2507-2608.
</footer>
</main>
</div>
</body>
</html>