intDesde: siempre

Un entero: un número entero positivo, un número entero negativo o cero.

Typst almacena los enteros con signo con la representación de complemento a dos en 64 bits. Esto permite almacenar números hasta $2^{63} - 1$ (int.max) y hasta $- 2^{63}$ (int.min).

Los enteros también se pueden especificar en hexadecimal, octal o binario empezando con los prefijos: 0x, 0o o 0b.

Podés convertir un valor en entero con el constructor de este tipo.

Ejemplo


#(1 + 2) \
#(2 - 5) \
#(3 + 4 < 8)

#0xff \
#0o10 \
#0b1001

#(int(3.8) + int("26"))

/ Max: #int.max
/ Min: #int.min

Sintaxis

Los enteros de Typst se pueden ingresar en modo código con los dígitos decimales 0–9. Además, si un 0 solitario va seguido de x, o o b (0x, 0o, 0b), Typst tratará los dígitos siguientes como un número hexadecimal (base 16), octal (base 8) o binario (base 2).

Los números hexadecimales usan las letras a–f o A–F para los valores 10–15.

Typst dará un error si se escribe un entero mayor que int.max. Si esto pasa, quizás quieras usar en su lugar un número de punto flotante, agregando un punto al final del número.

Typst se diferencia de otros lenguajes de programación en que no trata los enteros negativos como tokens individuales en su sintaxis. En cambio, una entrada como -6 se trata como el operador de negación aplicado al entero positivo 6. Esto puede causar un problema al intentar escribir el entero negativo mínimo -9223372036854775808, ya que 9223372036854775808 es mayor que int.max. Para escribir el entero negativo mínimo, usá en su lugar int.min.

Esto también significa que, si querés incrustar un entero negativo en el marcado, vas a tener que usar paréntesis para agrupar el operador de negación: #(-6).

Constructor

Convierte un valor en un entero. Produce un error si se intenta analizar una cadena de texto no válida o producir un entero que no entra en un entero con signo de 64 bits.

Los booleanos se convierten en 0 o 1.
Los flotantes y decimales se redondean hacia cero al siguiente entero de 64 bits.
Las cadenas de texto se analizan por defecto en base 10.

Ver ejemplo


#int(false) \
#int(true) \
#int(2.7) \
#int(decimal("3.8")) \
#(int("27") + int("4")) \
#int("beef", base: 16)

int(

bool int float decimal str,base: int,

) → int

`value`
bool o int o float o decimal o str
ObligatorioPosicional

El valor que se debe convertir en entero.

`base`
int
Por defecto: `10`

La base (raíz) para analizar cadenas de texto, entre 2 y 36.

Por encima de la base 10, Typst acepta las letras a–z o A–Z para los valores 10–35.

Constantes

`max`
intDesde: siempre

El valor máximo que se puede representar como entero de Typst: $2^{63} - 1$ .

Ver ejemplo


#int.max \
// In hexadecimal:
#0x7FFFFFFFFFFFFFFF

`min`
intDesde: siempre

El valor mínimo que se puede representar como entero de Typst: $- 2^{63}$ .

Intentar escribir este entero explícitamente como -9223372036854775808 en lugar de usar int.min producirá un error. Para más información, leé la sección Sintaxis.

Ver ejemplo


#int.min

Funciones

`signum`Desde: 0.11.0

Calcula el signo de un entero.

Si el número es positivo, devuelve 1.
Si el número es negativo, devuelve -1.
Si el número es cero, devuelve 0.

Ver ejemplo


#(5).signum() \
#(-5).signum() \
#(0).signum()

self.signum() → int

`bit-not`Desde: 0.11.0

Calcula el NOT bit a bit de un entero.

A los fines de esta función, el operando se trata como un entero con signo de 64 bits.

Ver ejemplo


#4.bit-not() \
#(-1).bit-not()

self.bit-not() → int

`bit-and`Desde: 0.11.0

Calcula el AND bit a bit entre dos enteros.

A los fines de esta función, los operandos se tratan como enteros con signo de 64 bits.

Ver ejemplo


#128.bit-and(192)

self.bit-and(int) → int

`rhs`
int
ObligatorioPosicional

El operando derecho del AND bit a bit.

`bit-or`Desde: 0.11.0

Calcula el OR bit a bit entre dos enteros.

A los fines de esta función, los operandos se tratan como enteros con signo de 64 bits.

Ver ejemplo


#64.bit-or(32)

self.bit-or(int) → int

`rhs`
int
ObligatorioPosicional

El operando derecho del OR bit a bit.

`bit-xor`Desde: 0.11.0

Calcula el XOR bit a bit entre dos enteros.

A los fines de esta función, los operandos se tratan como enteros con signo de 64 bits.

Ver ejemplo


#64.bit-xor(96)

self.bit-xor(int) → int

`rhs`
int
ObligatorioPosicional

El operando derecho del XOR bit a bit.

`bit-lshift`Desde: 0.11.0

Desplaza los bits del operando a la izquierda la cantidad especificada.

A los fines de esta función, el operando se trata como un entero con signo de 64 bits. Se producirá un error si el resultado es demasiado grande para entrar en un entero de 64 bits.

Ver ejemplo


#33.bit-lshift(2) \
#(-1).bit-lshift(3)

self.bit-lshift(int) → int

`shift`
int
ObligatorioPosicional

La cantidad de bits que se desplazan. No debe ser negativa.

`bit-rshift`Desde: 0.11.0

Desplaza los bits del operando a la derecha la cantidad especificada. Por defecto realiza un desplazamiento aritmético (extiende el bit de signo hacia la izquierda, de modo que los números negativos siguen siendo negativos), pero esto se puede cambiar con el parámetro logical.

A los fines de esta función, el operando se trata como un entero con signo de 64 bits.

Ver ejemplo


#64.bit-rshift(2) \
#(-8).bit-rshift(2) \
#(-8).bit-rshift(2, logical: true)

self.bit-rshift(

int,logical: bool,

) → int

`shift`
int
ObligatorioPosicional

La cantidad de bits que se desplazan. No debe ser negativa.

Se permiten desplazamientos mayores que 63 y harán que el valor de retorno se sature. Para números no negativos, el valor de retorno se satura en 0, mientras que, para números negativos, se satura en -1 si logical es false, o en 0 si es true. Este comportamiento es coherente con aplicar esta operación varias veces. Por lo tanto, el desplazamiento siempre tendrá éxito.

`logical`
bool
Por defecto: `false`

Activa o desactiva que se realice un desplazamiento lógico (sin signo) a la derecha en lugar de uno aritmético. Si es true, los operandos negativos no conservarán su bit de signo y los bits que aparezcan a la izquierda después del desplazamiento serán 0. Este parámetro no tiene efecto en operandos no negativos.

`from-bytes`Desde: 0.12.0

Convierte bytes en un entero.

Ver ejemplo


#int.from-bytes(bytes((0, 0, 0, 0, 0, 0, 0, 1))) \
#int.from-bytes(bytes((1, 0, 0, 0, 0, 0, 0, 0)), endian: "big")

int.from-bytes(

bytes,endian: str,signed: bool,

) → int

`bytes`
bytes
ObligatorioPosicional

Los bytes que se deben convertir en entero.

Deben tener una longitud máxima de 8 para que el resultado entre en un entero con signo de 64 bits.

`endian`
str
Por defecto: `"little"`

El orden de bytes (endianness) de la conversión.

Variante	Detalles
`"big"`	Orden de bytes big-endian: el byte de mayor valor está al comienzo de los bytes.
`"little"`	Orden de bytes little-endian: el byte de menor valor está al comienzo de los bytes.

`signed`
bool
Por defecto: `true`

Si los bytes se deben tratar como un entero con signo. Si es true y el bit más significativo está activado, el número resultante será negativo.

`to-bytes`Desde: 0.12.0

Convierte un entero en bytes.

Ver ejemplo


#array(10000.to-bytes(endian: "big")) \
#array(10000.to-bytes(size: 4))

self.to-bytes(

endian: str,size: int,

) → bytes

`endian`
str
Por defecto: `"little"`

El orden de bytes (endianness) de la conversión.

Variante	Detalles
`"big"`	Orden de bytes big-endian: el byte de mayor valor está al comienzo de los bytes.
`"little"`	Orden de bytes little-endian: el byte de menor valor está al comienzo de los bytes.

`size`
int
Por defecto: `8`

El tamaño en bytes de los bytes resultantes (debe ser al menos cero). Si el entero es demasiado grande para entrar en el tamaño especificado, la conversión truncará los bytes restantes según el orden de bytes. Para mantener el mismo valor resultante, si el orden es big-endian, el truncamiento se hará en los bytes de más a la derecha. En cambio, si el orden es little-endian, el truncamiento se hará en los bytes de más a la izquierda.

Tené en cuenta que, si el entero es negativo y el tamaño no alcanza para que el número entre, al pasar los bytes resultantes a int.from-bytes, el número resultante podría ser positivo, ya que el bit más significativo podría no estar en

FunciónPágina anterior

EtiquetaPágina siguiente

intDesde: siempreIr al código fuente

Ejemplo

Sintaxis

ConstructorSigno de preguntaSi un tipo tiene un constructor, podés llamarlo como una función para crear un valor nuevo de ese tipo.Ir al código fuente

valuebool o int o float o decimal o strObligatorioPosicionalSigno de preguntaLos parámetros posicionales se especifican en orden, sin nombres.

baseintPor defecto: 10

ConstantesSigno de preguntaLas funciones y los tipos pueden definir constantes. Se accede a estos miembros indicando la función o el tipo, seguido de un punto y, luego, el nombre de la constante.

maxintDesde: siempreIr al código fuente

minintDesde: siempreIr al código fuente

FuncionesSigno de preguntaLas funciones y los tipos pueden definir funciones. Se accede a estos miembros indicando la función o el tipo, seguido de un punto y, luego, el nombre de la función.

signumDesde: 0.11.0Ir al código fuente

bit-notDesde: 0.11.0Ir al código fuente

bit-andDesde: 0.11.0Ir al código fuente

rhsintObligatorioPosicionalSigno de preguntaLos parámetros posicionales se especifican en orden, sin nombres.

bit-orDesde: 0.11.0Ir al código fuente

rhsintObligatorioPosicionalSigno de preguntaLos parámetros posicionales se especifican en orden, sin nombres.

bit-xorDesde: 0.11.0Ir al código fuente

rhsintObligatorioPosicionalSigno de preguntaLos parámetros posicionales se especifican en orden, sin nombres.

bit-lshiftDesde: 0.11.0Ir al código fuente

shiftintObligatorioPosicionalSigno de preguntaLos parámetros posicionales se especifican en orden, sin nombres.

bit-rshiftDesde: 0.11.0Ir al código fuente

shiftintObligatorioPosicionalSigno de preguntaLos parámetros posicionales se especifican en orden, sin nombres.

logicalboolPor defecto: false

from-bytesDesde: 0.12.0Ir al código fuente

bytesbytesObligatorioPosicionalSigno de preguntaLos parámetros posicionales se especifican en orden, sin nombres.

endianstrPor defecto: "little"

signedboolPor defecto: true

to-bytesDesde: 0.12.0Ir al código fuente

endianstrPor defecto: "little"

sizeintPor defecto: 8

intDesde: siempre

Constructor

`value`
bool o int o float o decimal o str
ObligatorioPosicional

`base`
int
Por defecto: `10`

Constantes

`max`
intDesde: siempre

`min`
intDesde: siempre

Funciones

`signum`Desde: 0.11.0

`bit-not`Desde: 0.11.0

`bit-and`Desde: 0.11.0

`rhs`
int
ObligatorioPosicional

`bit-or`Desde: 0.11.0

`rhs`
int
ObligatorioPosicional

`bit-xor`Desde: 0.11.0

`rhs`
int
ObligatorioPosicional

`bit-lshift`Desde: 0.11.0

`shift`
int
ObligatorioPosicional

`bit-rshift`Desde: 0.11.0

`shift`
int
ObligatorioPosicional

`logical`
bool
Por defecto: `false`

`from-bytes`Desde: 0.12.0

`bytes`
bytes
ObligatorioPosicional

`endian`
str
Por defecto: `"little"`

`signed`
bool
Por defecto: `true`

`to-bytes`Desde: 0.12.0

`endian`
str
Por defecto: `"little"`

`size`
int
Por defecto: `8`