ludic/ns-list.html
2026-09-17 22:10:03 +00:00

22 lines
No EOL
4.6 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>List — Ludic</title>
<meta name="description" content="Operations over []T slices — length, ends access, push/pop, swap, search, and in-place reverse.">
<link rel="stylesheet" href="base.css">
<link rel="stylesheet" href="docs.css">
</head>
<body>
<header class="nav"><div class="wrap nav-in"><a class="brand" href="index.html"><span class="logo">L</span> Ludic</a><button class="nav-toggle" aria-label="Toggle menu" aria-expanded="false">☰</button><nav class="nav-links"><a href="index.html">Home</a><a href="api.html">API Reference</a><a class="nav-cta" href="https://git.workshopsoft.io/workshopsoft/ludic">Source ↗</a></nav></div></header>
<main class="wrap item">
<div class="crumbs"><a href="api.html">API Reference</a> <span>›</span> <span class="here">List</span></div>
<div class="item-head"><span class="kind-badge kind-namespace">namespace</span><h1 id="top">List</h1></div>
<p class="ns-blurb">Operations over <code>[]T</code> slices — length, ends access, push/pop, swap, search, and in-place reverse. A slice is a shared growable buffer, so these mutate it in place and every holder sees the change. Arguments are positional.</p>
<div class="ns-methods"><a class="ns-method" href="list-len.html"><code class="nm-sig">List.len(s) -&gt; int</code><span class="nm-tip">The number of elements in a slice.</span></a><a class="ns-method" href="list-push.html"><code class="nm-sig">List.push(s, v) -&gt; void</code><span class="nm-tip">Append an element to the end of a slice.</span></a><a class="ns-method" href="list-clear.html"><code class="nm-sig">List.clear(s) -&gt; void</code><span class="nm-tip">Remove all elements, keeping capacity.</span></a><a class="ns-method" href="list-first.html"><code class="nm-sig">List.first(s) -&gt; T</code><span class="nm-tip">The first element of a slice.</span></a><a class="ns-method" href="list-last.html"><code class="nm-sig">List.last(s) -&gt; T</code><span class="nm-tip">The last element of a slice.</span></a><a class="ns-method" href="list-pop.html"><code class="nm-sig">List.pop(s) -&gt; T</code><span class="nm-tip">Remove and return the last element.</span></a><a class="ns-method" href="list-swap.html"><code class="nm-sig">List.swap(s, i, j) -&gt; void</code><span class="nm-tip">Exchange the elements at two indices.</span></a><a class="ns-method" href="list-contains.html"><code class="nm-sig">List.contains(s, v) -&gt; bool</code><span class="nm-tip">Whether a value appears in a slice.</span></a><a class="ns-method" href="list-index_of.html"><code class="nm-sig">List.index_of(s, v) -&gt; int</code><span class="nm-tip">The index of a value in a slice, or -1 if absent.</span></a><a class="ns-method" href="list-reverse.html"><code class="nm-sig">List.reverse(s) -&gt; void</code><span class="nm-tip">Reverse the order of a slice in place.</span></a><a class="ns-method" href="list-insert.html"><code class="nm-sig">List.insert(s, i, v) -&gt; void</code><span class="nm-tip">Insert an element at an index, shifting the rest up.</span></a><a class="ns-method" href="list-remove_at.html"><code class="nm-sig">List.remove_at(s, i) -&gt; void</code><span class="nm-tip">Remove the element at an index, shifting the rest down.</span></a><a class="ns-method" href="list-remove.html"><code class="nm-sig">List.remove(s, v) -&gt; void</code><span class="nm-tip">Remove the first element equal to a value.</span></a><a class="ns-method" href="list-sort.html"><code class="nm-sig">List.sort(s) -&gt; void</code><span class="nm-tip">Sort a slice in ascending order, in place.</span></a><a class="ns-method" href="list-sort_by.html"><code class="nm-sig">List.sort_by(s, key) -&gt; void</code><span class="nm-tip">Sort a slice ascending by a key each element maps to.</span></a><a class="ns-method" href="list-sort_desc_by.html"><code class="nm-sig">List.sort_desc_by(s, key) -&gt; void</code><span class="nm-tip">Sort a slice descending by a key each element maps to.</span></a><a class="ns-method" href="list-sort_with.html"><code class="nm-sig">List.sort_with(s, cmp) -&gt; void</code><span class="nm-tip">Sort a slice with a full two-argument comparator.</span></a><a class="ns-method" href="list-sample.html"><code class="nm-sig">List.sample(pool, count) -&gt; []int</code><span class="nm-tip">Random picks from an int slice, distinct while it can.</span></a></div>
<a class="back" href="api.html">← All symbols</a>
</main>
<script src="ludic-highlight.js"></script>
<script>Ludic.installCards(); Ludic.flashTarget();</script>
</body></html>