From b76fbd3beba08c098c6d18578230f9edbc4d3a3d Mon Sep 17 00:00:00 2001
From: Bruce Hill <bruce@bruce-hill.com>
Date: Sun, 18 Aug 2024 23:20:54 -0400
Subject: Add Int:clamped() and Num:clamped()

---
 api/integers.md | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

(limited to 'api/integers.md')

diff --git a/api/integers.md b/api/integers.md
index acbab60c..653322fd 100644
--- a/api/integers.md
+++ b/api/integers.md
@@ -302,7 +302,8 @@ The next prime number greater than `x`.
 
 **Example:**  
 ```tomo
-11:next_prime()  // 13
+>> 11:next_prime()
+= 13
 ```
 
 ---
@@ -334,5 +335,34 @@ The previous prime number less than `x`.
 
 **Example:**  
 ```tomo
-11:prev_prime()  // 7
+>> 11:prev_prime()
+= 7
+```
+
+---
+
+## `clamped`
+
+**Description:**  
+Returns the given number clamped between two values so that it is within
+that range.
+
+**Usage:**  
+```tomo
+clamped(x, low, high: Int) -> Int
+```
+
+**Parameters:**
+
+- `x`: The integer to clamp.
+- `low`: The lowest value the result can take.
+- `high`: The highest value the result can take.
+
+**Returns:**  
+The first argument clamped between the other two arguments.
+
+**Example:**  
+```tomo
+>> 2:clamped(5, 10)
+= 5
 ```
-- 
cgit v1.2.3