Skip to content

Documentation for the newly added MOD function in BASIC #276

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mooinglemur merged 3 commits into from
Nov 18, 2025
Merged

Documentation for the newly added MOD function in BASIC #276

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
53bf775
Added documentation for new MOD command in BASIC
JimmyDansbo Nov 18, 2025
42f620c
Fixing typo and trying to clarify description
JimmyDansbo Nov 18, 2025
cade89c
Added comments in example
JimmyDansbo Nov 18, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions X16 Reference - 04 - BASIC.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,7 @@ for GitHub's Markdown flavor. Do not remove!
| `LOG` | function | Returns the natural logarithm of a number | C64 |
| [`MENU`](#menu) | command | Invokes the Commander X16 utility menu | X16 |
| `MID$` | function | Returns a substring from the middle of a string | C64 |
| [`MOD`](#mod) | function | Returns the truncated remainder of a division | X16 |
| [`MON`](#mon) | command | Enters the machine language monitor | X16 |
| [`MOUSE`](#mouse) | command | Hides or shows mouse pointer | X16 |
| [`MOVSPR`](#movspr) | command | Set the X/Y position of a sprite | X16 |
Expand Down Expand Up @@ -950,6 +951,30 @@ The values are 1-based. If no column is given, only the line is changed.
MENU
```

### MOD

**TYPE: Function**
**FORMAT: MOD(<dividend>, <divisor>)**

**Action:** Returns the truncated remainder of <dividend> divided by <divisor>

The `MOD` function supports 16bit signed numbers (-32768 to 32767)

**EXAMPLE of MOD Function:**
```BASIC
PRINT MOD(-17, 5) :REM RESULT WILL HAVE THE SAME SIGN AS DIVIDEND
-2

PRINT MOD(17, 5)
2

PRINT MOD(42, 0) :REM DIVISOR IS 0, RETURN ERROR
?DIVISION BY ZERO ERROR

PRINT MOD(65000, 101) :REM DIVIDEND IS TOO LARGE FOR A SIGNED 16BIT VALUE
?ILLEGAL QUANTITY ERROR
```

### MON

**TYPE: Command**
Expand Down