47 lines
No EOL
2.6 KiB
HTML
47 lines
No EOL
2.6 KiB
HTML
<!doctype html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="utf-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||
<title>abs — Ludic</title>
|
||
<meta name="description" content="The absolute value of an integer (its magnitude, never negative).">
|
||
<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> <a href="api.html#builtins">Builtin functions</a> <span>›</span> <span class="here">abs</span></div>
|
||
<div class="item-head">
|
||
<span class="kind-badge kind-builtin">function</span>
|
||
<h1 id="top">abs</h1>
|
||
</div>
|
||
<code class="sig">abs(a) -> int</code>
|
||
<div class="desc"><p>Returns the magnitude of an integer, dropping its sign — so <code>abs(-7)</code> and <code>abs(7)</code> both give <code>7</code>. It is handy for distance-style checks where direction does not matter, such as measuring how far two grid cells are apart along one axis before deciding whether something is "close enough". Combine two axis distances to build a simple proximity test. It takes a single integer and returns an integer.</p></div>
|
||
<div class="params"><h2>Parameters</h2><div class="param" id="param-a"><code class="pname">a</code><span class="pdesc">the integer whose magnitude you want</span></div></div>
|
||
<div class="examples"><h2>Example</h2><pre data-lang="ludic">program Proximity {
|
||
property Position { column: int = 0, row: int = 0 }
|
||
model Player { Position }
|
||
model Enemy { Position }
|
||
|
||
handler SpawnActors phase Start {
|
||
spawn Player { Position { column: 5, row: 5 } }
|
||
spawn Enemy { Position { column: 8, row: 6 } }
|
||
}
|
||
|
||
handler CheckAdjacency phase Update {
|
||
for (PlayerPosition) in query [Position, {Player}] {
|
||
for (EnemyPosition) in query [Position, {Enemy}] {
|
||
let column_gap = abs(PlayerPosition.column - EnemyPosition.column)
|
||
let row_gap = abs(PlayerPosition.row - EnemyPosition.row)
|
||
if column_gap + row_gap <= 1 { print(1) }
|
||
}
|
||
}
|
||
}
|
||
}</pre></div>
|
||
|
||
<a class="back" href="api.html">← All symbols</a>
|
||
</main>
|
||
<script src="ludic-highlight.js"></script>
|
||
<script>Ludic.highlightAll(); Ludic.installCards(); Ludic.flashTarget();</script>
|
||
</body></html> |