Pular para o conteúdo
Guia do Varlig
Página inicial do Varlig

Entenda como o cálculo foi interpretado

Varlig lê escrita comum, então de vez em quando você vai querer saber exatamente o que ele fez de uma linha: qual nome ele usou, se 05/06/2026 foi maio ou junho, de onde veio uma taxa, ou por que uma linha que parece boa mostra um erro.

Toda resposta tem uma explicação. Clique com o botão direito em uma resposta ou linha de cálculo e escolha How Was This Read?…. Clicar em uma resposta de erro abre a mesma explicação. No iPhone e iPad, toque e segure uma resposta ou toque em um erro.

O que o popover mostra

A explicação tem uma seção para cada coisa que afetou a resposta, nesta ordem:

Seção O que isso te diz
Read As A expressão que Varlig entendeu, com as partes que usou
Answer A resposta e o valor próprio da linha quando ela mostra um total acumulado
Uses Cada nome usado pela linha, seu valor e sua origem
Used By As linhas nesta nota que usam esta
Used by 2 Notes As outras notas que usam o valor ou a função definidos nesta linha
Treated as Text As palavras na linha que não fizeram parte da soma
Units O que cada unidade mede, como MB — information, 1,000,000 bytes
Dates Como uma data foi lida, como 05/06/2026 is read month/day, as the region writes dates
Assumptions Convenções em jogo, como o sin takes radians; write 30° for degrees
Exchange Rates Cada conversão, sua taxa, sua fonte e há quanto tempo os dados foram obtidos
Weather Que o clima na resposta vem da Apple Weather, com sua marca e Other data sources

A origem de um nome é sempre nomeada, então você pode distinguir um valor definido acima de um que chegou de outro lugar:

  • rent = $1,200.00 (line 2) — definido anteriormente nesta nota
  • fee = 7 (Definitions) — de Settings › Calculations › Shared definitions
  • rate = 1.08 (from Assumptions) — vem de uma nota que você usou
  • line2 = $100.00 (absolute: attached to line 5 through inserts and moves) — uma referência de linha e a linha para a qual ela aponta
  • cost has no amount — um nome que contém texto em vez de um valor numérico

O popover é somente leitura: abri-lo nunca altera a linha e fecha assim que você digita.

Referências de linha

Uses informa o tipo de referência da linha. line2 e ↑, que aponta para a linha acima, são referências absolutas: continuam associadas à mesma linha quando você insere ou move linhas. prev e ans são relativas: leem a resposta mais próxima acima delas naquele momento, como em prev = 5 (relative: the nearest answer above, now line 4).

Used By é a outra direção: cada linha na nota que lê esta por seu número ou pelo nome que define, como Line 7: total * 2 — os primeiros seis, então quantos mais. As linhas que usam prev ou ans não estão listadas, pois seguem qualquer resposta que esteja acima delas.

Símbolos de moeda compartilhada

$, ¥ e kr pertencem a mais de uma moeda, então Assumptions dizem qual uma linha lê e como escrever outra:

  • $ is read as USD; write CA$, A$ or a code such as CAD for another dollar — não mostrado quando o local de cálculo da nota está nos Estados Unidos, como no formato numérico em English (United States)
  • ¥ is read as JPY; write CNY for Chinese yuan
  • kr is read as DKK, as this note's Calculation Settings read it; write SEK or NOK for another krone

kr é aquele que depende da nota: é a coroa da linguagem de cálculo da nota — SEK para sueco, NOK para norueguês e DKK de outra forma. Calculation Settings for This Note… — no menu Calculation Line quando você clica com o botão direito do mouse em um cálculo, e em Calculations no menu … da nota — mostra todos os três abaixo do formato de valor numérico, como em Money: $ is USD, ¥ is JPY, kr is SEK.

Taxas de câmbio

Uma linha que converte moedas lista cada conversão em Exchange Rates, com a taxa, sua origem e o tempo desde a atualização:

  • EUR → USD at 1.1367 · ECB reference 24 Sep · fetched 7 min ago — as taxas mais recentes baixadas. Taxas com mais de uma hora recebem a indicação (cached).
  • EUR → USD at 1.1367 · ECB reference 24 Sep · pinned 25 Sep 2026 — uma nota com taxas fixadas, que usa essas taxas em vez das atuais.

Uma moeda que o BCE não publica, como uma criptomoeda, nomeia uma Coinbase quote.

Uma linha que mostra um erro

Um resultado de erro também ajuda a encontrar a solução. Clique nele para ver o que deu errado, o trecho que causou o problema e a opção See Examples. Ela abre a paleta de exemplos na categoria correspondente, sem alterar a linha.

calc
5 km + 3 kg resulta em Error: incompatible units: can't add km and kg

As mensagens nomeiam os dois lados onde ajudam, para que você possa ver de uma vez quais duas coisas não se encaixam. Algumas linhas relatam uma suposição em vez de uma resposta e dizem o que escrever em vez disso:

calc
Feb 30 resulta em Unsupported: February has no day 30; its last day is the 28th, or the 29th in a leap year

Um nome que você não definiu é nomeado, com o mais próximo que você tem:

calc
rent = $800 resulta em $800.00
bills = $90 resulta em $90.00
rent + bill resulta em Unsupported: unrecognized calculation at "bill"; did you mean "bills"?

O nome está marcado na linha, a explicação diz que não está definido e See Examples abre os exemplos para reutilizar respostas, que mostram como nomear um valor. Um nome com dígitos ou sublinhados, como rent2 funciona da mesma maneira: nunca é reservado como texto ou lido como um valor numérico.

Enquanto você ainda está digitando um nome, seu erro aguarda. No caminho para price, 5 + pri não é um nome que Varlig conhece, então a linha não mostra resposta e nenhum erro até que você pause por cerca de um segundo e meio, ou mova o cursor para fora do nome ou da linha. Outras linhas e outros erros aparecem como de costume.

Cada mensagem está listada em Erros, diagnósticos e limites.

Encontrar um exemplo que funciona

Format › Calculation Examples… abre uma paleta pesquisável com exemplos resolvidos, organizados por objetivo: porcentagens, margem e markup, divisão de contas, conversão de unidades, datas e durações, subtotais e totais, listas de compras, reutilização de respostas e câmbio com taxa definida. Depois dessas categorias vem o catálogo completo de funções.

Cada linha mostra uma resposta calculada com os ajustes da própria nota, para você conferir o resultado antes de inserir o exemplo. Insert insere as linhas no bloco, na posição do cursor, ou cria um novo bloco se o cursor estiver fora de um. Toda a inserção pode ser desfeita em uma única etapa.

Leitura de respostas com o VoiceOver

Cada resposta é um controle acessível pelo VoiceOver, anunciado como Line 4, €480, result €480.00 ou Line 5, 1 / 0, error: divide by zero, com as ações personalizadas Explain Calculation e Copy Result. O rotor Calculation Results lista todas as respostas da nota, inclusive as que estão fora da área visível.