Salta al contenuto
Guida di Varlig
Pagina iniziale di Varlig

Scrivere una riga di calcolo

Questa pagina spiega le basi dei blocchi di calcolo: come viene interpretata una riga, come aggiungere annotazioni accanto ai calcoli, assegnare nomi ai valori e riutilizzarli, e subordinare una riga a una condizione. Inizia qui se usi i calcoli di Varlig per la prima volta; torna quando un nome o un commento non si comporta come previsto.

Un'espressione per riga

I calcoli si trovano in un blocco di calcolo all’interno di una nota. Digita la delimitazione ```calc oppure premi ⌘Y per inserirne uno. Ogni riga contiene un calcolo e il risultato appare accanto alla riga.

calc
£3.40 * 5 dà £17.00
45 min + 1 hour 20 min dà 2 hours 5 min
1.5 litres in ml dà 1,500 mL

Le righe vuote e quelle di commento non hanno un risultato: puoi usarle per dare spazio al blocco e spiegare i passaggi.

Varlig prova prima a interpretare tutta la riga come un calcolo, comprese espressioni comuni come £45 with 20% VAT. Se non è possibile, ignora le parole non riconosciute: 5 apples + 3 oranges dà comunque 8. È comodo per appunti veloci, ma una descrizione può entrare in conflitto con un’espressione o un’unità. Per spiegare lo scopo di una riga, usa quindi un commento o un’etichetta, descritti di seguito. Per i dettagli, vedi Come Varlig interpreta un’espressione.

Una parola al posto di un valore genera un errore che la identifica, anziché un risultato errato. Il messaggio suggerisce il nome più simile tra quelli che hai definito:

calc
rent = £1,150
rnt + £200 dà Unsupported: unrecognized calculation at "rnt"; did you mean "rent"?

Lo stesso vale per nomi con cifre o trattini bassi, come rent2 o rent_2: non vengono ignorati come descrizioni né interpretati come il numero che contengono. Parentesi, chiamate di funzione e conversioni non nascondono l’errore. Le cifre sono invece ammesse nelle etichette: usa quelle per descrivere la riga.

calc
rent = £1,150
rent2 + £200 dà Unsupported: unrecognized calculation at "rent2"; did you mean "rent"?
(rnt + £200) * 2 dà Unsupported: unrecognized calculation at "rnt"; did you mean "rent"?
Flat 2: rent + £200 dà £1,350.00

Righe che iniziano con un punto elenco

Un punto elenco all’inizio della riga indica una voce della lista della spesa: la descrizione prima dell’importo viene ignorata e il calcolo funziona comunque. Usa -, *, •, +, – o — seguito da uno spazio:

calc
- flowers 1,200 dà 1,200
* coffee $4.50 dà $4.50
- 12 mugs dà 12
- 6 bananas @ 18p dà £1.08
- 500g pasta 3 packs at £1.10 each dà £3.30

Un trattino davanti a una quantità senza descrizione resta un segno meno: - 1,200 vale -1,200 e - 12 kg vale -12 kg. Per una misura in un elenco, inizia con * o •, che sono sempre interpretati come punti elenco.

Parole accanto a un importo

La descrizione mantiene leggibile la riga senza modificare il numero. Le parole unite da +, & o per appartengono alla descrizione, non al calcolo. Un segno meno attaccato all’importo fa parte dell’importo; un numero di riferimento dopo una parola resta escluso dal calcolo.

calc
basin + pedestal £145 dà £145.00
food cost per head £14.20 dà £14.20
milk, bread, eggs £12.40 dà £12.40
Netflix -£10.99 dà -£10.99
DIRECT DEBIT REF 4471 £62.40 dà £62.40
Invoice #123: £250 dà £250.00
double cream 600 mL dà 600 mL
chlorine 3 ppm dà 3 ppm
t-shirt £12 dà £12.00
on the day 60 at £28 dà £1,680.00

Queste regole coprono gran parte dei formati di estratti conto, conferme d’ordine ed elenchi di componenti incollati nella nota: righe in maiuscolo, voci separate da virgole, nomi con trattini e descrizioni che iniziano con parole riconosciute da Varlig, come double, per o on the day.

Anche un’etichetta numerata, come Year 2, Room 12 o ISA 2026, oppure un periodo con l’anno, come Q4 2026, July 2026 o week 40 2027, appartiene alla descrizione, ovunque si trovi nella riga, se è seguita dall’importo. Può trattarsi di una quantità con valuta, unità o simbolo percentuale, oppure di un numero isolato prima dell’operatore successivo. Il numero dell’etichetta non viene mai sommato:

calc
Year 1 £5,000 + Year 2 £6,000 dà £11,000.00
Year 1 5,000 + Year 2 6,000 dà 11,000
ISA 2025 £20,000 + ISA 2026 £20,000 dà £40,000.00
Room 12 £40 + Room 14 £50 dà £90.00
Q3 2026 £5,000 + Q4 2026 £6,000 dà £11,000.00
July 2026 £500 + August 2026 £600 dà £1,100.00

Un solo numero dopo una parola è l’importo, come in rent 1200 + 300; un conteggio continua a contare, come in tickets 2 £40 each. Un’unità come hour, week o day misura il numero che la precede. Se viene prima del numero, funge invece da etichetta come qualsiasi altra parola: hour 2 indica la seconda ora, mai un’ora e due minuti. Se dopo compare una valuta, un’unità o un simbolo percentuale, lo spazio dopo il numero dell’etichetta introduce l’importo: Week 2 150 hours vale quindi 150 ore, non 2.150.

calc
hour 1 £40 + hour 2 £50 dà £90.00
hours 8 + hours 7 dà 15
Week 2 150 hours + Week 3 160 hours dà 310 hours

Commenti

Un commento è un testo che la calcolatrice ignora. Ci sono quattro modi per scriverne uno:

Formato Esempio Ciò che viene ignorato
Commento con cancelletto rent * 12 # per year o # Budget Tutto da un # e uno spazio alla fine della riga
Commento con barre rent * 12 // per year Tutto da // alla fine della linea
Nota fra virgolette "flat whites" £3.40 * 5 Qualsiasi cosa tra virgolette doppie, ovunque su una linea
Nota tra parentesi $999 (for iPhone 16) Parole tra parentesi, ovunque su una riga
calc
# Weekly shop
milk = £1.45
bread = £1.20 // sourdough
eggs = £2.30 "free range"
milk + bread + eggs # without the extras dà £4.95

Un cancelletto o una barra rende commento il resto della riga; virgolette e parentesi possono invece racchiudere un commento al centro. Puoi così spiegare a cosa serve un importo e proseguire il calcolo:

calc
$999 (for iPhone 16) dà $999.00
laptop £899 (refurbished) + £49 case dà £948.00
Boing "747" is $386.8M dà $386.8M

Le virgolette sono la scelta più sicura per un testo che assomiglia a un numero: così 747 nell’esempio resta escluso dal calcolo. Le parentesi che contengono solo un numero sono invece parte dell’espressione matematica, perché un numero accanto a una parentesi moltiplica:

calc
$999 (3) dà $2,997.00

Scrivi quindi il conteggio fuori dalle parentesi oppure specifica cosa stai contando, come in $999 (3 handsets). Qualsiasi contenuto diverso da un numero isolato resta un’annotazione, comprese parole con trattini e percentuali:

calc
£134 (25% discount already applied) dà £134.00
£10 (mother-in-law) dà £10.00

Una riga che inizia con un cancelletto e uno spazio è interamente un commento: puoi usarla come titolo all’interno del blocco.

È lo spazio a trasformare il cancelletto in un commento. Un # attaccato a una parola, come #food, è invece un tag: etichetta la riga, resta escluso dal calcolo e permette di sommare tutte le righe che lo contengono, ovunque si trovino nel blocco.

calc
£12.50 lunch #food dà £12.50
£8 coffee #food dà £8.00
total of #food dà £20.50

Un cancelletto seguito da cifre non è né un commento né un tag: indica un numero di riferimento ed è escluso dal calcolo. Fatture, ordini e codici di componenti possono quindi mantenere il loro formato.

calc
Invoice #123: £250 dà £250.00
part #4 weighs 20 g dà 20 g

Etichette

Un’etichetta è un breve testo seguito da due punti e uno spazio all’inizio della riga. Descrive il risultato senza partecipare al calcolo:

calc
rent = £1,250
bills = £180
Rent and bills: rent + bills dà £1,430.00
Café bill: £12.50 + £4 dà £16.50

Le etichette possono usare lettere (anche accentate), cifre, spazi e trattini bassi, come in Flat 2: o Q3 rent:.

Un’etichetta non crea un nome. Dopo Rent and bills: rent + bills non esiste un valore chiamato Rent and bills. Per riutilizzare un risultato, usa =. Evita inoltre di anteporre un’etichetta a un’assegnazione: Housing: rent = £1,250 mostra l’importo, ma non memorizza rent.

Assegnazione

= assegna un nome a un valore. La riga mostra anche il valore, così puoi verificarlo mentre lavori.

calc
price = £85 dà £85.00
price + 20% dà £102.00

Per aggiornare un nome che hai già definito, usa +=, -=, *= o /=:

calc
holiday fund = £400
holiday fund += £150 dà £550.00
holiday fund -= £85 dà £465.00
servings = 4
servings *= 3 dà 12
flour = 750 g
flour /= 3 dà 250 g

Se l’espressione a destra genera un errore, il nome conserva quell’errore. Tutte le righe che lo usano mostrano lo stesso errore finché non assegni di nuovo un valore al nome:

calc
guests = 0
per head = £120 / guests dà Error: divide by zero
per head + £5 dà Error: divide by zero

Il valore assegnato a un nome può includere una descrizione, come su una riga indipendente. A destra dell’assegnazione non puoi però mettere parole isolate attorno a un solo nome: non sarebbe chiaro cosa memorizzare. Se hai definito rent = £1,150, x = spent excl rent segnala spent excl rent anziché memorizzare silenziosamente l’affitto.

calc
paid rent = £1,150
daily spend = paid rent / 16 dà £71.88

Nomi

I nomi possono essere lunghi più parole e possono contenere lettere accentate e non latine, cifre, trattini bassi ed emoji:

calc
flat white = £3.40
flat white * 5 dà £17.00
crème brûlée = £6.50
crème brûlée * 2 dà £13.00
🍎 price = £0.45
🍎 price * 6 dà £2.70
q1 sales = £12,400
q2 sales = £14,100
q1 sales + q2 sales dà £26,500.00
bedroom_width = 3.2 m
bedroom_width * 2 dà 6.4 m

Un nome può includere parole che Varlig usa altrove, come to, in o needed, e può prendere in prestito il nome di una funzione integrata come floor. Ovunque tu lo usi come valore, Varlig legge il tuo valore:

calc
time to work = 25 min
time to work * 10 dà 4 hours 10 min
paint needed = 12.44 L
paint needed to 1 dp dà 12.4 L
floor = 12 m²
floor * 2 dà 24 m²
floor(3.7) dà 3

Se è seguito da parentesi, come in floor(3.7), il nome continua a richiamare la normale funzione.

Un nome può perfino terminare con un numero scritto in parole: puoi così riportare un prezzo come appare sul menu.

calc
table for four = £96
table for four / 4 dà £24.00

Quando due nomi iniziano allo stesso modo, prevale quello più lungo: un nome numerato viene quindi interpretato per intero.

calc
batch = £8.01
batch 2 = £8.21
batch 2 - batch dà £0.20

I nomi fanno distinzione tra maiuscole e minuscole: eggs e Eggs sono due valori diversi.

Per rendere un nome disponibile in tutte le note, per esempio la tariffa oraria o un’aliquota, aggiungilo alle definizioni globali in Settings anziché ripeterlo in ogni nota.

Nomi che si scontrano con le parole incorporate

Un nome definito da te ha priorità su unità, numeri scritti in parole o costanti con la stessa grafia. I nomi comuni lasciano però inalterate le quantità: un numero immediatamente prima di un nome plurale o di un’unità conta quella quantità; una percentuale prima di tip o tax indica una mancia o un’imposta. Valori chiamati hours, nights o tip non modificano quindi queste righe:

calc
rate = £14 / hour
hours = 7.5
rate * 7.5 hours dà £105.00
nights = 14
£118/night * 14 nights dà £1,652.00
tip = $12.69
$84.60 + 18% tip dà $99.83

Soffermati con il puntatore sulla parola per vedere come Varlig l’ha interpretata. In rate * 7.5 hours, il suggerimento spiega che qui vengono contate le ore e non viene usata la variabile hours = 7.5. Nelle altre posizioni il nome indica il tuo valore, come in split £90 among people.

Le conversioni funzionano allo stesso modo: dopo in, to o as, un’unità prevale su un nome che contiene un numero senza unità. Un conteggio a cui hai dato quel nome non impedisce quindi la conversione. Con miles = 12, 20 km in miles dà comunque 12,4274238447 mi. Un nome davanti all’unità la moltiplica per un fattore anziché indicare una destinazione: 15.2 m in scale miles con scale = 76.2 segnala Unsupported: conversion to scale miles, senza scegliere arbitrariamente tra i due significati.

Un’unità scritta come rapporto, senza spazi attorno alla barra, viene sempre interpretata come tale, anche se hai usato le sue lettere come nomi altrove. Una densità o velocità copiata da una scheda tecnica mantiene quindi il proprio significato:

calc
g = 9.81 m/s²
2 g dà 19.62 m/s²
2.7 g/cm³ dà 2.7 g/cm³
50 kg * g dà 490.5 N

In alcuni casi, invece, la tua definizione cambia il significato della riga:

  • Una singola lettera significa sempre il tuo valore, quindi dopo m = 3, 2 m è 6 invece di due metri.
  • Un numero prima di un nome singolare lo moltiplica, quindi dopo width = 3, 2 width è 6. Lo stesso vale per un nome di una lettera prima di un'unità o di un operatore. Il suggerimento lo dice e suggerisce di scrivere 2 * width per renderlo chiaro.
  • Anche le parole numeriche e le costanti vengono sostituite: dopo one = 7, one times two fa 14.

Due abitudini evitano la maggior parte delle sorprese:

  • Non usare come nomi simboli di unità isolati, come m, s, h o in, né riutilizzare costanti o numeri scritti in parole, come pi, one o i.
  • Preferisci nomi descrittivi come hours worked, day rate o run distance.

Ordine nel documento

Ogni riga può usare i nomi definiti prima di essa. I nomi restano disponibili anche nei blocchi di calcolo successivi della stessa nota: puoi definire i dati una volta sola e riutilizzarli più avanti.

calc
price = £20
quantity = 3
cost = price * quantity dà £60.00
price = £25
price * quantity dà £75.00
cost dà £60.00

Ridefinire price non modifica la precedente riga cost: cost è stato calcolato con il prezzo disponibile in quel punto. Per cambiare il risultato di un calcolo precedente, modifica la riga che definisce il suo dato di partenza.

La risposta sopra

prev indica il risultato della riga immediatamente precedente; ans ha lo stesso significato, a meno che tu non abbia assegnato il nome ans a un valore. Sono utili per proseguire rapidamente un calcolo:

calc
£1,250 * 12 dà £15,000.00
prev / 52 dà £288.46
ans + £20 dà £308.46

Per sommare un gruppo di righe, scrivi sum o total su una riga a sé. Vedi Sommare le righe precedenti.

Facendo riferimento a una riga per numero

line1, line2 e così via si riferiscono a un calcolo in base alla sua posizione nella nota, contando ogni blocco di calcolo in ordine:

calc
price = £100 dà £100.00
line1 * 2 dà £200.00

Un riferimento resta collegato alla riga a cui punta. Se inserisci una riga sopra o sposti le righe con Format › Move Line Up e Move Line Down, il calcolo continua a usare la stessa riga. Varlig aggiorna automaticamente la numerazione nel testo, con un’operazione annullabile separatamente, così il riferimento visibile corrisponde al risultato.

Se elimini la riga a cui punta un riferimento, compare Error: line2 refers to a deleted line, anziché usare silenziosamente un altro numero. Annullando l’eliminazione, ripristini sia la riga sia il riferimento.

Copia e incolla mantiene i riferimenti

Quando copi o tagli righe di calcolo e le incolli, i riferimenti line2 e ↑ continuano a puntare alle righe originali secondo queste regole:

  • Un riferimento a una riga inclusa nella copia segue la copia e viene rinumerato in base alla nuova posizione.
  • Un riferimento a una riga non copiata continua a puntare a quella riga se incolli nella stessa nota.
  • Se incolli in un’altra nota, il riferimento diventa il nome definito dalla riga, per esempio rent per rent = $1,200. Funziona quando la nota definisce quel nome o lo importa. Una riga senza nome diventa invece un riferimento come line2_of_Budget, che segnala la situazione finché non lo sostituisci:
calc
5 + line2_of_Budget dà Unsupported: line2_of_Budget is a line of another note

Gli appunti contengono solo il testo selezionato, quindi le altre app ricevono esattamente quel testo. L’operazione di incolla si annulla in un solo passaggio. Le righe copiate da una nota protetta da password vengono incollate così come sono scritte.

Trasforma la prosa in un calcolo

Hai incollato una fattura o scritto righe da sommare? Selezionale e scegli Format › Convert to Calculation Block, oppure premi ⌘Y con il testo selezionato. Varlig le racchiude nei delimitatori di un blocco di calcolo con un’unica modifica annullabile; i risultati appaiono accanto alle righe.

Senza nulla selezionato, ⌘Y inserisce un blocco vuoto. Il testo al di fuori di un blocco non viene mai calcolato, quindi un'e-mail incollata mantiene i suoi numeri, le date e i riferimenti delle fatture esattamente come sono.

Ripristino dell'ambito

Una riga contenente solo --- apre un nuovo ambito: nomi, unità personalizzate e funzioni definiti prima non sono più disponibili dopo. È utile per confrontare due scenari nella stessa nota senza che i valori dell’uno influenzino l’altro.

calc
# Option A: the flat in town
rent = £1,250
travel = £60
rent + travel dà £1,310.00
---
# Option B: the flat further out
rent = £980
travel = £210
rent + travel dà £1,190.00

Dopo ---, devi definire di nuovo travel. Se lo dimentichi, la riga che lo usa non trova alcun valore a cui riferirsi.

Condizionali

if … then … else … sceglie uno dei due valori in base a un confronto. Puoi usarlo da solo o assegnare il risultato a un nome:

calc
basket = £34.50
delivery = if basket >= £40 then £0 else £3.99 dà £3.99
basket + delivery dà £38.49

Concatena più else if per gestire più di due esiti:

calc
basket = £34.50
if basket < £20 then £4.99 else if basket < £40 then £2.99 else £0 dà £2.99

Viene calcolato solo il ramo scelto: l’altro può quindi contenere un’espressione che genererebbe un errore.

calc
guests = 0
if guests > 0 then £120 / guests else £0 dà £0.00

if e unless dopo l'espressione

Puoi anche mettere la condizione dopo il valore. value if condition mostra il valore quando la condizione è vera; value unless condition lo mostra quando è falsa. In entrambi i casi, nelle altre circostanze la riga non mostra nulla.

calc
basket = £34.50
£3.99 if basket < £40 dà £3.99
£3.99 unless basket >= £40 dà £3.99

Il valore può essere un testo tra virgolette doppie: il controllo diventa così una riga che descrive la situazione quando serve e resta vuota negli altri casi.

calc
conversion = 0.667%
"on target" if conversion > 0.5% dà on target

Assegnazione all'interno di un condizionale

Entrambi i rami possono assegnare un valore allo stesso nome:

calc
basket = £34.50
if basket >= £40 then shipping = £0 else shipping = £3.99 dà £3.99
shipping dà £3.99

Con il solo ramo then, l’assegnazione avviene se la condizione è vera; altrimenti il nome mantiene il valore precedente.

calc
basket = £34.50
points = 0
if basket > £30 then points = 50 dà 50
points dà 50

I confronti come >= e gli operatori && e || sono trattati in Operatori, confronti e condizionali.

Un esempio completo

Ecco una piccola fattura freelance, scritta nel modo in cui potresti tenerla in una nota:

calc
# March invoice
day rate = £420
days worked = 6
travel = £86.40 // train fares
fees = day rate * days worked dà £2,520.00
subtotal = fees + travel dà £2,606.40
vat registered = true
vat = if vat registered then subtotal * 20% else £0 dà £521.28
Total due: subtotal + vat dà £3,127.68

Ogni dato ha un nome: il mese prossimo basta modificare days worked e travel e il resto della fattura si aggiornerà. Commenti ed etichetta rendono il blocco leggibile; la condizione consente di usare la stessa nota sia con IVA sia senza.