Skip to content

Add Bitwise Operators #21

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

Open
tapple wants to merge 6 commits into
base: main
Choose a base branch
from
Open

Add Bitwise Operators #21

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
ac9cfc9
Add Bitwise Operators
tapple Dec 21, 2025
eb69c06
change bit32.band to bit32.btest. It's more commonly correct
tapple Jan 7, 2026
64f29f5
typo in lshift
tapple Jan 8, 2026
78e6bf1
Merge remote-tracking branch 'origin/main' into patch-2
tapple Apr 28, 2026
8cdd7ba
Fix review comments
tapple May 10, 2026
e333a7b
more clarification about `bit32.band`
tapple May 10, 2026
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
15 changes: 14 additions & 1 deletion src/content/docs/script/learn-lua/from-lsl.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ local items: {number} = {1, 2, 3} -- tables, not lists

| Operation | LSL | Lua | Notes |
|-----------|-----|------|-------|
| Not equal | `!=` | `~=` | Different operator |
| Not equal | `!=` | `~=` | **Different operator** |
| Logical AND | `&&` | `and` | Word, not symbol |
| Logical OR | `\|\|` | `or` | Word, not symbol |
| Logical NOT | `!` | `not` | Word, not symbol |
Expand All @@ -93,6 +93,19 @@ local items: {number} = {1, 2, 3} -- tables, not lists
| Power | `llPow(2, 3)` | `2 ^ 3` | Native operator |
| Integer division | `7 / 4` → `1` | `7 // 4` → `1` | Use `//` not `/` |
| String length | `llStringLength(s)` | `#s` | Native operator |
| Bitwise AND | `llGetAgentInfo(id) & AGENT_TYPING` | `bit32.btest(ll.GetAgentInfo(id), AGENT_TYPING)` | No `&` operator [(1)](#band) |
| Bitwise OR | `PASSIVE \| SCRIPTED` | `bit32.bor(PASSIVE, SCRIPTED)` | No `\|` operator |
| Bitwise NOT | `~0` | `bit32.bnot(0)` | No `~` operator [(2)](#s32) |
| Bitwise eXclusive OR | `6 ^ 3` | `bit32.bxor(6, 3)` | `^` means Power instead [(2)](#s32) |
| Bitwise Shift Left | `1 << 2` | `bit32.lshift(1, 2)` | No `<<` operator [(2)](#s32) |
| Bitwise Shift Right | `0x80000000 >> 2` | `bit32.arshift(0x80000000, 2)` | No `>>` operator [(2)](#s32) |

Notes:
1. <a name="band"/>`bit32.btest` returns a boolean; `bit32.band` returns an integer. Both match the behavior of LSL `&`.
Integers (`bit32.band`) don't work inside `if` statements, unlike LSL. Use whichever is most appropriate.
2. <a name="s32"/>Hexadecimal numbers `0x8000000` and above are positive in Lua, but negative in LSL,
due to different number formats (signed 32-bit int vs 64-bit float). Use `bit32.s32` to wrap large numbers
down to the 32-bit signed integer range for LSL compatability.

### Control Flow

Expand Down