Godot

No search query

Search by

Appearance

int ​

A built-in type for integers.

Description

Signed 64-bit integer type. This means that it can take values from -2^63 to 2^63 - 1, i.e. from -9223372036854775808 to 9223372036854775807. When it exceeds these bounds, it will wrap around.

ints can be automatically converted to floats when necessary, for example when passing them as arguments in functions. The float will be as close to the original integer as possible.

Likewise, floats can be automatically converted into ints. This will truncate the float, discarding anything after the floating-point.

Note: In a boolean context, an int will evaluate to false if it equals 0, and to true otherwise.

gdscript
var x: int = 1 # x is 1
x = 4.2 # x is 4, because 4.2 gets truncated
var max_int = 9223372036854775807 # Biggest value an int can store
max_int += 1 # max_int is -9223372036854775808, because it wrapped around

You can use the 0b literal for binary representation, the 0x literal for hexadecimal representation, and the _ symbol to separate long numbers and improve readability.

gdscript
var x = 0b1001 # x is 9
var y = 0xF5 # y is 245
var z = 10_000_000 # z is 10000000

Constructors

int

int()

int

int(from: int)

int

int(from: String)

int

int(from: bool)

int

int(from: float)

Operators

bool

operator !=(right: float)

bool

operator !=(right: int)

int

operator %(right: int)

int

operator &(right: int)

Color

operator *(right: Color)

Quaternion

operator *(right: Quaternion)

Vector2

operator *(right: Vector2)

Vector2i

operator *(right: Vector2i)

Vector3

operator *(right: Vector3)

Vector3i

operator *(right: Vector3i)

Vector4

operator *(right: Vector4)

Vector4i

operator *(right: Vector4i)

float

operator *(right: float)

int

operator *(right: int)

float

operator **(right: float)

int

operator **(right: int)

float

operator +(right: float)

int

operator +(right: int)

float

operator -(right: float)

int

operator -(right: int)

float

operator /(right: float)

int

operator /(right: int)

bool

operator <(right: float)

bool

operator <(right: int)

int

operator <<(right: int)

bool

operator <=(right: float)

bool

operator <=(right: int)

bool

operator ==(right: float)

bool

operator ==(right: int)

bool

operator >(right: float)

bool

operator >(right: int)

bool

operator >=(right: float)

bool

operator >=(right: int)

int

operator >>(right: int)

int

operator ^(right: int)

int

operator unary+()

int

operator unary-()

int

operator |(right: int)

int

operator ~()

Constructor Descriptions

int int() 🔗

Constructs an int set to 0.

int int(from: int)

Constructs an int as a copy of the given int.

int int(from: String)

Constructs a new int from a String, following the same rules as String.to_int.

int int(from: bool)

Constructs a new int from a bool. true is converted to 1 and false is converted to 0.

int int(from: float)

Constructs a new int from a float. This will truncate the float, discarding anything after the floating point.

Operator Descriptions

bool operator !=(right: float) 🔗

Returns true if the int is not equivalent to the float.

bool operator !=(right: int) 🔗

Returns true if the ints are not equal.

int operator %(right: int) 🔗

Returns the remainder after dividing two ints. Uses truncated division, which returns a negative number if the dividend is negative. If this is not desired, consider using @GlobalScope.posmod.

gdscript
print(6 % 2) # Prints 0
print(11 % 4) # Prints 3
print(-5 % 3) # Prints -2

int operator &(right: int) 🔗

Performs the bitwise AND operation.

gdscript
print(0b1100 & 0b1010) # Prints 8 (binary 1000)

This is useful for retrieving binary flags from a variable.

gdscript
var flags = 0b101
# Check if the first or second bit are enabled.
if flags & 0b011:
    do_stuff() # This line will run.

Color operator *(right: Color) 🔗

Multiplies each component of the Color by the int.

Quaternion operator *(right: Quaternion) 🔗

Multiplies each component of the Quaternion by the int. This operation is not meaningful on its own, but it can be used as a part of a larger expression.

Vector2 operator *(right: Vector2) 🔗

Multiplies each component of the Vector2 by the int.

gdscript
print(2 * Vector2(1, 4)) # Prints (2, 8)

Vector2i operator *(right: Vector2i) 🔗

Multiplies each component of the Vector2i by the int.

Vector3 operator *(right: Vector3) 🔗

Multiplies each component of the Vector3 by the int.

Vector3i operator *(right: Vector3i) 🔗

Multiplies each component of the Vector3i by the int.

Vector4 operator *(right: Vector4) 🔗

Multiplies each component of the Vector4 by the int.

Vector4i operator *(right: Vector4i) 🔗

Multiplies each component of the Vector4i by the int.

float operator *(right: float) 🔗

Multiplies the float by the int. The result is a float.

int operator *(right: int) 🔗

Multiplies the two ints.

float operator **(right: float) 🔗

Raises an int to a power of a float. The result is a float.

gdscript
print(2 ** 0.5) # Prints 1.4142135623731

int operator **(right: int) 🔗

Raises the left int to a power of the right int.

gdscript
print(3 ** 4) # Prints 81

float operator +(right: float) 🔗

Adds the int and the float. The result is a float.

int operator +(right: int) 🔗

Adds the two ints.

float operator -(right: float) 🔗

Subtracts the float from the int. The result is a float.

int operator -(right: int) 🔗

Subtracts the two ints.

float operator /(right: float) 🔗

Divides the int by the float. The result is a float.

gdscript
print(10 / 3.0) # Prints 3.33333333333333

int operator /(right: int) 🔗

Divides the two ints. The result is an int. This will truncate the float, discarding anything after the floating point.

gdscript
print(6 / 2) # Prints 3
print(5 / 3) # Prints 1

bool operator <(right: float) 🔗

Returns true if the int is less than the float.

bool operator <(right: int) 🔗

Returns true if the left int is less than the right int.

int operator <<(right: int) 🔗

Performs the bitwise shift left operation. Effectively the same as multiplying by a power of 2.

gdscript
print(0b1010 << 1) # Prints 20 (binary 10100)
print(0b1010 << 3) # Prints 80 (binary 1010000)

bool operator <=(right: float) 🔗

Returns true if the int is less than or equal to the float.

bool operator <=(right: int) 🔗

Returns true if the left int is less than or equal to the right int.

bool operator ==(right: float) 🔗

Returns true if the int is equal to the float.

bool operator ==(right: int) 🔗

Returns true if the two ints are equal.

bool operator >(right: float) 🔗

Returns true if the int is greater than the float.

bool operator >(right: int) 🔗

Returns true if the left int is greater than the right int.

bool operator >=(right: float) 🔗

Returns true if the int is greater than or equal to the float.

bool operator >=(right: int) 🔗

Returns true if the left int is greater than or equal to the right int.

int operator >>(right: int) 🔗

Performs the bitwise shift right operation. Effectively the same as dividing by a power of 2.

gdscript
print(0b1010 >> 1) # Prints 5 (binary 101)
print(0b1010 >> 2) # Prints 2 (binary 10)

int operator ^(right: int) 🔗

Performs the bitwise XOR operation.

gdscript
print(0b1100 ^ 0b1010) # Prints 6 (binary 110)

int operator unary+() 🔗

Returns the same value as if the + was not there. Unary + does nothing, but sometimes it can make your code more readable.

int operator unary-() 🔗

Returns the negated value of the int. If positive, turns the number negative. If negative, turns the number positive. If zero, does nothing.

int operator |(right: int) 🔗

Performs the bitwise OR operation.

gdscript
print(0b1100 | 0b1010) # Prints 14 (binary 1110)

This is useful for storing binary flags in a variable.

gdscript
var flags = 0
flags |= 0b101 # Turn the first and third bits on.

int operator ~() 🔗

Performs the bitwise NOT operation on the int. Due to 2's complement, it's effectively equal to -(int + 1).

gdscript
print(~4) # Prints -5
print(~(-7)) # Prints 6