Números y direcciones

Qué números podés escribir en el ADN, cómo se lee la memoria con el asterisco, por qué una sysvar es solo una dirección y qué pasa con los valores y direcciones fuera de rango.

En el ADN todo es número. Una cantidad, una dirección de memoria y el nombre de una sysvar terminan siendo enteros en la pila entera. Esta página cuenta qué números podés escribir, cómo se lee y se escribe la memoria, y qué hace el motor cuando un valor o una dirección se salen de rango.

Literales

Un número escrito en el ADN se apila tal cual: 50, -5, 32000.

• Rango del literal: de −32768 a 32767. Un literal fuera de ese rango no se redondea ni se recorta: el bot entero no carga. Junto con una línea Variables con def mal escrita, es lo único del ADN que hace rechazar el archivo.
• Negativos: se escriben con el signo pegado, -5. También podés negar lo que está en el tope con - (5 - deja −5) o restar desde cero (0 7 sub deja −7).
• Decimales: se redondean al entero más cercano y, en el empate, al par: 1.5 vale 2 y 2.5 también vale 2. No hay números con coma en la pila.

Este literal hace que el bot no cargue:

cond
start
  40000 50 store
stop

Si necesitás un número grande, armalo con operaciones: 200 200 mult deja 40000 en la pila sin problema.

Una sysvar es una dirección

La memoria de cada bot tiene 1000 celdas, numeradas del 1 al 1000. Algunas tienen nombre: son las sysvars. .up es la celda 1, .nrg es la 310. Escribir .up en el ADN es exactamente lo mismo que escribir 1: apila la dirección, no el contenido.

Por eso 10 .up store funciona: apila 10, apila 1 y store escribe 10 en la celda 1. Y por eso este bot guarda en la celda 51 el número 310, la dirección de la energía, y no la energía:

cond
start
  .nrg 51 store
stop

Las celdas sin nombre son memoria libre para lo que quieras (ver Memoria libre y epigenética). Con Variables con def les ponés nombre propio. La lista completa de sysvars está en la referencia de sysvars, por ejemplo .nrg.

Leer la memoria: el asterisco

Para apilar el contenido de una celda se antepone un asterisco:

Si la dirección la calculás en el momento, usá el operador * separado: saca una dirección del tope y apila el contenido de esa celda. 50 * es lo mismo que *50, pero sirve también para *.nrg 10 div *, donde la dirección sale de una cuenta.

Este bot copia lo que hay en la celda 50 a la 60:

cond
start
  *50 60 store
stop

Direcciones fuera de 1 a 1000

Desde el ADN no hay forma de leer ni escribir fuera de las 1000 celdas. Toda dirección, al leer o al escribir, pasa por la misma regla:

1. Se toma el valor absoluto (el signo se ignora).
2. Se toma el resto de dividir por 1000.
3. Si el resto es 0, la celda es la 1000.

Este bot escribe 7, 8 y 9 en las celdas 50, 51 y 52 aunque las direcciones parezcan otras:

cond
start
  7 1050 store
  8 -51 store
  9 2052 store
stop

El bot «Alga_Pair 1.1.1» del Bestiario aprovecha la regla: define variables como ninjaShoot en la 1007 o ninjaUp en la 1001, que en la memoria son .shoot (7) y .up (1) con otro nombre. Este bot se mueve aunque nunca escriba .up:

def ninjaup 1001

cond
start
  10 .ninjaup store
stop

Escribir en la dirección 0

Un store cuya dirección es exactamente 0 no escribe nada y no cuesta energía. Con store, addstore, substore y multstore, además, el valor queda en la pila sin consumirse. Acá el store a 0 no hace nada, el 7 sigue en la pila y el segundo store lo guarda en la 58:

cond
start
  7 0 store
  58 store
stop

Pasa lo mismo si el 0 sale de una cuenta (5 5 sub store). El detalle de cada store está en Escribir en la memoria.

La aritmética y el recorte a ±32000

La memoria guarda valores de −32000 a 32000, pero la pila entera no: ahí los números pueden crecer hasta unos dos mil millones. mult satura en ese límite y add y sub dan la vuelta, pero en la práctica no vas a llegar. Un resultado intermedio grande no es problema mientras lo achiques antes de guardarlo: 300 300 mult 300 div da 300, aunque en el medio la pila tuvo 90000.

El recorte pasa al escribir. Un store no satura: se queda con el resto de dividir por 32000, conservando el signo. La única excepción son los múltiplos exactos de 32000, que quedan en 32000 (o −32000). Así un store nunca escribe 0 salvo que el valor sea 0.

Este bot guarda 28000, no 32000:

cond
start
  30000 30000 add 50 store
stop

El mismo recorte vale para inc y dec: un contador en 32000 que sube uno pasa a 1, no a −32000; uno en −32000 que baja pasa a −1. Si llevás la cuenta de algo que puede crecer mucho, controlalo antes de que llegue al tope.

Algunos stores (como divstore o sqrstore) no aplican el recorte porque su resultado ya cae en rango; están en Escribir en la memoria.

Números negativos

Los negativos son ciudadanos normales del ADN, con un par de detalles:

• Como valor, se guardan con su signo: -5 50 store deja −5.
• Como dirección, el signo se ignora: -50 es la celda 50.
• mod deja el signo del dividendo: -7 3 mod da −1 y 7 -3 mod da 1.
• div no trunca, redondea al más cercano y, en el empate, al par: 7 2 div da 4 y 5 2 div da 2. Dividir por 0 da 0.

Varias sysvars admiten negativos: el .timer de un bot fundador, por ejemplo, arranca en un valor al azar entre −32000 y 32000. El rango de cada una está en su ficha de la referencia, y los operadores aritméticos uno por uno en Los operadores por familia.

Resumen