int

A built-in type for integers.

Descripción

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.

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.

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

Constructores

int

int()

int

int(from: int)

int

int(from: String)

int

int(from: bool)

int

int(from: float)

Operadores

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 ~()

Descripciones de Constructores

int int() 🔗

Construye un int con un valor de 0.

int int(from: int)

Construye un int como copia del int dado.

int int(from: String)

Construye un nuevo int a partir de un String, siguiendo las mismas reglas que String.to_int().

int int(from: bool)

Construye un nuevo int a partir de un bool. true se convierte en 1 y false se convierte en 0.

int int(from: float)

Construye un nuevo int a partir de un float. Esto truncará el float, descartando cualquier cosa después del punto flotante.

Descripciones de Operadores

bool operator !=(right: float) 🔗

Devuelve true si el int no es equivalente al float.

bool operator !=(right: int) 🔗

Devuelve true si los ints no son iguales.

int operator %(right: int) 🔗

Devuelve el resto de la división de dos ints. Usa división truncada, la cual devuelve un número negativo si el dividendo es negativo. Si esto no es lo deseado, considera usar @GlobalScope.posmod().

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

int operator &(right: int) 🔗

Realiza la operación AND a nivel de bits.

print(0b1100 & 0b1010) # Imprime 8 (binario 1000)

Esto es útil para recuperar banderas binarias de una variable.

var flags = 0b101
# Comprueba si el primer o segundo bit están activados.
if flags & 0b011:
    do_stuff() # Esta línea se ejecutará.

Color operator *(right: Color) 🔗

Multiplica cada componente del Color por el int.

Quaternion operator *(right: Quaternion) 🔗

Multiplica cada componente del Quaternion por el int. Esta operación no es significativa por sí misma, pero puede ser usada como parte de una expresión mayor.

Vector2 operator *(right: Vector2) 🔗

Multiplica cada componente del Vector2 por el int.

print(2 * Vector2(1, 4)) # Imprime (2, 8)

Vector2i operator *(right: Vector2i) 🔗

Multiplica cada componente del Vector2i por el int.

Vector3 operator *(right: Vector3) 🔗

Multiplica cada componente del Vector3 por el int.

Vector3i operator *(right: Vector3i) 🔗

Multiplica cada componente del Vector3i por el int.

Vector4 operator *(right: Vector4) 🔗

Multiplica cada componente del Vector4 por el int.

Vector4i operator *(right: Vector4i) 🔗

Multiplica cada componente del Vector4i por el int.

float operator *(right: float) 🔗

Multiplica el float por el int. El resultado es un float.

int operator *(right: int) 🔗

Multiplica los dos int.

float operator **(right: float) 🔗

Eleva un int a una potencia de float. El resultado es un float.

print(2 ** 0.5) # Imprime 1.4142135623731

int operator **(right: int) 🔗

Eleva el int izquierdo a una potencia del int derecho.

print(3 ** 4) # Imprime 81

float operator +(right: float) 🔗

Suma el int y el float. El resultado es un float.

int operator +(right: int) 🔗

Suma los dos int.

float operator -(right: float) 🔗

Resta el float del int. El resultado es un float.

int operator -(right: int) 🔗

Resta los dos int.

float operator /(right: float) 🔗

Divide el int entre el float. El resultado es un float.

print(10 / 3.0) # Imprime 3.33333333333333

int operator /(right: int) 🔗

Divide los dos ints. El resultado es un int. Esto truncará el resultado, descartando cualquier cosa después del punto flotante.

print(6 / 2) # Imprime 3
print(5 / 3) # Imprime 1

bool operator <(right: float) 🔗

Devuelve true si el int es menor que el float.

bool operator <(right: int) 🔗

Devuelve true si el int de la izquierda es menor que el int de la derecha.

int operator <<(right: int) 🔗

Realiza la operación de desplazamiento a la izquierda a nivel de bits. Efectivamente es lo mismo que multiplicar por una potencia de 2.

print(0b1010 << 1) # Imprime 20 (binario 10100)
print(0b1010 << 3) # Imprime 80 (binario 1010000)

bool operator <=(right: float) 🔗

Devuelve true si el int es menor o igual que el float.

bool operator <=(right: int) 🔗

Devuelve true si el int de la izquierda es menor o igual que el int de la derecha.

bool operator ==(right: float) 🔗

Devuelve true si el int es igual al float.

bool operator ==(right: int) 🔗

Devuelve true si los dos ints son iguales.

bool operator >(right: float) 🔗

Devuelve true si el int es mayor que el float.

bool operator >(right: int) 🔗

Devuelve true si el int de la izquierda es mayor que el int de la derecha.

bool operator >=(right: float) 🔗

Devuelve true si el int es mayor o igual que el float.

bool operator >=(right: int) 🔗

Devuelve true si el int de la izquierda es mayor o igual que el int de la derecha.

int operator >>(right: int) 🔗

Realiza la operación de desplazamiento a la derecha a nivel de bits. Efectivamente es lo mismo que dividir por una potencia de 2.

print(0b1010 >> 1) # Imprime 5 (binario 101)
print(0b1010 >> 2) # Imprime 2 (binario 10)

int operator ^(right: int) 🔗

Realiza la operación bit a bit XOR.

print(0b1100 ^ 0b1010) # Imprime 6 (binario 110)

int operator unary+() 🔗

Devuelve el mismo valor como si el + no estuviera ahí. El + unario no hace nada, pero a veces puede hacer que tu código sea más legible.

int operator unary-() 🔗

Devuelve el valor negado del int. Si es positivo, lo vuelve negativo. Si es negativo, lo vuelve positivo. Si es cero, no hace nada.

int operator |(right: int) 🔗

Performs the bitwise OR operation.

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

This is useful for storing binary flags in a variable.

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).

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