Skip to content

Add new functions bit32.s32 and bit32.smul #69

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
HaroldCindy merged 4 commits into from
Mar 12, 2026
Merged

Add new functions bit32.s32 and bit32.smul #69

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
ccaf058
Add new functions `bit32.s32` and `bit32.smul`
tapple Mar 9, 2026
ab611ae
doc
tapple Mar 9, 2026
24529e9
fix typos
tapple Mar 11, 2026
1c32dd1
./gen_all_definitions.sh
tapple Mar 12, 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
2 changes: 2 additions & 0 deletions generated/slua_default.d.luau
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -168,6 +168,8 @@ declare bit32: {
replace: (n: number, v: number, field: number, width: number?) -> number,
rrotate: (n: number, i: number) -> number,
rshift: (n: number, i: number) -> number,
s32: (n: number) -> number,
smul: (a: number, b: number) -> number,
countlz: (n: number) -> number,
countrz: (n: number) -> number,
byteswap: (n: number) -> number,
Expand Down
8 changes: 8 additions & 0 deletions generated/slua_default.docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,14 @@
"documentation": "Shifts n by i bits to the right. If i is negative, a left shift is performed.",
"learn_more_link": "https://create.roblox.com/docs/reference/engine/libraries/bit32#rshift"
},
"@sl-slua/global/bit32.s32": {
"documentation": "Wrap this number from float64 range to signed int32 range and truncate to integer. Makes integer arithmetic compatable with LSL.",
"learn_more_link": "https://create.roblox.com/docs/reference/engine/libraries/bit32#s32"
Copy link
Copy Markdown
Collaborator

@HaroldCindy HaroldCindy Mar 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There isn't a docs link as of yet ;)

Might need a generator update for things that don't actually have upstream docs?

Copy link
Copy Markdown
Contributor Author

@tapple tapple Mar 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd have to mark them. and it's only temporary that there aren't docs, so I'd rather not worry about it. I'd be doing work that needs reverting

Copy link
Copy Markdown
Collaborator

@HaroldCindy HaroldCindy Mar 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Makes sense, we can come up with a better notation when there's somewhere else to point people.

},
"@sl-slua/global/bit32.smul": {
"documentation": "Multiplies two signed 32-bit integers. Returns the result as a signed 32-bit integer, wrapping as necessary. Avoids precision loss ascociated with float64 multiplication. Compatible with LSL integer multiplication.",
"learn_more_link": "https://create.roblox.com/docs/reference/engine/libraries/bit32#smul"
},
"@sl-slua/global/bit32.countlz": {
"documentation": "Count leading zeros",
"learn_more_link": "https://create.roblox.com/docs/reference/engine/libraries/bit32#countlz"
Expand Down
55 changes: 55 additions & 0 deletions generated/slua_keywords_pretty.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11702,6 +11702,61 @@ Returns true if result is non-zero.</string>
<key>tooltip</key>
<string>Shifts n by i bits to the right. If i is negative, a left shift is performed.</string>
</map>
<key>bit32.s32</key>
<map>
<key>arguments</key>
<array>
<map>
<key>n</key>
<map>
<key>tooltip</key>
<string>Number to truncate.</string>
<key>type</key>
<string>number</string>
</map>
</map>
</array>
<key>energy</key>
<real>10.0</real>
<key>return</key>
<string>number</string>
<key>sleep</key>
<real>0.0</real>
<key>tooltip</key>
<string>Wrap this number from float64 range to signed int32 range and truncate to integer. Makes integer arithmetic compatable with LSL.</string>
</map>
<key>bit32.smul</key>
<map>
<key>arguments</key>
<array>
<map>
<key>a</key>
<map>
<key>tooltip</key>
<string>Left factor.</string>
<key>type</key>
<string>number</string>
</map>
</map>
<map>
<key>b</key>
<map>
<key>tooltip</key>
<string>Right factor.</string>
<key>type</key>
<string>number</string>
</map>
</map>
</array>
<key>energy</key>
<real>10.0</real>
<key>return</key>
<string>number</string>
<key>sleep</key>
<real>0.0</real>
<key>tooltip</key>
<string>Multiplies two signed 32-bit integers. Returns the result as a signed 32-bit integer, wrapping as necessary. Avoids precision loss ascociated with float64 multiplication. Compatible with LSL integer multiplication.</string>
</map>
<key>buffer</key>
<map>
<key>energy</key>
Expand Down
14 changes: 14 additions & 0 deletions generated/slua_selene.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4026,6 +4026,20 @@ globals:
must_use: true
description: Shifts n by i bits to the right. If i is negative, a left shift is
performed.
bit32.s32:
args:
- type: number
must_use: true
description: Wrap this number from float64 range to signed int32 range and truncate
to integer. Makes integer arithmetic compatable with LSL.
bit32.smul:
args:
- type: number
- type: number
must_use: true
description: Multiplies two signed 32-bit integers. Returns the result as a signed
32-bit integer, wrapping as necessary. Avoids precision loss ascociated with
float64 multiplication. Compatible with LSL integer multiplication.
bit32.countlz:
args:
- type: number
Expand Down
21 changes: 21 additions & 0 deletions slua_definitions.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -463,6 +463,27 @@ modules:
type: number
returnType: number
must-use: true
- name: s32
comment: Wrap this number from float64 range to signed int32 range and truncate to integer.
Makes integer arithmetic compatable with LSL.
parameters:
- name: "n"
comment: Number to truncate.
type: number
returnType: number
must-use: true
- name: smul
comment: Multiplies two signed 32-bit integers. Returns the result as a signed 32-bit integer, wrapping as necessary.
Avoids precision loss ascociated with float64 multiplication. Compatible with LSL integer multiplication.
parameters:
- name: a
comment: Left factor.
type: number
- name: b
comment: Right factor.
type: number
returnType: number
must-use: true
- name: countlz
comment: Count leading zeros
parameters:
Expand Down
Loading