Add `is_between()` for various types

1 files changed, 27 insertions, 0 deletions

diff --git a/docs/bytes.md b/docs/bytes.md
index 7cbf7b0c..2e139622 100644
--- a/docs/bytes.md
+++ b/docs/bytes.md
@@ -10,6 +10,7 @@ the `Byte()` constructor: `Byte(5)`.
 # Byte Methods
 
 - [`func hex(byte: Byte, uppercase=no, prefix=yes -> Text)`](#hex)
+- [`func is_between(x: Byte, low: Byte, high: Byte -> Bool)`](#is_between)
 - [`func parse(text: Text -> Byte?)`](#parse)
 - [`func to(first: Byte, last: Byte, step: Int8? = none -> Text)`](#to)
 
@@ -21,6 +22,32 @@ TODO: write docs
 
 ---------
 
+### `is_between`
+Determines if an integer is between two numbers (inclusive).
+
+```tomo
+func is_between(x: Byte, low: Byte, high: Byte -> Bool)
+```
+
+- `x`: The integer to be checked.
+- `low`: The lower bound to check (inclusive).
+- `high`: The upper bound to check (inclusive).
+
+**Returns:**  
+`yes` if `low <= x and x <= high`, otherwise `no`
+
+**Example:**  
+```tomo
+>> Byte(7).is_between(1, 10)
+= yes
+>> Byte(7).is_between(100, 200)
+= no
+>> Byte(7).is_between(1, 7)
+= yes
+```
+
+---
+
 ## `parse`
 
 TODO: write docs