number

number
Category	Primitive
Source	Lua

In Lua, a number is a value type that represents a double-precision floating-point number. Internally, it represents one of the C++ number types used by the API:

• double - 64-bit (double) floating-point number
• float - 32-bit floating-point number
• int - 32-bit integer
• int64 - 64-bit integer

These types were used on the Roblox Developer Hub. The website was replaced by Roblox Creator Documentation, which no longer specifies one of the types and instead only use "number".

Literals

There are several ways you can include numbers into your Lua script. All of these ways include literals, which are values that will be used in your program exactly as they are seen in the source.

Once they are included into your script, you can perform manipulate and operate on these numbers.

Standard literals

The following are valid numbers literals:

• 5
• 9.12761656
• -1927

Doubles can range from 1.7E–308 to 1.7E+308 (that's around 15 digits, positive or negative). In most cases, this is easily big enough for what you need it for (15 digits is about one hundred trillion, so you won't need much bigger than that). It is not possible to go out of this limit.

NOTE: All of the above examples are in base-10, or decimal.

Hexadecimal literals

Lua is also capable of accepting number literals in base-16, or hexadecimal. While decimal numbers include the characters 0 through 9, hexadecimal numbers use 0 through F.

To declare a number literal as hexadecimal (hex for short), prefix it with 0x.

The following are valid hex number literals:

Hex	Decimal
0x1234	4660
0xABCD	43981
0xface	64206

API usage

Certain properties in Roblox require a whole number or a positive number. In such cases, an Integer will be asked for, instead of a number. If the number in your script doesn't have a decimal place and fits within the range of a Roblox property that required an integer, it will be converted to an integer.

External links

• Numbers on the Roblox Creator Documentation