Escribir una hoja

Una hoja es una lista de líneas evaluadas de arriba abajo. Cada línea puede definir un valor, referenciar algo de arriba, o simplemente producir un resultado. Las variables viven en un único ámbito por hoja y están disponibles para toda línea por debajo de su definición.

Comentarios y etiquetas#

Todo lo que sigue a un # y un espacio es un comentario y se ignora.

2 + 2 # this is a note

Una etiqueta: antes de una expresión da nombre a la línea sin evaluarse. Esto ayuda a recordar qué significa una línea.

Price: 10 + 5

Un único # al principio de la línea también funciona como comentario.

// también inicia un comentario, como en las hojas de Numi y Soulver. Una línea es un cálculo: un ; entre dos instrucciones es un error.

Tags#

Sin espacio después del #, una palabra es una tag, no un comentario. Las tags marcan líneas para que puedas sumarlas en otro lugar.

20 #food
30 #food
#food

Una línea que solo tiene tags muestra su total, y sum/total/average/avg (opcionalmente of) hace lo mismo. Se suman las líneas de valor marcadas por encima del pedido (las asignaciones marcadas como lunch = 12 #food no cuentan; escribe lunch: 12 #food).

Un operador después de un pedido se aplica a su total.

10 #food
20 #food
sum #food * 2

20 #food
30 #food
#food * 2

Las tags también se pueden usar directamente en cálculos: #food * 2, #food + #other. Pedir una tag que no tiene líneas marcadas es un error.

Una fila con varias tags es el importe total dividido a partes iguales entre ellas. Así, burger: 2 * 50 #ana #bob da 50 a cada tag mientras la fila conserva los 100 completos.

burger: 2 * 50 #ana #bob
#ana
#bob

Variables#

Asigna un valor con = y reutilízalo en líneas posteriores.

pizzas = 2
pizzaPrice = 30
people = 4
(pizzas * pizzaPrice) / people

Los nombres de variables pueden contener espacios. Un nombre de varias palabras debe ser coherente: monthly rent es un solo nombre, no monthly y rent.

monthly rent = 1500
monthly rent * 12

Si una asignación falla (x = foo + 1), el nombre sigue siendo un error hasta que se vuelva a asignar, así que las líneas posteriores que lo usan muestran "x" has an error on line 2 en vez de usar en silencio un valor anterior.

Puedes guardar una función con f(x) = … y llamarla después, directamente o con otro nombre.

double = f(x) = x * 2
double(21)

f(x) = x * 2
f(4)

Objetos#

Un objeto agrupa valores con nombre, y un punto accede a un campo.

invoice = {subtotal: 120, tax: 12}
invoice.subtotal + invoice.tax

Referencias#

line(n) usa el resultado de la línea n. Solo se pueden referenciar líneas anteriores, y el valor aparece en lugar del token cuando el cursor está en otra línea (el line(3) sin procesar reaparece mientras editas esa línea).

5
line(1) * 2

prev se refiere al resultado más reciente por encima. Omite comentarios y líneas en blanco.

20
prev * 4

10
# a comment in between
prev + 1

Palabras reservadas#

Algunos nombres no se pueden usar como variables:

• prev (el resultado anterior)
• total (la agregación del total general)
• unit — abre la definición de una unidad personalizada (unit widget = 3.5 kg)
• las palabras de fecha incondicionales today, now, yesterday, tomorrow, christmas, halloween
• cualquier nombre que empiece por __ (los ayudantes internos del editor)
• end cierra un grupo

Por lo demás, las variables comparten un ámbito con los nombres integrados, así que una variable puede tapar una unidad o función: tras m = 5, 2 m es 2 × m, no dos metros. Las demás palabras clave de agregación sum, average y avg todavía pueden taparse: tras avg = 5, una línea avg posterior lee la variable en vez de agregar.

Líneas en blanco#

Una línea en blanco cierra el bloque que examinan sum, average y las demás agregaciones, y separa secciones de la hoja. Úsala para ceñir las agregaciones a las líneas que quieres.