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

22 lines
No EOL
3.7 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>Huge — Ludic</title>
<meta name="description" content="Idle/incremental big numbers — magnitudes far past what a 32- or 64-bit integer can hold, for prestige currencies and exponential growth.">
<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">Huge</span></div>
<div class="item-head"><span class="kind-badge kind-namespace">namespace</span><h1 id="top">Huge</h1></div>
<p class="ns-blurb">Idle/incremental big numbers — magnitudes far past what a 32- or 64-bit integer can hold, for prestige currencies and exponential growth. A <code>Huge</code> is a normalized mantissa (a Q16.16 <code>fixed</code> in [1, 10)) times <code>10^exponent</code>, so it can represent 10^100 or 10^1000 while staying one small value. It is a <strong>display-scale</strong> number (about four significant digits), <em>not</em> a lockstep-exact one — keep it out of the deterministic simulation and reach for <code>BigInt</code> / <code>Decimal</code> when exactness matters. Build one with <code>Huge.from</code>, combine with <code>add</code> / <code>sub</code> / <code>mul</code> / <code>neg</code>, compare with <code>cmp</code> / <code>sign</code>, read <code>mantissa</code> / <code>exp</code>, and render as <code>1.23e45</code> with <code>str</code>. Arguments are positional. Spliced in only when a program mentions <code>Huge.*</code>.</p>
<div class="ns-methods"><a class="ns-method" href="huge-from.html"><code class="nm-sig">Huge.from(value) -&gt; Huge</code><span class="nm-tip">Turn an int into a Huge.</span></a><a class="ns-method" href="huge-add.html"><code class="nm-sig">Huge.add(a, b) -&gt; Huge</code><span class="nm-tip">Sum of two big numbers.</span></a><a class="ns-method" href="huge-sub.html"><code class="nm-sig">Huge.sub(a, b) -&gt; Huge</code><span class="nm-tip">Difference of two big numbers.</span></a><a class="ns-method" href="huge-mul.html"><code class="nm-sig">Huge.mul(a, b) -&gt; Huge</code><span class="nm-tip">Product of two big numbers.</span></a><a class="ns-method" href="huge-neg.html"><code class="nm-sig">Huge.neg(a) -&gt; Huge</code><span class="nm-tip">Negate a big number.</span></a><a class="ns-method" href="huge-cmp.html"><code class="nm-sig">Huge.cmp(a, b) -&gt; int</code><span class="nm-tip">Compare two big numbers: -1, 0, or 1.</span></a><a class="ns-method" href="huge-sign.html"><code class="nm-sig">Huge.sign(a) -&gt; int</code><span class="nm-tip">The sign: -1, 0, or 1.</span></a><a class="ns-method" href="huge-mantissa.html"><code class="nm-sig">Huge.mantissa(a) -&gt; fixed</code><span class="nm-tip">The mantissa in [1, 10).</span></a><a class="ns-method" href="huge-exp.html"><code class="nm-sig">Huge.exp(a) -&gt; int</code><span class="nm-tip">The base-10 exponent.</span></a><a class="ns-method" href="huge-str.html"><code class="nm-sig">Huge.str(a) -&gt; string</code><span class="nm-tip">Render as scientific text like 1.23e45.</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>